Voraussetzungen für den ServiceNow v2 (Beta) Connector in Jitterbit Studio

Einführung

Um eine ServiceNow v2 (Beta) Verbindung zu konfigurieren und deren Aktivitäten zu nutzen, benötigen Sie einen authentifizierenden Benutzer mit spezifischen Berechtigungen für Ihre ServiceNow-Instanz. Bei Verwendung der OAuth 2.0 Authentifizierung sind zusätzlich ein OAuth API Endpoint sowie dessen Client ID und Client Secret erforderlich.

Anforderungen für die Basis-Authentifizierung

• Erstellen Sie einen authentifizierenden Benutzer und legen Sie Berechtigungen fest

Anforderungen für die OAuth 2.0 Authentifizierung

• Erstellen Sie einen authentifizierenden Benutzer und legen Sie Berechtigungen fest

• Erstellen Sie einen OAuth API Endpoint und rufen Sie dessen Client ID und Client Secret ab

Erstellen Sie einen authentifizierenden Benutzer und legen Sie Berechtigungen fest

In diesem Abschnitt wird beschrieben, wie Sie einen authentifizierenden Benutzer erstellen und die erforderlichen Berechtigungen für die Verwendung mit dem ServiceNow v2 (Beta) Connector festlegen. Dieser Schritt ist für die Basis- und OAuth 2.0 Authentifizierung erforderlich. Der Connector benötigt diese Berechtigungen, um Metadaten von ServiceNow abzurufen, wenn eine Aktivität konfiguriert wird.

Führen Sie diese Schritte aus:

1. Erhöhen Sie Ihre Rolle: Die erhöhte Rolle security_admin ist vorübergehend erforderlich, um die anderen Schritte in diesem Abschnitt abzuschließen.

2. Erstellen Sie eine benutzerdefinierte Rolle für den authentifizierenden Benutzer: Eine benutzerdefinierte Rolle mit spezifischen Berechtigungen ist für den authentifizierenden Benutzer erforderlich.

3. Erstellen Sie einen authentifizierenden Benutzer: Die Anmeldedaten des authentifizierenden Benutzers werden während der Connector-Konfiguration in die ServiceNow v2 (Beta) Verbindung eingegeben.

4. Erstellen Sie Zugriffskontrolllisten für die Aktivitäten: Zwei separate Access Control List (ACL) Datensätze mit der benutzerdefinierten Rolle sind für jede ServiceNow v2 (Beta) Aktivität erforderlich, um wie beabsichtigt zu funktionieren.

5. Weisen Sie Rollen dem authentifizierenden Benutzer zu: Die benutzerdefinierte Rolle und zwei zusätzliche Systemrollen müssen dem authentifizierenden Benutzer zugewiesen werden.

Erhöhen Sie Ihre Rolle

Die erhöhte Rolle security_admin ist vorübergehend erforderlich, um die anderen Schritte in diesem Abschnitt abzuschließen. Führen Sie diese Schritte aus, um die erhöhte Rolle zu erhalten:

1. Klicken Sie von überall in der ServiceNow-Instanz auf das Benutzersymbol in der oberen rechten Ecke der Seite und klicken Sie dann auf Elevate role.

2. Wählen Sie security_admin aus und klicken Sie auf Update.

Erstellen Sie eine benutzerdefinierte Rolle für den authentifizierenden Benutzer

Eine benutzerdefinierte Rolle mit spezifischen Berechtigungen ist für den authentifizierenden Benutzer erforderlich. Führen Sie diese Schritte aus, um die benutzerdefinierte Rolle zu erstellen:

1. Klicken Sie auf das Menü All und navigieren Sie zu User Administration > Roles.

2. Erstellen Sie eine neue benutzerdefinierte Rolle, die der authentifizierende Benutzer im Namen des Jitterbit Agenten verwenden wird, indem Sie auf New klicken.

