Schritt 2: Konfigurieren Ihres SAP-Systems

Konfigurieren Sie Ihr SAP-System für Test Manager, indem Sie einen Kommunikationsbenutzer erstellen, die UiPath-Dienste aktivieren und optional OAuth 2.0 einrichten.

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

Erstellen Sie einen Kommunikationsbenutzer in Ihrem SAP-System und aktivieren Sie die erforderlichen UiPath-Dienste, damit der Test Manager Heatmap- und Change-Impact-Analyse-Daten über die Webservice-Basisauthentifizierung oder eine RFC-Verbindung abrufen kann.

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/TransportsStatusSet
  • /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

Fü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.
3. 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

4. Wählen Sie Ausführen , um die Ausführung der Transaktion SICF abzuschließen. 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

5. 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 darauf hinweist, dass sie installiert, aber nicht aktiv sind. Nach der Aktivierung werden sie fett angezeigt.
6. Öffnen Sie für jeden UiPath-Diensteintrag unter uipath das Kontextmenü und wählen Sie „Dienst aktivieren“ aus.

Abbildung 3. Aktivieren von UiPath-Diensten

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

Details zu SAP-Diensten

Die folgende Tabelle beschreibt die Heatmap-Dienste und ihren Zweck.

Dienst	Beschreibung
/sap/opu/odata/UIPATH/HEATMAP_AGGREGATES_SRV/AllAggregatesSet	Ruft alle aggregierten Datensätze ab (Daten in weniger, zusammengefassten Einträgen gebündelt).Dieser Dienst wird zuerst aufgerufen, um die Start- und Enddaten der verfügbaren Datenzeiträume zu bestimmen, die dann an FinalHeatmapSet übergeben werden.
/sap/opu/odata/UIPATH/TRANSPORT_INFO_SRV/TransportsStatusSet	Ruft alle Transporte innerhalb eines angegebenen Datumsbereichs zusammen mit ihren Details ab.
/sap/opu/odata/UIPATH/TRANSPORT_LOOKBACK_SRV/TransportLookbackSet	Gibt die Anzahl der Transporte pro Monat für den Zeitraum zwischen zwei angegebenen Daten zurück.
/sap/opu/odata/UIPATH/S4_CHECK_SRV/S4Info	Überprüft, ob es sich bei dem verbundenen SAP-System um SAP S/4HANA handelt.
/sap/opu/odata/UIPATH/HEATMAP_OVERVIEW_SRV/FinalHeatmapSet	Ruft die tatsächlichen Transaktionsanzahlen für die Datumszeiträume ab, die von AllAggregatesSet zurückgegeben werden, um die Heatmap zu füllen.

Die folgende Tabelle beschreibt die Dienste zur Analyse der Auswirkungen von Änderungen und ihren Zweck. Diese Dienste unterstützen die Analyse und Suche nach SAP-Transporten, die von Änderungen betroffen sind.

Dienst	Beschreibung
/sap/opu/odata/UIPATH/GET_TRANSPORT_EXES_SRV/TransportExesSet	Ruft Analysedaten aus den benutzerdefinierten Tabellen von UiPath ab. Dieser Dienst ist Teil der Backend-Logik zur Analyse der Auswirkungen von Änderungen.
/sap/opu/odata/UIPATH/TRANSPORT_STATUS_SRV/TransportsStatusSet	Gibt den Analysestatus (analysiert oder noch nicht analysiert) von Transporten innerhalb eines angegebenen Datumsbereichs zurück.
/sap/opu/odata/UIPATH/EXE_ANALYSIS_SRV/GetTransportAnalysis	Analysiert Transporte innerhalb eines angegebenen Datumsbereichs und speichert die Ergebnisse in den benutzerdefinierten Tabellen von UiPath.
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/TransportAnalysisSet	Gibt die vollständige Analyse für einen angegebenen Transport zurück, einschließlich der Liste der betroffenen Benutzer. Wenn der Transport noch nicht analysiert wurde, wird er zuerst analysiert und die Ergebnisse werden gespeichert.
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/DetailsSet	Gibt die vollständige Analyse für einen angegebenen Transport zurück. Wenn der Transport noch nicht analysiert wurde, wird er zuerst analysiert und die Ergebnisse werden gespeichert.

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 der Endpunkte und Anmeldeinformationen sicher auf.. Sie müssen in Schritt 5 den Autorisierungsendpunkt und den Token-Endpunkt angeben.
2. Stellen Sie sicher, dass die Prüfung des Autorisierungsendpunkts ausgeführt wird. wird. Gehen Sie zu Transaktion SICF und führen Sie sie aus. Navigieren Sie zu :/sap/bc/sec/oauth2. Prüfen Sie, ob der folgende Knoten aktiv ist: authorize(Autorisierungsendpunkt). Wenn der Knoten inaktiv ist, öffnen Sie das Kontextmenü des Knotens und wählen Sie Dienst aktivieren aus.

Abbildung 4. Prüfung des Autorisierungsendpunkts

3. Stellen Sie sicher, dass die Token-Endpunkt-Prüfung ausgeführt wird. Gehen Sie zu Transaktion SICF. Navigieren Sie zu :/sap/bc/sec/oauth2. Prüfen Sie, ob der folgende Knoten aktiv ist:token (Token-Endpunkt). Wenn der Knoten inaktiv ist, öffnen Sie das Kontextmenü des Knotens und wählen Sie Dienst aktivieren aus.

