Étape 2 : configuration de votre système SAP

Configurez votre système SAP pour Test Manager en créant un utilisateur de communication, en activant les services UiPath et en configurant éventuellement OAuth 2.0.

Pour établir une communication entre UiPath Test Manager et votre système SAP, configurez le système SAP en créant un utilisateur de communication et en activant les services requis.

Pour le service Web, l’authentification de base et RFC

Créez un utilisateur de communication dans votre système SAP et activez les services UiPath requis pour permettre à Test Manager de récupérer les données de la Heatmap et de l'analyse de l'impact des modifications via une authentification de base par service Web ou une connexion RFC.

1. Créez un utilisateur de communication dans votre système SAP pour l’intégration avec UiPath Test Manager. Attribuez les rôles et les autorisations nécessaires en fonction des politiques internes de votre organisation.
   • L'intégration utilise des interfaces standard via RFC ou Web Service (HTTPS).
   • UiPath ne nécessite pas d’autorisations spécifiques, sauf pour les connexions RFC.
   Remarque :

   Si vous utilisez une connexion RFC, attribuez l’objet d’autorisation S_RFCACL à l’utilisateur de communication.

2. Si vous prévoyez d’utiliser une connexion Web Service (HTTPS) pour l’intégration, activez les services SAP nécessaires pour établir la connexion avec UiPath.
   Remarque :

   Ces services sont utilisés pour les opérations en lecture seule. UiPath utilise uniquement les méthodes HTTP GET pour récupérer les informations provenant du système SAP.

La liste suivante présente les services SAP nécessaires à activer pour utiliser la carte thermique et l’analyse de l’impact des modifications :

• Services de la carte thermique:
  • /sap/opu/odata/UIPATH/HEATMAP_AGGREGATES_SRV/AllAggregatesSet
  • /sap/opu/odata/UIPATH/TRANSPORT_INFO_SRV/TransportsStatusSet
  • /sap/opu/odata/UIPATH/TRANSPORT_LOOKBACK_SRV/TransportLookbackSet
  • /sap/opu/odata/UIPATH/S4_CHECK_SRV/S4Info
  • /sap/opu/odata/UIPATH/HEATMAP_OVERVIEW_SRV/FinalHeatmapSet
• Services d’analyse de l’impact des modifications:
  • /sap/opu/odata/UIPATH/GET_TRANSPORT_EXES_SRV/TransportExesSet
  • /sap/opu/odata/UIPATH/TRANSPORT_STATUS_SRV/TransportStatusSet
  • /sap/opu/odata/UIPATH/EXE_ANALYSIS_SRV/GetTransportAnalysis
  • /sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/TransportAnalysisSet
  • /sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/DetailsSet

Pour activer les services précédents, procédez comme suit :

1. Accédez à l'interface utilisateur de votre système SAP.
2. Exécutez la transaction SICF .
3. Dans la section Filtre d'appel de la hiérarchie IFS , assurez-vous que SERVICE est entré dans le champ Type de hiérarchie .

Figure 1. L'écran Filtre d'appel de la hiérarchie IFS dans SAP

4. Sélectionnez Exécuter pour terminer l’exécution de la transaction SICF . Un écran de sélection apparaît, affichant les différents services disponibles dans votre système SAP.

Image 2. L’écran de sélection affichant tous les services disponibles dans SAP

5. Sous Hôtes/services virtuels, développez le chemin de menu suivant : default_host > sap > opu > odata > uipath. S’il s’agit de votre première activation, les services UiPath seront probablement grisés, indiquant qu’ils sont installés mais pas actifs. Lors de l’activation, elles s’afficheront en gras.
6. Ouvrez le menu contextuel de chaque entrée de service UiPath sous uipath, et sélectionnez Activer le service.

Image 3. Activation des services UiPath

7. Dans la fenêtre contextuelle Activation des services IFS , sélectionnez Oui pour confirmer l’activation du service. Une fois qu'un service est activé, il sera affiché en gras.

