Schritt 2: Konfigurieren Ihres SAP-Systems

Um eine Kommunikation zwischen dem UiPath Test Manager und Ihrem SAP-System herzustellen, konfigurieren Sie das SAP-System, indem Sie einen Kommunikationsbenutzer erstellen und die erforderlichen Dienste aktivieren.

Für Webdienst-Standardauthentifizierung und RFC

1. Erstellen Sie einen Kommunikationsbenutzer in Ihrem SAP-System für die Integration mit dem UiPath Test Manager. Weisen Sie die erforderlichen Rollen und Berechtigungen basierend auf den internen Richtlinien Ihrer Organisation zu.
   • Die Integration verwendet Standardschnittstellen über RFC oder Web Service (HTTPS).
   • UiPath erfordert keine spezifischen Autorisierungen, außer bei RFC-Verbindungen.
   Hinweis:

   Wenn Sie eine RFC-Verbindung verwenden, weisen Sie dem Kommunikationsbenutzer das S_RFCACL -Autorisierungsobjekt zu.

2. Wenn Sie eine Webservice-Verbindung (HTTPS) für die Integration verwenden möchten, aktivieren Sie die erforderlichen SAP-Dienste, um die Verbindung mit UiPath herzustellen.
   Hinweis:

   Diese Dienste werden für schreibgeschützte Vorgänge verwendet. UiPath verwendet nur HTTP GET -Methoden, um Informationen aus dem SAP-System abzurufen.

In der folgenden Liste sind die erforderlichen SAP-Dienste aufgeführt, die für die Verwendung der Heatmap und der Analyse der Auswirkungen von Änderungen aktiviert werden müssen:

• Heatmap-Dienste:
  • /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
• Dienste zur Analyse der Auswirkungen von Änderungen:
  • /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/DetailsSetFühren Sie die folgenden Teilschritte aus, um die vorherigen Dienste zu aktivieren:

1. Navigieren Sie zur Benutzeroberfläche Ihres SAP-Systems.
2. Führen Sie die Transaktion SICF aus.

Stellen Sie im Abschnitt Filter für aufrufende ICF-Hierarchie sicher, dass SERVICE im Feld Hierarchietyp eingegeben ist.

Abbildung 1. Der Filter zum Aufrufen des ICF-Hierarchie-Bildschirms in SAP

3. Wählen Sie Ausführen aus, um die Ausführung der SCIF -Transaktion zu beenden. Ein Auswahlbildschirm wird angezeigt, der verschiedene in Ihrem SAP-System verfügbare Dienste anzeigt.

Abbildung 2. Der Auswahlbildschirm mit allen in SAP verfügbaren Diensten

4. Erweitern Sie unter Virtuelle Hosts/Dienste den folgenden Menüpfad: default_host > sap > opu > odata > uipath. Wenn dies Ihre erste Aktivierung ist, sind die UiPath-Dienste wahrscheinlich ausgegraut, was bedeutet, dass sie installiert, aber nicht aktiv sind. Nach der Aktivierung werden sie fett angezeigt. 5. Klicken Sie mit der rechten Maustaste auf jeden UiPath-Diensteintrag unter uipath und wählen Sie Dienst aktivieren aus.

Abbildung 3. Aktivieren von UiPath-Diensten

6. Wählen Sie im Popup-Fenster Aktivierung von ITF-Diensten die Option Ja aus, um die Aktivierung des Dienstes zu bestätigen. Sobald ein Dienst aktiviert ist, wird er fett angezeigt.

Für die OAuth-Authentifizierung des Webdiensts

Begründung

Der bereitgestellte Transport enthält alle portierbaren Objekte (OAuth-Profile, Anpassen von Einträgen), die für UiPath-Dienste erforderlich sind. SAP lässt jedoch aus Sicherheits- und systemspezifischen Gründen nicht den Transport der vollständigen OAuth-Konfiguration zu. Aus diesem Grund müssen Sie nach dem Importieren des bereitgestellten Transports die OAuth-Konfiguration manuell in Ihrer Umgebung abschließen.

Context

