Étape 2 : configuration de votre système SAP

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

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/HEAMAP_AGGREGexécute_SRC/All lorsque l'ensemble d'agrégats
     • /sap/opu/odata/UIPATH/TRANSPORT_INFO_SRC/transportsStatusSet
     • /sap/opu/odata/UIPATH/TRANSPORT_LOOKBack_SRC/transportLookbackSet
     • /sap/opu/odata/UIPATH/S4_CHECK_SRC/S4Info
     • /sap/opu/odata/UIPATH/HEAMAP_OverView_SRC/FinalHeatmapSet
   • Services d’analyse de l’impact des modifications:
     • /sap/opu/odata/UIPATH/GET_TRANSPORT_EXES_SRC/transportExesSet
     • /sap/opu/odata/UIPATH/GET_TRANSPORT_DETAILS_SRC/DétailsSet
     • /sap/opu/odata/UIPATH/GET_TRANSPORT_DETAILS_SRD/transportAnalysisSet
     • /sap/opu/odata/UIPATH/EXE_ANALYSIS_SRC/GetTransportAnalysis
     • /sap/opu/odata/UIPATH/GET_TRANETSPORT_ALLIITES_RSV/TransportAnalysisSet
     • /sap/opu/odata/UIPATH/GET_TRANSPORTS_ALLITEMS_SRSV/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 .
      Dans la section Filtre d'appel d'ICF Hierarchy (Filter for Calling IF Hierarchy) , assurez-vous que SERVICE est entré dans le champ Type de hiérarchie (Hierarchy Type) .
      Figure 1. Le filtre pour l'appel de l'écran Hiérarchie IDF dans SAP
      

      

      
      
   3. Sélectionnez Exécuter (Execute) pour terminer l'exécution de la transaction SCIF .

      Un écran de sélection apparaît, affichant divers services disponibles dans votre système SAP.

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

      

      
      
   4. Sous Hôtes/Services virtuels (Virtual Hosts/Services), 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 non actifs. Lors de l'activation, ils s'afficheront en gras.

   5. Cliquez avec le bouton droit sur chaque entrée de service UiPath sous uipath et sélectionnez Activer le service (Activate Service).
      Figure 3. Activation des services UiPath.
      

      

      
      
   6. Dans la fenêtre contextuelle Activation des services ICP (Activation of ICF services) , sélectionnez Oui (Yes) pour confirmer l'activation du service.

      Une fois qu'un service est activé, il s'affiche en gras.

Pour l'authentification OAuth du service Web

Justification

Le transport fourni comprend tous les objets transportables (profils OAuth, personnalisation des entrées) requis pour les services UiPath. Cependant, SAP ne permet pas le transport de la configuration complète OAuth pour des raisons de sécurité et spécifiques au système. C’est pourquoi, après avoir importé le transport fourni, vous devez effectuer la configuration OAuth manuellement dans votre environnement.

Context

La configuration complète d’OAuth 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 sécurité.
• Les URL du serveur d'autorisation diffèrent par environnement : chaque paysage (dev, QA, PROD) utilise des points de terminaison uniques.
• Les certificats et les entrées STUST 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 techniques et les autorisations varient selon les systèmes. 

• Protection des données sensibles : les informations d’identification et les jetons OAuth ne peuvent pas être transférés pour empêcher l’exposition.

Prérequis

Chaque environnement (dev, QA, PROD) nécessite une configuration manuelle distincte. Assurez-vous d’effectuer les prérequis suivants.

1. Assurez-vous que la documentation des points de terminaison et des informations d’identification est sécurisée. Vous devrez fournir le Point de terminaison d'autorisation et le Point de terminaison du jeton à l'étape 4.5.
2. Assurez-vous que la vérification du point de terminaison d'autorisation est en cours d'exécution.
   1. Accédez à Transaction SICF et exécutez-le.
   2. Accédez à //sap/bc/sec/oauth2. Vérifiez que le nœud suivant est actif : authorize (point de terminaison d'autorisation). Si le nœud est inactif, cliquez dessus avec le bouton droit de la souris et sélectionnez Activer le service dans le menu contextuel.
   Figure 4. Vérification du point de terminaison d'autorisation
   

   

   
   