Détails sur les services SAP

Le tableau suivant décrit les services de carte thermique ainsi que leur finalité.

Service	Description
/sap/opu/odata/UIPATH/HEATMAP_AGGREGATES_SRV/AllAggregatesSet	Récupère tous les enregistrements agrégés (données déployées dans moins d'entrées résumées). Ce service est d'abord appelé pour déterminer les dates de début et de fin des périodes de données disponibles, qui sont ensuite transmises à FinalHeatmapSet.
/sap/opu/odata/UIPATH/TRANSPORT_INFO_SRV/TransportsStatusSet	Récupère tous les transports au sein d’une plage de dates spécifiée, ainsi que leurs détails.
/sap/opu/odata/UIPATH/TRANSPORT_LOOKBACK_SRV/TransportLookbackSet	Renvoie le nombre de transports par mois pour la période entre deux dates spécifiées.
/sap/opu/odata/UIPATH/S4_CHECK_SRV/S4Info	Vérifie si le système SAP connecté est SAP S/4HANA.
/sap/opu/odata/UIPATH/HEATMAP_OVERVIEW_SRV/FinalHeatmapSet	Récupère le nombre de transactions réels pour les périodes de date renvoyées par AllAggregatesSet, utilisées pour remplir la carte thermique.

Le tableau suivant décrit les services d’analyse de l’impact des modifications ainsi que leur objectif. Ces services prennent en charge l’analyse et la recherche des transports SAP affectés par les modifications.

Service	Description
/sap/opu/odata/UIPATH/GET_TRANSPORT_EXES_SRV/TransportExesSet	Récupère les données d'analyse des tables personnalisées d'UiPath. Ce service fait partie de la logique backend de l’analyse de l’impact des modifications.
/sap/opu/odata/UIPATH/TRANSPORT_STATUS_SRV/TransportStatusSet	Renvoie le statut d’analyse (analysé ou pas encore analysé) des transports au sein d’une plage de dates spécifiée.
/sap/opu/odata/UIPATH/EXE_ANALYSIS_SRV/GetTransportAnalysis	Analyse les transports au sein d'une plage de dates spécifiée et stocke les résultats dans les tables personnalisées d'UiPath.
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/TransportAnalysisSet	Renvoie l’analyse complète pour un transport spécifié, y compris la liste des utilisateurs concernés. Si le transport n’a pas encore été analysé, il est d’abord analysé et les résultats sont enregistrés.
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/DetailsSet	Renvoie l’analyse complète d’un transport spécifié. Si le transport n’a pas encore été analysé, il est d’abord analysé et les résultats sont enregistrés.

Pour l'authentification OAuth du service Web

Justification

Le transport fourni inclut tous les objets transportables (Profils OAuth, entrées de personnalisation) requis pour les services UiPath. Cependant, SAP ne permet pas le transport d'une configuration OAuth complète pour des raisons de sécurité et spécifiques au système. Pour cette raison, après avoir importé le transport fourni, vous devez terminer la configuration OAuth manuellement dans votre environnement.

Context

La configuration OAuth complète ne peut pas être transportée pour protéger les données sensibles et maintenir l’intégrité du système.

• Les clés secrètes du client sont spécifiques au système : les clés secrètes ne peuvent pas être exportées ou importées pour des raisons de conformité en matière de sécurité.
• Les URL du serveur d’autorisation diffèrent par environnement : chaque paysage utilise des points de terminaison uniques.
• Les certificats et les entrées Trust sont locaux - L'approbation SSL/TLS doit être configurée manuellement dans chaque système.
• Les affectations et les rôles des utilisateurs dépendent des clients : les utilisateurs et les autorisations techniques varient selon les systèmes.
• Protection des données sensibles : les informations d’identification et les jetons OAuth ne peuvent pas être transportés pour empêcher l’exposition.

Prérequis

Chaque environnement nécessite une configuration manuelle distincte. Assurez-vous d'effectuer les prérequis suivants.

1. Gardez la documentation des points de terminaison et des identifiants en sécurité. Vous devrez fournir le point de terminaison d'autorisation et le point de terminaison de jeton à l'étape 5.
2. Assurez-vous que la vérification du point de terminaison d'autorisation est en cours d'exécution. Accédez à la transaction SICF et exécutez-la. Accédez à ::sap/bc/sec/oauth2. Vérifiez que le nœud suivant est inactif: authorize (Point de terminaison d'autorisation). Si le nœud est inactif, ouvrez le menu contextuel du nœud et sélectionnez Activer le service.

Figure 4. Vérification du point de terminaison d'autorisation

3. Assurez-vous que la vérification du point de terminaison de jeton est en cours d'exécution. Accédez à la transaction SICF. Accédez à:/sap/bc/sec/oauth2. Vérifiez que le nœud suivant est désactivé: token (TokenEndpoint). Si le nœud est inactif, ouvrez le menu contextuel du nœud et sélectionnez Activer le service.

4. Respectez la convention d’affectation de noms pour le point de terminaison d’autorisation. Voici un exemple de point de terminaison d'autorisation: https://vhclashci.dthy.nodomain:44301/sap/bc/sec/oauth2/authorization?sap-client=100

   • La partie 1 correspond au nom de domaine - https://vhclashci.dummy.nodomain - Exécutez la transaction RZ11 et recherchez l'entrée 'icm/host_name_full' - cette valeur sera le nom de domaine pour votre entrée dans le point de terminaison.
   • La partie 2 correspond au numéro de port - 44301 - exécutez la transaction SMICM et sélectionnez le chemin du menu « Goto->Services», recherchez le protocole HTTPS et utilisez le numéro associé à HTTPS.
   • La partie 3 est la string statique - /sap/bc/sec/oauth2/authorization - Codez en dur la valeur « /sap/bc/sec/oauth2/authorization ».
   • La partie 4 est le client SAP - 100 - Entrez le client SAP que vous utilisez actuellement.

Étapes

1. Vérifiez les détails et la disponibilité de votre importation de transport.

   1. Vérifiez que les profils OAuth sont disponibles. Utilisez la transaction SE80 pour vous assurer que les profils client OAuth 2.0 sont disponibles.

   2. Dans le menu déroulant, sélectionnez Package.

   3. Entrez « /UiPath/HEATMAP » dans la zone de texte. Les profils client OAuth 2.0 doivent apparaître dans le menu déroulant. Si les profils ne sont pas disponibles, contactez l'assistance UiPath.

Figure 5. Vérifier l'importation du transport

2. Configurez l'ID client/l'ID utilisateur/l'utilisateur système et le secret du client.

   1. Pour la transaction SUO1, contactez votre équipe de sécurité afin de créer un utilisateur.

   2. Créez un utilisateur système avec accès aux services /UIPATH/ en fonction des normes de nommage de votre entreprise.

   3. Générez un mot de passe en fonction des normes d'affectation de nom de votre entreprise. Ce mot de passe deviendra votre « secret» dans la configuration OAuth2 ultérieurement.

3. Configurez la confiance SSL/TLS. Pour la transaction STRUST, contactez votre équipe de base pour la vérification du certificat.

4. Créez la configuration OAuth 2.0.

   1. Pour la transaction OA2C_CONFIG, sélectionnez Créer , puis, dans la fenêtre contextuelle, sélectionnez le profil transporté que vous souhaitez utiliser. (Vous finirez par utiliser chaque profil répertorié.)

   2. Saisissez le nom du profil.

   3. Saisissez le Nom d'utilisateur pour le Nom du client.

   4. Sélectionnez OK.

   5. Configurez les champs et enregistrez votre configuration :

      • Secret du client : sélectionnez l'étendue correspondante (serveur) pour chaque client.
      • URL du point de terminaison d'autorisation (consultez la section Prérequis de cette rubrique).
      • URL du point de terminaison de jeton (consultez la section Prérequis de cette rubrique).
      • Authentification du client: sélectionnez le bouton radio De base .
      • Type d'accord sélectionné: sélectionnez le bouton radio Identifiants du client .
      • Actualiser la validité du jeton: saisissez -1 dans la zone de texte.
      • Tonalité d'inclinaison de l'horloge: saisissez 5 dans la zone de texte.

   6. Vérifiez l'écran Résumé , qui devrait ressembler aux captures d'écran ci-dessous.

Image 6. Page de résumé OAuth 1

Figure 7. Page 2 de Résumé OAuth

5. Configurez la transaction SOAUTH2 OAuth2 Clients.

   1. Pour la transaction SOAUTH2, sélectionnez Créer et, dans le premier écran, saisissez les informations suivantes:

      • Type de client: confidentiel
      • ID client: saisissez le même nom d'utilisateur que ci-dessus (étape 3)
      • Description: saisissez le nom du service ou le nom du profil.
      • Durée de vie du jeton: 3 600 secondes

   2. Sélectionnez Suivant et, dans le deuxième écran, entrez les informations suivantes:

      • ID d’utilisateur et mot de passe du client - Cochés
      • Certificat SSL - Coché
      • Paramètre de vérification: « ID client » – Coché

   3. Sélectionnez Suivant et, dans le troisième écran, entrez les informations suivantes:

      • Type d'accorder les informations d'identification du client actives - Cochées

   4. Sélectionnez Suivant , puis, au quatrième écran, entrez les informations suivantes:

      • Sous Id d'étendue OAuth2, recherchez la première ligne vide et sélectionnez dans la liste déroulante à la fin de la ligne vide.
      • Sélectionnez chacune des étendues associées à UiPath jusqu'à ce que toutes aient été sélectionnées.
        • /UIPATH/ANALYZED_YES_OR_NO_SRV_0001
        • /UIPATH/EXE_ANALYSIS_SRV_0001
        • /UIPATH/GET_TRANSPORT_ALLITEMS_SRV_0001
        • /UIPATH/GET_TRANSPORT_DETAILS_SRV_0001
        • /UIPATH/GET_TRANSPORT_EXES_SRV_0001
        • /UIPATH/HEATMAP_AGGREGATES_SRV_0001
        • /UIPATH/HEATMAP_OVERVIEW_SRV_0001
        • /UIPATH/TRANSPORT_INFO_SRV_0001
        • /UIPATH/TRANSPORT_LOOKBACK_SRV_0001
        • /UIPATH/TRANSPORT_STATUS_SRV_0001
        • /UIPATH/ZS4_CHECK_SRV_0001

   5. Sélectionnez Résumé. L'écran doit ressembler à l'exemple ci-dessous.

Figure 8. Page Récapitulatif du client OAuth2

6. Testez la connexion.
   1. Exécutez la transaction SE38 et saisissez le nom du programme « /UIPATH/Test_OAUTH2_Service ».
   2. Sélectionnez Exécuter. Un écran de sélection/paramètres apparaît.
   3. Mettez à jour les paramètres suivants pour qu’ils correspondent à votre système/utilisateur/mot de passe.
      • Port : port HTTPS
      • Client : le client actuel doit par défaut dans une variable.
      • Secret : saisissez le mot de passe pour Client_ID/User.
      • Nom du système : le nom du système actuel doit par défaut dans une variable.
      • ID client : saisissez l'ID utilisateur pour les services UiPath.
   4. Sélectionnez Exécuter. Les résultats apparaissent sur l'écran suivant. Vérifiez que le statut du service est égal à « 200 ». Tout autre code de retour indique une erreur.

Figure 9. Tester la connexion

Résultat

Le système SAP est configuré avec l'utilisateur de communication requis, les services activés et les paramètres OAuth 2.0. Le système est prêt à établir une connexion avec Test Manager pour la Heatmap et l'analyse de l'impact des modifications.