Die vollständige OAuth-Konfiguration kann nicht übertragen werden, um vertrauliche Daten zu schützen und die Systemintegrität aufrechtzuerhalten.

• Client-Geheimnisse sind systemspezifisch – Geheimnisse können nicht für die Sicherheitskonformität exportiert oder importiert werden.
• Autorisierungsserver-URLs unterscheiden sich je nach Umgebung – Jede Landschaft (DEV, QA, PROD) verwendet eindeutige Endpunkte.
• Zertifikate und STRUST-Einträge sind lokal – die SSL/TLS-Vertrauensstellung muss in jedem System manuell konfiguriert werden.
• Benutzerzuweisungen und Rollen sind clientabhängig – Technische Benutzer und Autorisierungen variieren je nach System.
• Schutz für vertrauliche Daten – OAuth-Anmeldeinformationen und Token können nicht übertragen werden, um eine Gefährdung zu verhindern.

Voraussetzungen

Jede Umgebung (DEV, QA, PROD) erfordert ein separates manuelles Setup. Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind.

1. Bewahren Sie die Dokumentation von Endpunkten und Anmeldeinformationen sicher auf. Sie müssen den Autorisierungsendpunkt und den Tokenendpunkt in Schritt 4.5 angeben.
2. Stellen Sie sicher, dass die Prüfung des Autorisierungsendpunkts ausgeführt wird.
   1. Gehen Sie zu Transaction SICF und führen Sie es aus.
   2. Navigieren Sie zu:/sap/bc/sec/oauth2. Überprüfen Sie, ob der folgende Knoten aktiv ist: authorize (Autorisierungsendpunkt). Wenn der Knoten inaktiv ist, klicken Sie mit der rechten Maustaste darauf und wählen Sie im Kontextmenü Dienst aktivieren aus.

Abbildung 4. Prüfung des Autorisierungsendpunkts

3. Ensure the Token Endpoint check is running.
   1. Wechseln Sie zu Transaction SICF .
   2. Navigieren Sie zu:/sap/bc/sec/oauth2. Überprüfen Sie, ob der folgende Knoten aktiv ist: token (Token-Endpunkt). Wenn der Knoten inaktiv ist, klicken Sie mit der rechten Maustaste darauf und wählen Sie im Kontextmenü Dienst aktivieren aus.
4. Beachten Sie die Namenskonvention für den Autorisierungsendpunkt. Hier ist ein Beispiel für den Autorisierungsendpunkt: https://vhclashci.dummy.nodomain:44301/sap/bc/sec/oauth2/authorization?sap-client=100
   • Teil 1 ist der Domänenname – https://vhclashci.dummy.nodomain
   • Teil 2 ist die Portnummer – 44301
   • Teil 3 ist die statische Zeichenfolge – /sap/bc/sec/oauth2/authorization
   • Teil 4 ist der SAP-Client – 100Um die Autorisierungszeichenfolge zu erstellen, gehen Sie wie folgt vor:
   1. Teil 1: Führen Sie transaction RZ11 aus und suchen Sie nach dem Eintrag „icm/host_name_full“ – dieser Wert ist der Domänenname für Ihren Eintrag im Endpunkt.
   2. Teil 2 – Führen Sie transaction SMICM aus und wählen Sie den Menüpfad „Gehen Sie zu->Dienste“ aus, suchen Sie das HTTPS-Protokoll und verwenden Sie die Zahl, die HTTPS zugeordnet ist.
   3. Teil 3 – Hartcodieren des Werts „/sap/bc/sec/oauth2/authorization“.
   4. Teil 4 – Geben Sie den SAP-Client ein, den Sie derzeit verwenden.
   5. Stellen Sie sicher, dass Sie nach Bedarf die Semikolons und andere Satzzeichen verwenden.