3. Assurez-vous que la vérification du Point de terminaison du jeton est en cours d'exécution.
   1. Accédez à Transaction SICF .
   2. Accédez à //sap/bc/sec/oauth2. Vérifiez que le nœud suivant est actif : token (Token Endpoint). Si le nœud est inactif, cliquez dessus avec le bouton droit de la souris et sélectionnez Activer le service dans le menu contextuel.
4. Respectez la convention d'affectation de noms du Point de terminaison d'autorisation.

   Voici un exemple de point de terminaison d’autorisation : https://vhcrashci.dumpl.nodomain:44301/sap/bc/sec/oauth2/authorization?sap-client=100

   • La partie 1 est le nom de domaine - https://vhclashci.dummy.nodomain
   • La partie 2 est le numéro de port - 44301
   • La partie 3 est la chaîne statique : /sap/bc/sec/oauth2/authorization
   • La partie 4 est le client SAP - 100

   Pour créer la chaîne d'autorisation, procédez comme suit :

   1. Partie 1 : Exécutez transaction RZ11 et recherchez l'entrée 'icm/host_name_full' – c'est le nom de domaine de votre entrée dans le point de terminaison.
   2. Partie 2 : Exécutez transaction SMICM et sélectionnez le chemin de menu « Goto->Services », recherchez le protocole HTTPS et utilisez le nombre associé à HTTPS.
   3. Partie 3 : Codez en dur la valeur '/sap/bc/sec/oauth2/authorization'.
   4. Partie 4 : Entrez le client SAP que vous utilisez actuellement.
   5. Assurez-vous d'utiliser les points-virgules et d'autres caractères de ponctuations, comme requis.
5. Respectez la convention d'affectation de noms du Point de terminaison du jeton.

6. Voici un exemple de point de terminaison d’autorisation : https://vhcrashci.dumpl.nodomain:44301/sap/bc/sec/oauth2/token?sap-client=100

   • La partie 1 est le nom de domaine - https://vhclashci.dummy.nodomain
   • La partie 2 est le numéro de port - 44301
   • La partie 3 est la chaîne statique : /sap/bc/sec/oauth2/token
   • La partie 4 est le client SAP - 100

   Pour créer la chaîne d'autorisation, procédez comme suit :

   1. Partie 1 : Exécutez transaction RZ11 et recherchez l'entrée 'icm/host_name_full' – c'est le nom de domaine de votre entrée dans le point de terminaison.
   2. Partie 2 : Exécutez transaction SMICM et sélectionnez le chemin de menu « Goto->Services », recherchez le protocole HTTPS et utilisez le nombre associé à HTTPS.
   3. Partie 3 : Coder en dur la valeur '/sap/bc/sec/oauth2/token'.
   4. Partie 4 : Entrez le client SAP que vous utilisez actuellement.
   5. Assurez-vous d'utiliser les points-virgules et d'autres caractères de ponctuations, comme requis.

Étapes

1. Vérifiez les détails d’importation de votre transport et sa disponibilité.
   1. Vérifiez que les profils OAuth sont disponibles. Utilisez transaction SE80 pour vous assurer que les profils client OAuth 2.0 sont disponibles.
   2. Dans le menu déroulant, sélectionnez Package.
   3. Saisissez « /UIPATH/HEAMAP » dans la zone de texte et appuyez sur Entrée. Les profils de client OAuth 2.0 doivent apparaître dans le menu déroulant. Si les profils ne sont pas disponibles, contactez le support UiPath.
   Figure 5. Vérifier l’importation du transport
   

   

   
   
2. Configurez l'ID client/l'ID utilisateur/l'utilisateur système et la clé secrète du client.
   1. Pour transaction SUO1, contactez votre équipe de sécurité pour créer l'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 de nommage de votre entreprise ; il deviendra votre « secret » dans la configuration OAuth2 plus tard.
