Installieren und Konfigurieren des Konnektors mit Snowsight

Unter diesem Thema finden Sie Informationen zur Installation und Konfiguration des Snowflake-Konnektors für ServiceNow mithilfe von Snowsight.

Unter diesem Thema:

Installieren des Snowflake-Konnektors für ServiceNow

Im Folgenden wird beschrieben, wie Sie den Konnektor installieren:

  1. Melden Sie sich bei Snowsight als Benutzer mit der Rolle ACCOUNTADMIN an.

  2. Wählen Sie im linken Navigationsbereich die Option Marketplace aus.

  3. Suchen Sie nach dem Snowflake-Konnektor für ServiceNow, und wählen Sie dann die Kachel für den Konnektor aus.

  4. Wählen Sie auf der Seite für Snowflake Connector for ServiceNow die Option Get aus.

    Daraufhin wird ein Dialogfeld angezeigt, über das Sie den ersten Teil des Installationsprozesses beginnen können.

    Konfigurieren Sie im Dialogfeld die folgenden Einstellungen:

    1. Geben Sie in das Feld Database name den Namen der Datenbank ein, die als Datenbank für die Konnektor-Instanz verwendet werden soll. Diese Datenbank wird automatisch für Sie erstellt.

    2. Wählen Sie im Feld Warehouse used for installation das Warehouse aus, das Sie für die Installation des Konnektors verwenden möchten.

      Bemerkung

      Dies ist nicht dasselbe Warehouse, das vom Konnektor zum Synchronisieren der Daten aus ServiceNow verwendet wird. In einem späteren Schritt werden Sie für diesen Zweck ein eigenes Warehouse erstellen.

    3. Fügen Sie im Feld Which roles, in addition to ACCOUNTADMIN, can access this database? die weiteren Rollen hinzu, die Zugriff auf die Datenbank erhalten sollen.

    4. Wählen Sie Get aus.

  5. Es wird ein Dialogfeld mit folgender Benachrichtigung angezeigt: <Ihr Datenbankname> is now ready to use in your account. Um mit der Konfiguration fortzufahren, wählen Sie Manage aus.

    Das Dialogfeld wird geschlossen, und auf der Seite Snowflake Connector for ServiceNow wird die UI zum Konfigurieren und Verwalten des Konnektors angezeigt.

Testen der Verbindung zu ServiceNow