5. Beachten Sie die Namenskonvention für den Token-Endpunkt.
6. Hier ist ein Beispiel für den Autorisierungsendpunkt: https://vhclashci.dummy.nodomain:44301/sap/bc/sec/oauth2/token?sap-client=100
   • Teil 1 ist der Domänenname – https://vhclashci.dummy.nodomain
   • Teil 2 ist die Portnummer – 44301
   • Teil 3 ist die statische Zeichenfolge – /sap/bc/sec/oauth2/token
   • Teil 4 ist der SAP-Client – 100Um die Autorisierungszeichenfolge zu erstellen, gehen Sie wie folgt vor:
   1. Teil 1: Führen Sie transaction RZ11 aus und suchen Sie nach dem Eintrag „icm/host_name_full“ – dieser Wert ist der Domänenname für Ihren Eintrag im Endpunkt.
   2. Teil 2 – Führen Sie transaction SMICM aus und wählen Sie den Menüpfad „Gehen Sie zu->Dienste“ aus, suchen Sie das HTTPS-Protokoll und verwenden Sie die Zahl, die HTTPS zugeordnet ist.
   3. Teil 3 – Hartcodieren des Werts „/sap/bc/sec/oauth2/token“.
   4. Teil 4 – Geben Sie den SAP-Client ein, den Sie derzeit verwenden.
   5. Stellen Sie sicher, dass Sie nach Bedarf die Semikolons und andere Satzzeichen verwenden.

Schritte

1. Überprüfen Sie Ihre Transportimportdetails und die Verfügbarkeit.
   1. Überprüfen Sie, ob OAuth-Profile verfügbar sind. Verwenden Sie transaction SE80 um sicherzustellen, dass OAuth 2.0-Client-Profile verfügbar sind.
   2. Wählen Sie im Dropdownmenü die Option Paket aus.
   3. Geben Sie '/UIPATH/HatMAP' in das Textfeld ein und drücken Sie die Eingabetaste. OAuth 2.0-Client-Profile sollten im Dropdownmenü angezeigt werden. Wenn Profile nicht verfügbar sind, wenden Sie sich an den UiPath-Support.

Abbildung 5. Transportimport überprüfen

2. Configure Client ID/User Id/System User and Client Secret.
   1. Für transaction SUO1 wenden Sie sich an Ihr Sicherheitsteam für die Benutzererstellung.
   2. Erstellen Sie einen Systembenutzer mit Zugriff auf /UIPATH/ -Dienste gemäß den Benennungsstandards Ihres Unternehmens.
   3. Generieren Sie ein Kennwort gemäß den Benennungsstandards Ihres Unternehmens – dies wird später Ihr „Geheimnis“ in der OAuth2-Konfiguration.
3. Konfigurieren Sie die SSL/TLS-Vertrauensstellung. Wenden Sie sich für transaction STRUST an Ihr Basisteam für die Zertifikatüberprüfung.
4. Erstellen der OAuth 2.0-Konfiguration.
   1. Wählen Sie für transaction OA2C_CONFIG die Option Erstellen aus und wählen Sie im Popup das übertragene Profil aus, das Sie verwenden möchten. (Sie werden irgendwann jedes aufgeführte Profil verwenden.)
   2. Geben Sie den Profilnamen ein.
   3. Geben Sie den Benutzernamen für den Clientnamen ein.
   4. Klicken Sie auf OK.
   5. Konfigurieren Sie die Felder und speichern Sie Ihre Konfiguration:
      1. Clientgeheimnis: Wählen Sie den entsprechenden Scope (Server) für jeden Client aus und drücken Sie die Eingabetaste.
      2. Autorisierungsendpunkt-URL (siehe Abschnitt „Voraussetzungen “ dieses Themas).
      3. Token-Endpunkt-URL (siehe Abschnitt „Voraussetzungen “ dieses Themas).
      4. Client-Authentifizierung: Wählen Sie das Optionsfeld Standard aus.
      5. Ausgewählter Gewährungstyp: Wählen Sie das Optionsfeld Client-Anmeldeinformationen aus.
      6. Gültigkeit des Aktualisierungstokens: Geben Sie -1 in das Textfeld ein.
      7. UiPath Hub-Toleranz: Geben Sie 5 in das Textfeld ein.
   6. Überprüfen Sie den Bildschirm „Zusammenfassung“ , der wie auf den Screenshots unten aussehen sollte.

Abbildung 6. OAuth-Zusammenfassung 1

Abbildung 7. Seite „OAuth-Zusammenfassung“ 2

