ServiceNow-Instanz für CDC konfigurieren

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Mit Datastream können Sie Daten aus einer ServiceNow-Instanz in ein unterstütztes Ziel wie BigQuery oder Cloud Storage replizieren. Bevor Sie ein Verbindungsprofil erstellen, richten Sie einen dedizierten Integrationsnutzer ein, konfigurieren die Basis- oder OAuth 2.0-Authentifizierung und setzen bei Bedarf Datastream-IP-Adressen auf die Zulassungsliste.

Hinweis

Bevor Sie ServiceNow für die Verwendung mit Datastream konfigurieren, müssen Sie Folgendes tun:

• Eine aktive ServiceNow-Instanz, z. B. company.service-now.com.
• Administratorberechtigungen für die ServiceNow-Instanz, um Nutzer zu erstellen, Rollen zuzuweisen und die OAuth-Anwendungsregistrierung zu verwalten.
• Kenntnis der Version Ihrer ServiceNow-Instanz.

Integrationsnutzer konfigurieren

In ServiceNow können Sie entweder einen neuen Nutzer erstellen oder die Einstellungen für ein vorhandenes Konto anpassen, um den Zugriff auf Datastream zu ermöglichen. Aus Sicherheits- und Prüfungsgründen empfehlen wir dringend, einen dedizierten Integrationsnutzer zu erstellen.

1. Gehen Sie in ServiceNow zu User Administration > Users (Nutzerverwaltung > Nutzer).
2. Klicken Sie auf Neu, um einen neuen Nutzer zu erstellen. Wenn Sie einen vorhandenen Nutzer bearbeiten möchten, suchen Sie in der Nutzerliste nach der Nutzer-ID und klicken Sie darauf, um den Datensatz zu öffnen.

3. Konfigurieren Sie die Nutzerdetails:

   • Geben Sie im Feld Nutzer-ID einen eindeutigen Namen ein, z. B. datastream_integration. Sie legen die Nutzer-ID nur für neue Nutzer fest.
   • Wenn Sie die OAuth-Authentifizierung für den Connector auswählen, empfehlen wir, Werte in die Felder Vorname und Nachname einzugeben, um den Nutzerdatensatz besser identifizieren zu können.

   • Identitätskonfiguration: basierend auf Ihrer ServiceNow-Plattformversion:

     • Xanadu und höher: Wählen Sie im Drop-down-Menü Identitätstyp die Option Maschine aus. Dadurch wird Web service access only (Nur Webdienstzugriff) automatisch aktiviert.
     • Vor Xanadu: Klicken Sie das Kästchen Nur Webdienstzugriff an.

4. Speichern Sie den Eintrag:

   • Klicken Sie bei neuen Nutzern auf Senden.
   • Klicken Sie bei bestehenden Nutzern auf Aktualisieren.

5. Wenn Sie einen neuen Nutzer erstellt haben, öffnen Sie den Eintrag noch einmal. Suchen Sie den Nutzer in der Liste und klicken Sie auf seine Nutzer-ID, um die Optionen für den Datensatz aufzurufen.

6. Passwort festlegen:

   1. Klicken Sie in der Kopfzeile des Formulars auf Passwort festlegen.
   2. Geben Sie ein starkes Passwort ein und klicken Sie auf Passwort speichern.
   3. Wenn Sie die Standardauthentifizierung für den Connector verwenden, notieren Sie sich das Passwort, da es für die Konfiguration des Verbindungsprofils erforderlich ist.

7. Berechtigungen zuweisen Sie müssen dem Integrationsnutzer Lesezugriff auf alle Tabellen gewähren, die Sie replizieren möchten. Außerdem benötigt der Connector explizite Leseberechtigungen für die Systemmetadatentabellen sys_db_object, sys_table_rotation und sys_dictionary.

Aufgrund der detaillierten Natur der ServiceNow-Rollen und des ACL-Systems (Access Control List) ist die spezifische Konfiguration, die zum Gewähren dieser Berechtigungen erforderlich ist, kundenspezifisch.

• Wir empfehlen dringend, dem Nutzer die Rolle snc_read_only zuzuweisen, da so sichergestellt wird, dass die Nutzersitzung auf der gesamten Plattform strikt auf den Lesezugriff beschränkt ist.
• Die Rolle admin gewährt umfassenden Zugriff auf alle Tabellen in der Instanz. Wenn Ihre Sicherheitsrichtlinien es zulassen, ist die Zuweisung der Rolle Administrator die einfachste Methode, um vollen Connector-Zugriff zu gewähren.

Optional: OAuth 2.0-Clientanmeldedaten konfigurieren

OAuth 2.0 ist die sicherste und empfohlene Authentifizierungsmethode für die Verwendung des ServiceNow-Connectors mit Datastream. Es verwendet eine Client-ID und einen Clientschlüssel anstelle eines permanenten Passworts.