Im Folgenden wird beschrieben, wie Sie eine Verbindung zu ServiceNow herstellen:

  1. Wählen Sie im Abschnitt Connections die Option Connect aus, um die Einstellungen für die Verbindung zur ServiceNow-Instanz zu konfigurieren.

    Daraufhin wird das Dialogfeld Connect to ServiceNow angezeigt.

  2. Geben Sie im Feld ServiceNow Instance den Namen der ServiceNow-Instanz ein.

    Dies ist der erste Teil des Hostnamens Ihrer ServiceNow-Instanz. Angenommen, die URL zu Ihrer ServiceNow-Instanz ist:

    https://myinstance.service-now.com
    
    Copy

    Der Name Ihrer Instanz wäre dann myinstance.

  3. Wählen Sie im Feld Authentication Method die Authentifizierungsmethode aus, die verwendet werden soll möchten, wenn der Konnektor eine Verbindung zur ServiceNow-Instanz herstellen möchte.

    Sie können entweder die Basisauthentifizierung (Benutzername und Kennwort) oder OAuth auswählen.

  4. Wenn Sie Basic authentication ausgewählt haben, geben Sie die Anmeldeinformationen für Ihr ServiceNow-Konto in die Felder ServiceNow username und ServiceNow password ein.

  5. Wenn Sie OAuth ausgewählt haben, erstellen Sie in ServiceNow eine Anwendungsregistrierung, die Sie dann zur Konfiguration des Konnektors verwenden.

    Um eine Anwendungsregistrierung zu erstellen, gehen Sie wie folgt vor:

    1. Melden Sie sich bei Ihrer ServiceNow-Instanz an, und wählen Sie dann Homepage aus.

    2. Suchen Sie nach OAuth, und wählen Sie dann Application Registry aus.

    3. Wählen Sie New, und dann Create an OAuth API endpoint for external clients aus.

      Daraufhin wird eine Konfigurationsseite für die Anwendungsregistrierung angezeigt, wie in der folgenden Abbildung dargestellt:

      Displays the Application Registry page in ServiceNow on the left.
    4. Geben Sie in ServiceNow im Feld Name einen Namen für die OAuth-Anwendungsregistrierung ein.

    5. Kopieren Sie auf der Konnektor-UI die im Feld Redirect URL angezeigte URL.

      Dieser Wert wurde vom Konnektor generiert.

    6. Fügen Sie den Wert in ServiceNow in das Feld Redirect URL ein.

    7. Aktualisieren Sie, falls erforderlich, in ServiceNow die Werte in den Feldern Refresh Token Lifespan und Access Token Lifespan.

      • Snowflake empfiehlt, die Lebensdauer des Zugriffstokens auf mindestens 600 Sekunden festzulegen.

      • Für die Lebensdauer des Aktualisierungstokens geben Sie einen Wert von 7.776.000 (90 Tage) an.

    8. Wählen Sie in ServiceNow die Option Submit aus.

      Die OAuth-Anwendungsregistrierung wird in der Liste der Anwendungsregistrierungen angezeigt.

    9. Wählen Sie in ServiceNow die soeben erstellte Anwendungsregistrierung aus.

      Beachten Sie, dass die Werte in den Feldern Client ID und Client Secret von ServiceNow generiert wurden.

    10. Kopieren Sie in ServiceNow den Wert für Client ID.

    11. Fügen Sie diesen Wert in das Feld Client ID der Konnektor-UI ein.

    12. Kopieren Sie in ServiceNow den Wert für Client Secret.

    13. Fügen Sie diesen Wert in das Feld Client Secret der Konnektor-UI ein.

      Der Konnektor verwendet ein Geheimnis (secret) (eine Art Objekt auf Schemaebene), um die Zugriffstoken zu speichern, die zur Authentifizierung bei der ServiceNow-Instanz verwendet werden. Der Konnektor verwendet dieses Geheimnisobjekt mit einer Sicherheitsintegration und einer API-Integration, um sich mit der ServiceNow-Instanz zu verbinden.

      Geheimnis, Sicherheitsintegration und API-Integration werden automatisch erstellt, wenn Sie den Konnektor installieren.

    14. Um festzulegen, wie Geheimnisobjekt, Sicherheitsintegration und API-Integration konfiguriert werden, wählen Sie Advanced Settings aus, und füllen Sie dann die folgenden Felder aus:

      Feld

      Beschreibung

      Secret Name

      Der Name des Geheimnisses. Dieser Wert wird vom Konnektor generiert. Er kann nicht geändert werden.

      Authorization URL

      Die URL für die Authentifizierung bei der ServiceNow-Instanz. Diese URL muss das folgende Format haben:

      https://<instance_name>.service-now.com/oauth_token.do
      
      Copy

      Dabei ist instance_name der Name Ihrer ServiceNow-Instanz.

      Token URL

      Die URL zum Anfordern eines Aktualisierungstokens für die ServiceNow-Instanz. Diese URL muss das folgende Format haben:

      https://<instance_name>.service-now.com/oauth_token.do
      
      Copy

      Dabei ist instance_name der Name Ihrer ServiceNow-Instanz.

      Allowed Prefix

      Die URL zu Ihrer ServiceNow-Instanz.

      Dadurch wird die Verwendung dieser Verbindungseinstellungen eingeschränkt. Die Einstellungen können nur für Verbindungen zu URLs mit den angegebenen Präfixen verwendet werden.

  6. Wählen Sie auf der Konnektor-UI die Option Connect aus.

    Ein Dialogfeld wird angezeigt, in dem Sie aufgefordert werden, sich bei Ihrer ServiceNow-Instanz mit Benutzername und Kennwort anzumelden. Geben Sie die Anmeldeinformationen des Benutzers an, mit denen sich der Konnektor authentifizieren soll, wobei der Benutzer über die unter Vorbereiten Ihrer ServiceNow-Instanz aufgeführten Berechtigungen verfügen muss.

  7. Sobald Sie angemeldet sind, müssen Sie bestätigen, dass sich der Konnektor mit Ihrem ServiceNow-Konto verbinden darf. Wählen Sie Allow aus.

    Bemerkung

    Wenn Sie direkt zu diesem Dialog weitergeleitet werden, ohne dass Sie Ihre Anmeldeinformationen eingeben müssen, sind Sie bereits bei Ihrer ServiceNow-Instanz angemeldet. Vergewissern Sie sich, dass Sie als derselbe Benutzer angemeldet sind, den der Konnektor verwenden soll, und dass dieser Benutzer über die erforderlichen Berechtigungen verfügt. Hinweis: Der aktuell angemeldete Benutzer wird in der rechten oberen Ecke des Dialogfeldes angezeigt.

    Die neue ServiceNow-Verbindung wird im Bereich Connection angezeigt.

