ServiceNow-Authentifizierung

UiPath unterstützt die folgenden Authentifizierungstypen für ServiceNow:

Authentifizierungstyp	Beschreibung	Am besten geeignet für
Standard (Benutzername/Kennwort)	Direkte Anmeldung mit einem ServiceNow-Benutzer über HTTPS-Standardauthentifizierung.	Einfache Nicht-OAuth-Setups, perfekt für schnelle POCs
OAuth 2.0-Autorisierungscode	Der Benutzer meldet sich bei ServiceNow an und gewährt Zugriff auf einen in ServiceNow konfigurierten OAuth-Client.	Von Benutzern delegierte Szenarien in der Produktion, die eine starke Governance und einen einfachen Widerruf erfordern.
OAuth 2.0 Password Gewährung	Benutzername/Kennwort des Dienstkontos sowie OAuth-Client-Anmeldeinformationen, die gegen Token ausgetauscht wurden.	Dienst-zu-Dienst-Integrationen, bei denen OAuth erforderlich ist, die interaktive Anmeldung jedoch nicht praxisorientiert ist.

Standard (Benutzername/Kennwort)

Verbindungsfelder

Feld	Beschreibung
Site-URL	Vollständige ServiceNow-Instanz-URL, zum Beispiel https://your-instance.service-now.com​
Benutzername	Benutzername für die ServiceNow-Integration​
Passwort	Kennwort für den Integrationsbenutzer.​

Häufige Probleme

4XX Fehler