5. Configure transaction SOAUTH2 OAuth2 Clients.
   1. Wählen Sie für transaction SOAUTH2 die Option Erstellen aus und geben Sie auf dem ersten Bildschirm die folgenden Informationen ein:
      • **Client-Typ:**Vertraulich
      • **Client-ID:**Geben Sie denselben Benutzernamen wie oben ein (Schritt 4.3
        • 4.c)
      • **Beschreibung:**Geben Sie den Dienstnamen oder Profilnamen ein.
      • **Lebensdauer des Tokens:**3600 Sekunden
   2. Wählen Sie Weiter aus und geben Sie auf dem zweiten Bildschirm die folgenden Informationen ein:
      • Client-Benutzer-ID und Kennwort – Überprüft
      • SSL-Zertifikat – Aktiviert
      • Überprüfen Sie den Parameter: „Client-ID“ – Überprüft
   3. Wählen Sie Weiter aus und geben Sie auf dem dritten Bildschirm die folgenden Informationen ein:
      • Gewährungstyp Client-Anmeldeinformationen Aktiv – Aktiviert
   4. Wählen Sie Weiter aus und geben Sie auf dem vierten Bildschirm die folgenden Informationen ein:
      • Suchen Sie unter OAuth2 Scope ID die erste leere Zeile und klicken Sie auf die Dropdownliste am Ende der leeren Zeile.
      • Wählen Sie jeden der mit UiPath verknüpften Scopes aus, bis alle ausgewählt sind.
        • /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. Wählen Sie Zusammenfassung aus. Der Bildschirm sollte wie im folgenden Beispiel aussehen.

Abbildung 8. Seite „OAuth2 Client – Zusammenfassung“.

6. Test the connection for Non-RISE compliant systems.
   1. Führen Sie transaction SE38 aus und geben Sie den Programmnamen '/UIPATH/TEST_OAuth2_SERVICE' für Nicht-RISE-konforme S4-Systeme ein.
   2. Klicken Sie auf Ausführen. Ein Auswahl-/Parameterbildschirm wird angezeigt.
   3. Aktualisieren Sie die folgenden Parameter, damit sie mit Ihrem System/Benutzer/Kennwort übereinstimmen.
      • Port – HTTPS-Port
      • Client – Der aktuelle Client sollte standardmäßig eine Variable verwenden.
      • Geheimnis – Geben Sie das Kennwort für Client_ID/Benutzer ein.
      • Systemname – Der aktuelle Systemname sollte standardmäßig eine Variable sein.
      • Client-ID – Geben Sie die Benutzer-ID für UiPath-Dienste ein.
   4. Klicken Sie auf Ausführen. Die Ergebnisse werden auf dem nächsten Bildschirm angezeigt. Suchen Sie nach einem Servicestatus, der gleich „200“ ist. Jeder andere Rückgabecode weist auf einen Fehler hin.

Abbildung 9. Testen Sie eine nicht-Risiko-konforme Verbindung

7. Test the connection for RISE compliant systems.
   1. Führen Sie transaction SE38 aus und geben Sie den Programmnamen '/UIPATH/TEST_OAuth2_SRV_RSE' für Rise-konforme S4-Systeme ein.
   2. Klicken Sie auf Ausführen. Ein Auswahl-/Parameterbildschirm wird angezeigt.
   3. Aktualisieren Sie die folgenden Parameter, damit sie mit Ihrem System/Benutzer/Kennwort übereinstimmen.
      • Port – HTTPS-Port
      • Client – Der aktuelle Client sollte standardmäßig eine Variable verwenden.
      • Geheimnis – Geben Sie das Kennwort für Client_ID/Benutzer ein.
      • Systemname – Der aktuelle Systemname sollte standardmäßig eine Variable sein.
      • Client-ID – Geben Sie die Benutzer-ID für UiPath-Dienste ein.
   4. Klicken Sie auf Ausführen. Die Ergebnisse werden auf dem nächsten Bildschirm angezeigt. Suchen Sie nach einem Servicestatus, der gleich „200“ ist. Jeder andere Rückgabecode weist auf einen Fehler hin.