4. Beachten Sie die Namenskonvention für den Autorisierungsendpunkt. Hier ist ein Beispiel für einen Autorisierungsendpunkt: https://vhclashci.dummy.nodomain:44301/sap/bc/sec/oauth2/authorization?sap-client=100

   • Teil 1 ist der Domain-Name – https://vhclashci.dummy.nodomain – Transaktion RZ11 ausführen und nach dem Eintrag „icm/host_name_full“ suchen – dieser Wert entspricht dem Domain-Namen für Ihren Eintrag im Endpunkt.
   • Teil 2 ist die Portnummer – 44301 – Transaktion SMICM ausführen und den Menüpfad „Goto->Services“ wählen, das HTTPS-Protokoll suchen und die mit HTTPS verknüpfte Nummer verwenden.
   • Teil 3 ist die statistische Zeichenfolge – /sap/bc/sec/oauth2/authorization – Verwenden Sie den festen Wert „/sap/bc/sec/oauth2/authorization“.
   • Teil 4 ist der SAP-Client – 100 – Geben Sie den SAP-Client ein, den Sie derzeit verwenden.

Schritte

1. Überprüfen Sie Ihre Transportimportdetails und die Verfügbarkeit.

   1. Prüfen Sie, ob OAuth-Profile verfügbar sind. Verwenden Sie die Transaktion SE80, um sicherzustellen, dass OAuth 2.0-Clientprofile verfügbar sind.

   2. Wählen Sie im Dropdownmenü die Option Paket aus.

   3. Geben Sie „/UIPATH/HEATMAP“ in das Textfeld ein.OAuth 2.0-Clientprofile sollten im Dropdownmenü angezeigt werden. Wenn keine Profile verfügbar sind, wenden Sie sich an den UiPath-Support.

Abbildung 5. Transportimport überprüfen

2. Konfigurieren Sie Client-ID/Benutzer-Id/Systembenutzer und Client-Secret.

   1. Wenden Sie sich für die Transaktion SUO1 an Ihr Sicherheitsteam zur Erstellung von Benutzern.

   2. Erstellen Sie einen Systembenutzer mit Zugriff auf /UIPATH/ -Dienste gemäß den Benennungsstandards Ihres Unternehmens.

   3. Generieren Sie ein Kennwort gemäß den Namensstandards Ihres Unternehmens. Das Kennwort wird später in der OAuth2-Konfiguration zu Ihrem „Geheimnis“.

3. Konfigurieren Sie SSL/TLS-Vertrauen. Wenden Sie sich für Transaktion STRUST an Ihr Basis-Team, um das Zertifikat zu verifizieren.

4. Erstellen der OAuth 2.0-Konfiguration.

   1. Für die Transaktion OA2C_CONFIG wählen Sie Erstellen und im Popup-Fenster das transportierte Profil aus, das Sie verwenden möchten. (Sie werden letztlich jedes aufgeführte Profil verwenden.)

   2. Geben Sie den Profilnamen ein.

   3. Geben Sie den Benutzernamen für den Clientnamen ein.

   4. Wählen Sie OK aus.

   5. Konfigurieren Sie die Felder und speichern Sie Ihre Konfiguration:

      • Client-Secret: Wählen Sie für jeden Client den entsprechenden Scope (Server) aus.
      • Autorisierungsendpunkt-URL (siehe Abschnitt „Voraussetzungen “ dieses Themas).
      • Token-Endpunkt-URL (siehe Abschnitt „Voraussetzungen “ dieses Themas).
      • Client-Authentifizierung: Wählen Sie das Optionsfeld Standard aus.
      • Ausgewählter Gewährungstyp: Wählen Sie das Optionsfeld Client-Anmeldeinformationen aus.
      • Gültigkeit des Aktualisierungstokens: Geben Sie -1 in das Textfeld ein.
      • 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. Konfigurieren Sie Transaktions-SOAUTH2 OAuth2-Clients.

   1. Für die Transaktion SOAUTH2 wählen Sie Erstellen und geben Sie auf dem ersten Bildschirm die folgenden Informationen ein:

      • Client-Typ: Vertraulich
      • Client-ID: Geben Sie denselben Benutzernamen wie oben ein (Schritt 3)
      • Beschreibung: Geben Sie den Dienstnamen oder Profilnamen ein.
      • Token-Lebensdauer: 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 wählen Sie in der Dropdownliste am Ende dieser Zeile eine Option aus.
      • 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_ANALYSIS_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/TRANS_CIA_LOOKBACK_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. Testen Sie die Verbindung.
   1. Führen Sie die Transaktion SE38 aus und geben Sie den Programmnamen „/UIPATH/TEST_OAUTH2_SERVICE“ ein.
   2. Wählen Sie 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. Wählen Sie Ausführen. Die Ergebnisse werden auf dem nächsten Bildschirm angezeigt. Achten Sie darauf, dass der Service-Status „200“ ist. Jeder andere Rückgabecode weist auf einen Fehler hin.

Abbildung 9. Verbindung testen

Ergebnis

Das SAP-System ist mit dem erforderlichen Kommunikationsbenutzer, den aktivierten Diensten und den OAuth-2.0-Einstellungen konfiguriert. Das System ist bereit, eine Verbindung mit dem Test Manager für die Heatmap und die Change-Impact-Analyse herzustellen.