1. Aktivieren Sie das OAuth 2.0-Plug-in für Ihre Instanz. Weitere Informationen finden Sie in der ServiceNow-Dokumentation.
2. Achten Sie darauf, dass die Systemeigenschaft com.snc.platform.security.oauth.is.active auf true festgelegt ist. Weitere Informationen finden Sie in der ServiceNow-Dokumentation.
3. Die Systemeigenschaft glide.oauth.inbound.client.credential.grant_type.enabled muss auf true festgelegt sein. Weitere Informationen finden Sie in der ServiceNow-Dokumentation.

4. Konfiguration für eingehendes OAuth einrichten Je nach den Sicherheitsanforderungen Ihrer Instanz können Sie einen der folgenden OAuth-Konfigurationsbereiche auswählen:

   • Breit gefasst: Bei Verwendung von breit gefasstem OAuth übernimmt der Tokeninhaber die zugehörigen Nutzerrollen und Access Control Lists (ACLs).
   • Granulare REST API-Authentifizierung: Diese Art von OAuth-Konfiguration beschränkt sich auf bestimmte REST APIs und Methoden, die durch den Bereich zusätzlich zu den zugehörigen Nutzerrollen und ACLs zulässig sind.

5. Erstellen Sie den OAuth-Integrationseintrag. Weitere Informationen finden Sie in der ServiceNow-Dokumentation:

   • Für die Zurich-Plattformversion und höher
   • Für Plattformversionen vor Zürich

6. Nachdem Sie den OAuth-Integrationseintrag erstellt haben, hängt die Konfiguration von der Plattformversion und dem OAuth-Bereich ab:

   • Umfassende Konfiguration:

     • Zurich und höher: Achten Sie darauf, dass im Abschnitt Auth-Bereich für Ihren Integrationseintrag keine Einträge in den Feldern Auth-Bereich oder Autorisierung auf die folgenden APIs beschränken vorhanden sind und dass das Kästchen Zugriff nur auf APIs im ausgewählten Bereich zulassen nicht ausgewählt ist.
     • Vor Zürich: Wählen Sie im Drop-down-Menü Bereichseinschränkung die Option Breit gefasst aus und lassen Sie die Liste Authentifizierungsbereiche leer.

   • Detaillierte REST API-Konfiguration mit Auth-Bereich: Optional können Sie Auth-Bereiche verwenden, um den Tokeninhaber weiter auf bestimmte REST APIs und Methoden zu beschränken, die durch den Bereich zulässig sind. Der Datastream-Connector benötigt nur GET-Zugriff auf die Table API. Führen Sie je nach Plattformversion die folgenden Schritte aus:

     • Zurich und höher: Wählen Sie im Abschnitt Auth scope für Ihren Integrationseintrag einen Autorisierungsbereich aus und beschränken Sie den Zugriff auf die Table API.

       Hinweis: Wenn Sie den Autorisierungsbereich beim Bearbeiten Ihres Integrationseintrags erstellen, hat der Bereich standardmäßig Zugriff auf alle API-Methoden der Table API. Wenn Sie den Zugriff weiter auf die Methode GET beschränken möchten, müssen Sie den neu erstellten Eintrag manuell bearbeiten. Rufen Sie dazu System Web Services > API Auth Scopes > REST API Auth Scope auf.

     • Vor Zürich:

       1. Beschränken Sie den Zugriff auf die Table API für den ausgewählten Autorisierungsbereich. Weitere Informationen finden Sie in der ServiceNow-Dokumentation.
       2. Fügen Sie den Bereich im Abschnitt Auth-Bereiche hinzu.
       3. Wählen Sie im Feld Bereichseinschränkung die Option Sicherer Bereich aus.

Optional: Zugriffssteuerung für IP-Adressen konfigurieren

Wenn Ihre ServiceNow-Instanz die Zugriffssteuerung für IP-Adressen verwendet, müssen Sie Datastream-IP-Adressen explizit auf die Zulassungsliste setzen.

Die folgenden Schritte sind nur erforderlich, wenn Sie eine DENY-Regel für die Zugriffssteuerung von IP-Adressen haben, die Datastream-IP-Adressen abdeckt. Standardmäßig gibt es keine IP-Einschränkungen für den Zugriff auf die Instanz.

1. Rufen Sie in ServiceNow Systemsicherheit > IP-Adressen-Zugriffssteuerung auf.
2. Klicken Sie auf Neu.
3. Wenden Sie im Formular zur Erstellung des Datensatzes die folgenden Einstellungen an:
   1. Wählen Sie im Drop-down-Menü Typ die Option Zulassen aus.
   2. Wählen Sie im Drop-down-Menü Richtung die Option Eingehend aus.
   3. Geben Sie in die Felder Bereichsanfang und Bereichsende die spezifische IP-Adresse oder den Adressbereich aus der Liste der Datastream-IP-Adressen ein.
   4. Achten Sie darauf, dass das Kästchen Aktiv ausgewählt ist.
4. Klicken Sie auf Senden.
5. Wiederholen Sie die vorherigen Schritte für jede IP-Adresse in der Liste der Datastream-Adressen.

Nächste Schritte

• Weitere Informationen zur ServiceNow-Quelle