3. Füllen Sie das Formular mit den folgenden Informationen aus:

   • Name: Geben Sie einen geeigneten Namen für die Rolle ein, z. B. jitterbit_harmony_agent.

     Hinweis

     Der Name einer Rolle kann nach der Erstellung nicht mehr geändert werden.

   • Application: Behalten Sie den Standardwert Global bei.

   • Requires Subscription: Behalten Sie den Standardwert Unspecified bei.

   • Elevated privilege: Behalten Sie den Standardwert (nicht ausgewählt) bei.

   • Description: Geben Sie eine geeignete Beschreibung ein, z. B. Used by the authenticating user on behalf of the Jitterbit agent.

4. Klicken Sie auf Submit, um die neue Rolle zu erstellen.

Authentifizierenden Benutzer erstellen

Die Anmeldedaten des authentifizierenden Benutzers werden während der Connector-Konfiguration in die ServiceNow v2 (Beta)-Verbindung eingegeben. Es wird empfohlen, einen separaten Benutzer mit einem aussagekräftigen Namen zu erstellen, anstatt einen vorhandenen Benutzer zu verwenden. Führen Sie diese Schritte aus, um den authentifizierenden Benutzer zu erstellen:

1. Klicken Sie auf das Menü All und navigieren Sie zu System Security > Users and Groups > Users.

2. Erstellen Sie einen neuen Benutzer, der als authentifizierender Benutzer im Namen des Jitterbit-Agenten fungiert, indem Sie auf New klicken.

3. Füllen Sie das Formular aus und geben Sie eine aussagekräftige User ID ein (z. B. jitterbit_harmony_agent).

4. Legen Sie ein Passwort für den neuen Benutzer fest, indem Sie auf Set Password klicken und den Anweisungen auf dem angezeigten Bildschirm folgen.

Zugriffskontrolllisten für die Aktivitäten erstellen

Für jede ServiceNow v2 (Beta)-Aktivität sind zwei separate ACL-Datensätze (Access Control List) erforderlich, die die benutzerdefinierte Rolle verwenden, damit diese wie beabsichtigt funktionieren. Führen Sie diese Schritte aus, um beide ACLs mit den korrekten Datensätzen zu konfigurieren:

1. Klicken Sie auf das Menü All und navigieren Sie zu System Security > Access Control.

2. Erstellen Sie einen neuen ACL-Datensatz, indem Sie auf New klicken.

3. Konfigurieren Sie diese Einstellungen für den neuen ACL-Datensatz:

   • Type: Wählen Sie record aus dem Menü.

   • Operation: Wählen Sie den entsprechenden ServiceNow-Vorgang aus dem Menü. Der Vorgang read ist der Mindestvorgang, der erforderlich ist, um eine ServiceNow v2 (Beta)-Verbindung herzustellen. Dies sind die ServiceNow-Vorgänge, die für jede ServiceNow v2 (Beta)-Aktivität erforderlich sind:

     ServiceNow v2 (Beta)-Connector-Aktivität	ServiceNow-Vorgang
     Query	read
     Create	create
     Update	write
     Delete	delete

     Hinweis

     Wenn der entsprechende ServiceNow-Vorgang für eine Aktivität in der ServiceNow-Instanz nicht konfiguriert ist, gibt der Connector zur Laufzeit einen Fehler zurück.

   • Name: Um Zugriff auf sys_db_object zu gewähren, geben Sie sys_db_object ein und wählen Sie Table [sys_db_object] aus dem Menü. Lassen Sie das zweite Menü auf --None-- eingestellt.

   • Requires role: Unter Role doppelklicken Sie auf Insert a new row und geben Sie dann die zuvor erstellte benutzerdefinierte Rolle ein (z. B. jitterbit_harmony_agent). Klicken Sie auf das grüne Häkchen, um die Rolle zur ACL hinzuzufügen.

4. Klicken Sie auf Submit, um die neue ACL zu erstellen. Sie werden aufgefordert, die Einstellungen zu überprüfen, um die Erstellung der neuen Liste abzuschließen.