• Überprüfen Sie die Instanz-URL, den Benutzernamen und das Kennwort; Stellen Sie sicher, dass das Konto aktiv ist und nicht durch IP-/Anmelderichtlinien gesperrt oder blockiert wird​
• Stellen Sie sicher, dass der Benutzer sys_db_object und sys_dictionary lesen kann und über die erforderlichen ACLs für Zieltabellen verfügt (Lesen/Einfügen/Aktualisieren/Löschen.
• Stellen Sie sicher, dass sich Ihre ServiceNow-Instanz nicht im Ruhezustand befindet.

OAuth 2.0: Autorisierungscode

Diese Methode gewährt UiPath-Zugriff, indem ein Zugriffstoken ausgegeben wird, anstatt dass Ihr Benutzername und Ihr Kennwort als Verbindungsfelder erforderlich sind.

Hinweis:

• Der Ablauf der Gewährung des OAuth 2.0-Autorisierungscodes wird nur in ServiceNow Iststan und späteren Versionen unterstützt.
• Callback URL for your app should be https://{baseURL}/provisioning_/callback (for example, https://cloud.uipath.com/provisioning_/callback for Automation Cloud). See Set up OAuth for more details.
• For Washington, Yokohama, and earlier versions, use the Create OAuth API endpoint for external clients option in the Application Registry. Existing OAuth 2.0 apps configured this way continue to work.
• For Zurich and Australia, ServiceNow has deprecated the Create OAuth API endpoint for external clients option in favour of the new simplified Inbound Integration configuration in the Machine Identity Console. See Set up OAuth for Zurich and Australia (Inbound Integration) for guidance.

Verbindungsfelder

Feld	Beschreibung
Site-URL	Vollständige ServiceNow-Instanz-URL (z. B. https://your-instance.service-now.com).​
Client-ID	Client-ID aus dem OAuth-Client der ServiceNow -Anwendungsregistrierung , der von UiPath verwendet wird​
Geheimer Clientschlüssel	Geheimer Clientschlüssel vom selben OAuth-Client​

Häufige Probleme

• Nicht übereinstimmende Umleitungs-URL oder ungültiger Umleitungsfehler

  Bestätigen Sie, dass die im ServiceNow OAuth-Client konfigurierte Umleitungs-URL genau mit der in UiPath angezeigten Rückruf-URL übereinstimmt (Schema, Host, Pfad und nachgestellter Schrägstrich).​

• Bereits in ServiceNow authentifiziert: Seite „Akzeptieren/Verweigern“ wird anstelle des Anmeldebildschirms angezeigt

  Dieses Verhalten wird erwartet, wenn Ihr Browser bereits über eine aktive ServiceNow-Sitzung verfügt. In diesem Fall überspringt ServiceNow den Anmeldebildschirm und zeigt direkt die Seite OAuth-Zustimmung (Akzeptieren/Verweigern) an.

  • Wenn es sich um das richtige Konto handelt, klicken Sie auf Akzeptieren , um die Verbindung abzuschließen.
  • Wenn Sie ein anderes Konto verwenden müssen, melden Sie sich in einer anderen Registerkarte im Browser bei ServiceNow ab oder versuchen Sie es in einem Inkognito-/privaten Fenster erneut und melden Sie sich dann mit dem vorgesehenen Benutzer an.

  Wenn SSO aktiviert ist

  In einigen SSO-Setups werden weder der Anmeldebildschirm noch die Seite Zustimmung akzeptieren/verweigern angezeigt. ServiceNow nimmt den aktuell authentifizierten Benutzer an und fährt mit der Verbindungserstellung fort, die dann aufgrund fehlender Berechtigungen fehlschlagen kann.

  Verwenden Sie in diesem Szenario ein Inkognito-/privates Fenster, um sicherzustellen, dass Sie sich mit dem richtigen Benutzer und den erforderlichen Berechtigungen authentifizieren können.

• Anmeldung und Zustimmung sind erfolgreich, aber das Erstellen der Verbindung ist fehlgeschlagen

  Dem autorisierenden Benutzer fehlen ACLs für eine oder mehrere Tabellen, die vom Connector verwendet werden. Gewähren Sie Lesezugriff auf Metadaten (sys_db_object, sys_dictionary) und lesen Sie/Schreiben Sie ACLs auf die relevanten Geschäftstabellen, und testen Sie dann erneut​

• Die Verbindung funktionierte zuvor, schlägt aber jetzt mit Authentifizierungs- oder Tokenfehlern fehl

  Zugriffs- oder Aktualisierungstoken sind möglicherweise abgelaufen oder wurden widerrufen (z. B. nach Kennwort- oder OAuth-Clientänderungen). Öffnen Sie die Verbindung in UiPath erneut und autorisieren Sie sie erneut. Wenn weiterhin Probleme auftreten, überprüfen Sie, ob der ServiceNow-OAuth-Client geändert oder entfernt wurde.

OAuth 2.0-Kennwort

Verbindungsfelder

Feld	Beschreibung
Site-URL	Vollständige ServiceNow-Instanz-URL.
Benutzername	Benutzername des ServiceNow-Dienstkontos.
Passwort	Kennwort für dieses Dienstkonto.
Client-ID	Client-ID vom ServiceNow OAuth-Client​
Geheimer Clientschlüssel	Geheimer Clientschlüssel vom selben OAuth-Client​

Richten Sie OAuth ein

Hinweis:

The following procedure applies to Washington, Yokohama, and earlier versions of ServiceNow. If you are on Zurich or Australia, see Set up OAuth for Zurich and Australia (Inbound Integration).

Schließen Sie die Schritte zum Einrichten von OAuth in der ServiceNow-Dokumentation ab.

Obwohl die dokumentierten Schritte wahrscheinlich in allen ServiceNow-Plattformregionen gleich sind, wird empfohlen, dass Sie die Schritte für Ihre spezifische Region ausführen, falls es Unterschiede gibt.

Im folgenden Verfahren wird erläutert, wie wir OAuth für unsere Beispiele einrichten.

1. Melden Sie sich bei Ihrer ServiceNow-Instanz an (z. B. https://<span>dev74293.service-now.com/login</span>).

2. Gehen Sie zu Systemdefinitionen > Plugins und stellen Sie sicher, dass der Status des OAuth-Plug-ins auf Aktiv festgelegt ist.

   

3. Wechseln Sie zu System-OAuth > Anwendungsregistrierung und wählen Sie Neu.

   • Auf die Frage Welche Art von OAuth-Anwendung? wählen Sie OAuth-API-Endpunkt für externe Clients erstellen aus.

     

4. Geben Sie einen Namen für Ihre Anwendung ein (z. B UiPathQuickstart) und wählen Sie Übermitteln aus (Wenn erfolgreich, werden Sie zurück zu Ihrer Liste der Anwendungsregistrierungen umgeleitet).

   

5. Suchen Sie in der Liste Anwendungsregistrierungen Ihre neue Anwendung und wählen Sie den Namen aus, um die Detailseite zu öffnen.

6. Wählen Sie das Schlosssymbol neben dem Client-Geheimnis aus, um den Wert anzuzeigen.

7. Take note of the Client Id and Client Secret values.

8. Geben Sie die folgende Umleitungs-URL in das entsprechende Feld ein: https://{baseURL}/provisioning_/callback (z. B. https://cloud.uipath.com/provisioning_/callback für Automation Cloud).

   

Set up OAuth for Zurich and Australia (Inbound Integration)

For Zurich, Australia, and later versions, ServiceNow has replaced the Create OAuth API endpoint for external clients option with a simplified Inbound Integration flow configured through the Machine Identity Console.

Follow the Configure an OAuth Authorization Code Grant steps in the ServiceNow documentation to create an Inbound Integration.

When configuring the Inbound Integration, set the redirect (callback) URL to: https://{baseURL}/provisioning_/callback (for example, https://cloud.uipath.com/provisioning_/callback for Automation Cloud).

Hinweis:

• Uncheck Allow access only to APIs in selected scope if you want users' access controls and API policies to apply by default.
• If you enable Allow access only to APIs in selected scope and assign scopes, the Tables API scope is required for the integration to work.

Tokenlebenszyklus für OAuth2.0 Authorisierungscode

Während der Verbindungserstellung leitet UiPath den Benutzer zu ServiceNow um; Der Benutzer meldet sich an und genehmigt den OAuth-Client. UiPath tauscht den Autorisierungscode gegen ein Zugriffstoken und ein Aktualisierungstoken aus und speichert sie sicher​ Zugriffstoken sind von kurzer Dauer; UiPath verwendet das Aktualisierungstoken automatisch, um neue Zugriffstoken zu erhalten, bis das Aktualisierungstoken abläuft oder die Zustimmung widerrufen wird​ Wenn der OAuth-Client gelöscht oder Token in ServiceNow widerrufen werden, muss die UiPath-Verbindung erneut autorisiert werden.

ServiceNow-Rollen und -Berechtigungen

In der folgenden Tabelle sind die Mindestrollen und Berechtigungen aufgeführt, die zum Erstellen einer Verbindung und Verwenden des ServiceNow-Connectors erforderlich sind. Die Anforderungen gelten für alle Authentifizierungstypen.

ServiceNow-Tabelle	Betrieb	Zugriffsgrund
Tabellen (sys_db_object)	Lesen	Das Tabellen-Modul bzw. die Tabelle fungiert als Repository, das eine Zeile enthält, die jeder Tabelle in Ihrer ServiceNow-Instanz entspricht. Sie wird verwendet, um eine Liste von Tabellen zum Ausführen von Aktionen oder zum Auslösen von Ereignissen zu erstellen. Dies ist erforderlich, um alle Ihre Tabellen zu laden, wenn Sie die Dropdownliste Objekt auswählen für Ihre CRUD-Aktivitäten verwenden. Dokumentationsbild
Wörterbuch (sys_dictionary)	Lesen	Diese Tabelle enthält Daten zu jeweiligen Spalten einer bestimmten Tabelle in Ihrer ServiceNow-Instanz. Diese Tabelle ist erforderlich, um Eingabe- und Ausgabefelder zu laden, wenn Sie eine Tabelle zur Ausführung einer Aktion auswählen.
Auswahlmöglichkeiten (sys_choice)	Lesen	Die Auswahltabelle enthält Werte für Optionen, die in Auswahllisten angezeigt werden, und auch für Suchvorgänge in unseren kuratierten Aktivitäten. Ohne diese Informationen können die Entwurfszeit-Lookups in unseren Aktivitäten nicht geladen werden.
Benutzer (sys_user)	Lesen	Die Auswahltabelle enthält übersetzten Text für Optionen, die in Auswahllisten angezeigt werden, und auch für Suchoptionen in unseren kuratierten Aktivitäten. Ohne diese Möglichkeit können Benutzersuchanfragen zur Entwurfszeit in unseren Aktivitäten nicht geladen werden.

Darüber hinaus muss der Benutzer über die erforderliche Zugriffskontrolle für die Tabellen verfügen, die für das Integrationsszenario unerlässlich sind. Wenn Sie beispielsweise einen Integrationsbenutzer festlegen möchten, der typische ITIL-Helpdesk-Aktionen ausführen kann (z. B. das Öffnen, Aktualisieren und Schließen von Vorfällen, Problemen, Änderungen und Konfigurationsverwaltungselementen), sollten Sie die Rolle itil zuweisen.

Benutzerdefinierte Rollen erstellen

Bestimmte Basissystemrollen, wie z. B. admin umfassen bereits die Zugriffssteuerung für diese Tabellen. Wenn Sie jedoch keine Basissystemrollen zuweisen möchten und nur die grundlegende Zugriffskontrolle bereitstellen möchten, die für die Verwendung des ServiceNow-Connectors erforderlich ist, können Sie erwägen, eine benutzerdefinierte Rolle mit den erforderlichen Zugriffsberechtigungen zu erstellen.

Um Zugriff ausschließlich auf bestimmte Tabellen oder Tabellen zu gewähren, die nicht von den standardmäßigen Basissystemrollen abgedeckt werden, empfehlen wir die Erstellung benutzerdefinierter Rollen und die Zuweisung der entsprechenden Zugriffskontrolle nach Bedarf.

Sie müssen die neuen Rollen mit den Zugriffskontrollen bereitstellen, die in der folgenden Tabelle aufgeführt sind, um den ServiceNow-Connector/die Aktivitäten nutzen zu können. Beispielsweise benötigt ein Benutzer ohne Administratorberechtigungen die Rolle personalize_dictionary , um auf die Tabelle sys_dictionary zuzugreifen.

Tabelle	Typ	Betrieb
Tabellen (sys_db_object)	Aufzeichnen	Lesen
Wörterbuch (sys_dictionary)	Aufzeichnen	Lesen
Auswahlmöglichkeiten (sys_choice)	Aufzeichnen	Lesen
Benutzer (sys_user)	Aufzeichnen	Lesen
Feldklassen (sys_glide_object)	Aufzeichnen	Lesen

Hinweis:

Das Bearbeiten oder Erstellen der Zugriffssteuerung ist eine Fähigkeit, die ausschließlich einem Benutzer mit der Rolle security\_admin zur Verfügung steht. Bei Unklarheiten ist es ratsam, sich an Ihren ServiceNow-Administrator zu wenden. Zusätzliche Informationen finden Sie in Rollen mit erhöhten Berechtigungen.

Für die Durchführung von Aktivitäts- oder Triggerausführungen müssen Sie auch andere Zugriffssteuerungen angeben.

Wenn Ihr spezifisches Szenario beispielsweise das Initiieren eines Workflows mit einem ServiceNow-Vorfall oder das Erstellen eines ServiceNow-Vorfalls beinhaltet, müssen die folgenden Zugriffskontrollen gewährt werden.

Tabelle	Typ	Betrieb
Incident	Aufzeichnen	Lesen
Incident	Aufzeichnen	Schreiben

ServiceNow-Verbindung hinzufügen

Um eine Verbindung mit Ihrer ServiceNow-Instanz zu erstellen, müssen Sie die folgenden Schritte ausführen:

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Wählen Sie Verbindung hinzufügen aus.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Wählen Sie Ihren bevorzugten Authentifizierungstyp aus und geben Sie die erforderlichen Anmeldeinformationen ein.
6. Select Connect.
7. Geben Sie als Nächstes Ihren ServiceNow-Benutzernamen und Ihr Kennwort ein. Die App fragt nach Ihrer Berechtigung, um eine Verbindung mit Ihrem ServiceNow-Konto herzustellen und mit Datensätzen zu interagieren. Wählen Sie Zulassen aus.

Weitere Informationen zum Erstellen von Verbindungen mit ServiceNow finden Sie in der ServiceNow-Produktdokumentation.