3. Configurez l'approbation SSL/TLS. Pour transaction STRUST, contactez votre équipe de base pour la vérification du certificat.
4. Créez la configuration OAuth 2.0.
   1. Pour transaction OA2C_CONFIG, sélectionnez Créer , puis, dans la fenêtre contextuelle, sélectionnez le profil transféré que vous souhaitez utiliser. (Vous finirez par utiliser tous les profils répertoriés.)
   2. Saisissez le nom du profil.
   3. Saisissez le Nom d'utilisateur pour le Nom du client.
   4. Appuyez sur OK.
   5. Configurez les champs et enregistrez votre configuration :
      1. Clé secrète du client: sélectionnez l'étendue correspondante (serveur) pour chaque client et appuyez sur Entrée.
      2. URL du point de terminaison d'autorisation (consultez la section Prérequis de cette rubrique).
      3. URL du point de terminaison du jeton .
      4. Authentification client: sélectionnez le bouton radio Basique .
      5. Type d'accord sélectionné: sélectionnez le bouton radio Identifiants du client .
      6. Validité du jeton d'actualisation: saisissez -1 dans la zone de texte.
      7. tolérance à l'inclinaison de l'horloge: entrez 5 dans la boîte de texte.
   6. Vérifiez l’écran Résumé , qui devrait ressembler aux captures d’écran ci-dessous.
   Figure 6. Page 1 de résumé OAuth
   

   

   
   
   Image 7. Résumé d’OAuth, page 2
   

   

   
   
5. Configurez la transaction SOAUTH2 OAuth2 Clients.
   1. Pour 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 4.3 - 4.c)
      • Description : saisissez le nom du service ou le nom du profil.
      • Durée de vie du jeton : 3 600 secondes
   2. Sélectionnez Suivant , puis saisissez les informations suivantes sur le deuxième écran :
      • ID et mot de passe de l’utilisateur client - Cochés
      • Certificat SSL - Coché
      • Vérifier le paramètre: « ID client » – Coché
   3. Sélectionnez Suivant , puis saisissez les informations suivantes dans le troisième écran :
      • Type d’accorder les informations d’identification du client actives - Coché
   4. Sélectionnez Suivant , puis, dans le quatrième écran, saisissez les informations suivantes :
      • Sous ID d'étendue OAuth2, trouvez la première ligne vide et cliquez sur 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/ANALYZEDYES_OR_NO_SRV_0001
        • /UIPATH/EXE_ANALYSIS_SRV_0001
        • /UIPATH/GET_TRANSTRANSPORT_ALLIITES_SRSV_0001
        • /UIPATH/GET_TRANSPORT_ DETAILS_SRSV_0001
        • /UIPATH/GET_TRANSPORT_EXES_SRSV_0001
        • /UIPATH/HEAMAP_Gdessous Pour_0001
        • /UIPATH/HEAMAP_OverView_SRC_0001
        • /UIPATH/TRANSPORT_INFO_SRSV_0001
        • /UIPATH/TRANSPORT_LOOKBack_SRC_0001
        • /UIPATH/TRANSPORT_STATUS_SRV_0001
        • /UIPATH/ZS4_CHECK_SRC_0001
   5. Sélectionnez Résumé. L’écran doit ressembler à l’exemple ci-dessous.
   Figure 8. Page de résumé du client OAuth2
   

   

   
   
6. Testez la connexion pour les systèmes non compatibles REST.
   1. Exécutez transaction SE38 et saisissez le nom du programme « /UIPATH/TEST_OAUTH2_Service » pour les systèmes S4 non compatibles REST.
   2. Appuyez sur Exécuter. Un écran de sélection/paramètre 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 être défini 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 être par défaut défini dans une variable.
      • ID client : saisissez l'ID utilisateur pour les services UiPath.
   4. Appuyez sur Exécuter. Les résultats apparaissent sur l’écran suivant. Recherchez que le statut du service est égal à « 200 ». Tout autre code de retour indique une erreur.
   Image 9. Tester la connexion conforme à REST
   

   

   
   
7. Testez la connexion pour les systèmes conformes à la norme RSI.
   1. Exécutez transaction SE38 et saisissez le nom du programme « /UIPATH/TEST_OAUTH2_SRV_RESE » pour les systèmes S4 compatibles avec le RSI.
   2. Appuyez sur Exécuter. Un écran de sélection/paramètre 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 être défini 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 être par défaut défini dans une variable.
      • ID client : saisissez l'ID utilisateur pour les services UiPath.
   4. Appuyez sur Exécuter. Les résultats apparaissent sur l’écran suivant. Recherchez que le statut du service est égal à « 200 ». Tout autre code de retour indique une erreur.