5. Wiederholen Sie die vorherigen drei Schritte und gewähren Sie Zugriff auf sys_glide_object für die vier ServiceNow-Vorgänge, indem Sie Field class [sys_glide_object] im Feld Name angeben. Weisen Sie dieselbe zuvor erstellte benutzerdefinierte Rolle wie oben zu.

Wenn Sie für jede Connector-Aktivität in jeder der beiden Tabellen einen ACL-Datensatz erstellen, haben Sie insgesamt acht neue Datensätze erstellt. Sie können die Tabelle Access Controls nach dem Datum Updated sortieren und diese neuen Datensätze werden oben angezeigt.

Rollen dem authentifizierenden Benutzer zuweisen

Die benutzerdefinierte Rolle und zwei zusätzliche Systemrollen müssen dem authentifizierenden Benutzer zugewiesen werden. Führen Sie diese Schritte aus, um die Rollen zuzuweisen:

1. Weisen Sie dem authentifizierenden Benutzer Rollen zu, indem Sie zu Benutzerverwaltung > Benutzer navigieren und den authentifizierenden Benutzer öffnen (z. B. jitterbit_harmony_agent), den Sie zuvor erstellt haben.

2. Klicken Sie auf der Registerkarte Rollen auf Bearbeiten und doppelklicken Sie auf die oben erstellte benutzerdefinierte Rolle, um sie zu den Zugehörigen Links des authentifizierenden Benutzers hinzuzufügen. Auf demselben Bildschirm müssen Sie auch die beiden Rollen personalize_dictionary und itil zur Liste Rollen hinzufügen, um den Zugriff auf die Tabellen sys_dictionary und itil zu aktivieren.

3. Klicken Sie auf Aktualisieren, um die Konfiguration für den authentifizierenden Benutzer zu speichern.

OAuth-API-Endpunkt erstellen und Client-ID und Client-Secret abrufen

Wenn Sie OAuth 2.0-Authentifizierung verwenden, führen Sie diese Schritte aus, um einen OAuth-API-Endpunkt zu erstellen und seine Client-ID und sein Client-Secret für die Verwendung in der ServiceNow v2 (Beta)-Verbindung abzurufen:

1. Melden Sie sich im ServiceNow Developer Portal an und klicken Sie auf Start Building für Ihre ServiceNow-Instanz.

2. Öffnen Sie von überall in der ServiceNow-Instanz das Menü Alle und navigieren Sie zu System OAuth > Application Registry.

3. Klicken Sie auf der Seite Application Registries auf die Schaltfläche Neu.

4. Klicken Sie auf Create an OAuth API endpoint for external clients (OAuth-API-Endpunkt für externe Clients erstellen).

5. Geben Sie diese Details für Ihre App ein:

   • Name: Geben Sie einen eindeutigen Namen für die Anwendung ein, z. B. Jitterbit agent.

   • Client ID: Kopieren Sie diesen Wert. Dies ist die Client-ID in der ServiceNow v2 (Beta)-Verbindung.

   • Client Secret: Geben Sie einen Wert ein oder lassen Sie das Feld leer, damit ServiceNow einen Wert generiert. Dies ist das Client-Secret in der ServiceNow v2 (Beta)-Verbindung.

   • Active: Stellen Sie sicher, dass Active ausgewählt ist.

6. Klicken Sie auf Submit, um den neuen OAuth-API-Endpunkt zu erstellen.

7. Wenn Sie das Feld Client Secret leer gelassen haben, damit ServiceNow einen Wert generiert, öffnen Sie den Eintrag erneut, um das Client-Secret anzuzeigen und zu kopieren.

Nächste Schritte

Nachdem Sie die auf dieser Seite beschriebenen Schritte abgeschlossen haben, können Sie den Benutzernamen des authentifizierenden Benutzers mit seinem Passwort und die Client-ID und das Secret der erstellten OAuth-Anwendung (falls zutreffend) in der ServiceNow v2 (Beta)-Verbindung verwenden.