Als Ergebnis dieser Schritte erstellt der Assistent die folgenden Objekte, die sich außerhalb der Konnektor-Datenbank befinden und für das Funktionieren des Konnektors erforderlich sind:

  • Datenbank CONNECTORS_UI mit dem Schema SERVICENOW_GZSTZTP0KHD zum Speichern des Geheimnisobjekts

  • Geheimnisobjekt in CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD namens SECRET mit Anmeldeinformationen für ServiceNow

  • Sicherheitsintegration namens SERVICENOW_GZSTZTP0KHD_INTEGRATION, die für die Integration zwischen Snowflake und einem OAuth 2.0-Drittanbieterdienst verwendet wird, wenn OAuth-Authentifizierung als Autorisierungsmethode gewählt wurde

  • API-Integration SERVICENOW_GZSTZTP0KHD_API zur Kommunikation mit ServiceNow

Die Namen dieser Objekte dürfen nicht geändert werden. Der Konnektor referenziert sie mit ihrem Namen. Das Ändern oder Löschen der Namen führt zur Unterbrechung der Referenzen und damit zur Unterbrechung des Konnektors.

Konfigurieren des Snowflake-Konnektors für ServiceNow

  1. Melden Sie sich bei Snowsight als Benutzer mit der Rolle ACCOUNTADMIN an.

  2. Wählen Sie im linken Navigationsbereich die Option Marketplace aus.

  3. Suchen Sie nach dem Snowflake-Konnektor für ServiceNow, und wählen Sie ihn aus.

  4. Wählen Sie unter dem Status des Konnektors die Option Configure aus.

    Daraufhin wird das Dialogfeld Configure Connector angezeigt.

    Bemerkung

    Standardmäßig werden die Felder auf die Namen der Objekte gesetzt, die bei der Konfiguration des Konnektors erstellt werden. Snowflake empfiehlt die Verwendung neuer Objekte für diese Felder. Sie können jedoch bei Bedarf die Namen vorhandener Objekte angeben (z. B. wenn Sie den Konnektor neu installieren).

    Füllen Sie in diesem Dialogfeld die folgenden Felder aus:

    Feld

    Beschreibung

    Warehouse

    Bezeichner für ein neues, dediziertes virtuelles Warehouse für den Konnektor.

    Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name des Warehouses muss ein gültiger Objektbezeichner sein.

    Bemerkung

    Geben Sie nicht das gleiche Warehouse an, das Sie zu Beginn der Installation des Konnektors ausgewählt haben.

    Der Konfigurationsprozess erstellt ein neues Warehouse der Größe Large mit dem angegebenen Namen.

    Destination Database

    Bezeichner für eine neue Datenbank, die das Schema mit den Tabellen für die ServiceNow-Daten in Snowflake enthält.

    Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name der Datenbank muss ein gültiger Objektbezeichner sein.

    Der Konfigurationsprozess erstellt eine neue Datenbank mit dem angegebenen Namen.

    Destination Schema

    Bezeichner für ein neues Schema, das die ServiceNow-Daten in Snowflake enthalten wird.

    Der Snowflake-Konnektor für ServiceNow erfasst ServiceNow-Daten in Tabellen dieses Schemas.

    Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name des Schemas muss ein gültiger Objektbezeichner sein.

    Der Konfigurationsprozess erstellt ein neues Schema mit dem angegebenen Namen.

    Role

    Bezeichner für eine neue kundenspezifische Rolle für den Konnektor. Mit dieser Rolle wird dem Konnektor Folgendes ermöglicht:

    • Erstellen und Verwalten von Aufgaben zum Erfassen der Daten

    • Verwenden des dedizierten Warehouses

    • Zugriff auf Geheimnis und API-Integration für die Verbindung zur ServiceNow-Instanz

    Die Rolle ist auch Eigentümer der Tabellen und Ansichten, die die vom Konnektor erfassten ServiceNow-Daten enthalten.

    Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name der Rolle muss ein gültiger Objektbezeichner sein.

    Der Konfigurationsprozess erstellt eine neue Rolle mit dem angegebenen Namen.

    Es wird zwar empfohlen, separate, feiner abgestufte Rollen für den Zugriff auf die erfassten Daten zu erstellen, nachdem die Erfassung begonnen hat, aber Sie können diese Rolle verwenden, um erfasste Daten abzufragen, und Sie können sie um zusätzliche Berechtigungen erweitern. Umgekehrt ist das Entziehen von Rollenberechtigungen für Objekte, die vom Konnektor benötigt werden, oder das Ändern der Rolleneigentümerschaft von Tabellen und Ansichten der erfassten Daten nicht zulässig und führt zur Unterbrechung des Konnektors.

    Journal table

    (Optional) Um die Weitergabe gelöschter Datensätze zu aktivieren, setzen Sie diesen Parameter auf die Tabelle, die als Quelle für Informationen zu gelöschten Datensätzen dient.

    Sie können entweder die Tabelle sys_audit_delete oder eine kundenspezifische Erfassungstabelle als Quelle für Informationen zu gelöschten Datensätzen verwenden.

    Wenn Sie keine gelöschten Datensätze aus ServiceNow in Snowflake erfassen möchten, lassen Sie dieses Feld leer.

    Bemerkung

    Stellen Sie sicher, dass der ServiceNow-Benutzer für den Konnektor Zugriff auf die angegebene Erfassungstabelle hat.

  5. Wählen Sie Configure aus.

