Zum Inhalt springen

Voraussetzungen für den ServiceNow v2-Connector in Jitterbit Studio

Einführung

Um eine ServiceNow v2-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-Endpunkt sowie dessen Client-ID und Client-Secret erforderlich.

Anforderungen für die Standardauthentifizierung

Anforderungen für die OAuth 2.0-Authentifizierung

Erstellen Sie einen authentifizierenden Benutzer und legen Sie Berechtigungen fest

In diesem Abschnitt wird beschrieben, wie man einen authentifizierenden Benutzer erstellt und die erforderlichen Berechtigungen für die Verwendung mit dem ServiceNow v2-Connector festlegt. Dieser Schritt ist für die Standardauthentifizierung und die 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-Verbindung eingegeben.

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

  5. Weisen Sie dem authentifizierenden Benutzer Rollen 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 Rolle erhöhen.

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

Hinweis

Die erhöhte Rolle security_admin endet, wenn die Sitzung abläuft oder wenn Sie sich von der ServiceNow-Instanz abmelden.

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ü Alle und navigieren Sie zu Benutzerverwaltung > Rollen.

  2. Erstellen Sie eine neue benutzerdefinierte Rolle, die der authentifizierende Benutzer im Namen des Jitterbit-Agenten verwendet, indem Sie auf Neu 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.

    • Anwendung: Behalten Sie den Standardwert Global bei.

    • Abonnement erforderlich: Behalten Sie den Standardwert Nicht angegeben bei.

    • Erhöhte Berechtigung: Behalten Sie den Standardwert „nicht ausgewählt" bei.

    • Beschreibung: Geben Sie eine geeignete Beschreibung ein, z. B. Wird vom authentifizierenden Benutzer im Namen des Jitterbit-Agenten verwendet.

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

Erstellen Sie einen authentifizierenden Benutzer

Die Anmeldedaten des authentifizierenden Benutzers werden während der Connector-Konfiguration in die ServiceNow v2-Verbindung eingegeben. Es wird empfohlen, einen separaten Benutzer mit einem geeigneten 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 im Namen des Jitterbit-Agenten der authentifizierende Benutzer sein wird, indem Sie auf New klicken.

  3. Füllen Sie das Formular aus und geben Sie eine geeignete 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.

Hinweis

Bewahren Sie den Benutzernamen und das Passwort an einem sicheren Ort auf, von dem aus Sie sie abrufen können, wenn Sie Ihre ServiceNow v2-Verbindung konfigurieren.

Erstellen Sie Zugriffskontrolllisten für die Aktivitäten

Für jede ServiceNow v2-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 richtigen 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 Mindestoperationstyp, der erforderlich ist, um eine ServiceNow v2-Verbindung herzustellen. Dies sind die ServiceNow-Vorgänge, die für jede ServiceNow v2-Aktivität erforderlich sind:

      ServiceNow v2-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 nach Abschluss 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.

Weisen Sie dem authentifizierenden Benutzer Rollen zu

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 User Administration > Users navigieren und den authentifizierenden Benutzer (z. B. jitterbit_harmony_agent) öffnen, 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-Rollen 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 ermöglichen.

  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-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ü All und navigieren Sie zu System OAuth > Application Registry.

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

  4. Klicken Sie auf Create an OAuth API endpoint for external clients.

  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-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-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.

Hinweis

Bewahren Sie die Client ID und das Client Secret an einem sicheren Ort auf, von dem aus Sie sie beim Konfigurieren Ihrer ServiceNow v2-Verbindung abrufen können.

Nächste Schritte

Nach Abschluss der auf dieser Seite beschriebenen Schritte 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-Verbindung verwenden.