Das Dialogfeld wird geschlossen, und der Status des Konnektors ändert sich in Provisioning. Es kann einige Minuten dauern, bis der Konfigurationsprozess abgeschlossen ist.

Im Abschnitt Connector Objects werden die Objekte angezeigt, die während der Installation und Konfiguration automatisch erstellt wurden. Der Konnektor verwendet diese Objekte, um Daten aus der ServiceNow-Instanz zu erfassen. Wählen Sie ein Objekt aus, um die Details zu diesem Objekt anzuzeigen.

Wenn der Konfigurationsprozess erfolgreich abgeschlossen wurde, ändert sich der angezeigte Status in Inactive.

Der Konnektor verweist über den Namen auf das Warehouse, die Zieldatenbank, das Zielschema und die Rolle. Wenn Sie die Namen dieser Objekte ändern oder sie löschen, werden die Referenzen unterbrochen, und infolgedessen wird auch der Konnektor unterbrochen. Anstatt das Warehouse umzubenennen, verwenden Sie die gespeicherte Prozedur CONFIGURE_WAREHOUSE, um das vom Konnektor verwendete Warehouse zu ändern.

Problembehandlung bei Konfiguration

Tritt während des Konfigurationsprozesses ein Fehler auf, ändert sich der Status des Konnektors in Incomplete. So identifizieren und behandeln Sie Fehler:

  1. Wählen Sie Retry Setup aus, um das Konfigurationsdialogfeld erneut anzuzeigen.

  2. Prüfen Sie, ob in einem der Felder Fehlermeldungen angezeigt werden.

  3. Lösen Sie die Probleme in den Feldern, und wählen Sie Configure aus, um den Konfigurationsprozess erneut zu starten.

Einrichten der Datenerfassung

Führen Sie nach Installation und Konfiguration des Konnektors die unter Einrichten der Datenerfassung (Data Ingestion) für Ihre ServiceNow-Daten beschriebenen Schritte aus.