ServiceNow Integration - Amazon Quick
Bevor Sie beginnenKonfiguration ServiceNow OAuthRichten Sie die Integration in Amazon Quick einVerfügbare AktionenEinschränkungenVerwaltung und Fehlerbehebung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

ServiceNow Integration

Verwenden Sie die ServiceNow Integration, um Aktionen innerhalb Ihrer ServiceNow Instanzen durchzuführen, einschließlich der Verwaltung von Vorfällen, Problemen, Änderungsanträgen, Knowledge-Base-Artikeln und Anhängen. Diese Integration verwendet die ServiceNow REST-API. Weitere Informationen finden Sie in der ServiceNow Dokumentation unter REST-API.

Die Einrichtung dieser Integration umfasst zwei Schritte. Zunächst konfigurieren Sie eine OAuth Anwendung in Ihrer ServiceNow Instanz. Anschließend erstellen Sie die Integration in Amazon Quick und verbinden sie mit Ihrer ServiceNow App. Informationen zu den Authentifizierungsmethoden, die Amazon Quick unterstützt, finden Sie unterAuthentifizierungsmethoden.

Bevor Sie beginnen

Bevor Sie die Integration einrichten, stellen Sie sicher, dass Sie über Folgendes verfügen.

  • Eine ServiceNow Instanz. Diese Integration wurde anhand der Xanadu-Version validiert.

  • Ein ServiceNow Benutzerkonto mit Berechtigungen zum Erstellen von OAuth Anwendungen (adminRolle erforderlich).

  • Für die Dienstauthentifizierung (Client-Anmeldeinformationen) muss auf Ihrer Instance die Version Washington DC oder höher ausgeführt werden.

  • Informationen zu den Abonnementanforderungen finden Sie unterIntegrationen in der Konsole einrichten.

Konfiguration ServiceNow OAuth

Bevor Sie Amazon Quick konfigurieren, erstellen Sie einen OAuth Anwendungsendpunkt in Ihrer ServiceNow Instance. Führen Sie alle folgenden Schritte aus, ServiceNow bevor Sie zur Amazon Quick-Konsole wechseln.

Weitere Informationen finden Sie in der ServiceNow Dokumentation unter Erstellen eines Endpunkts für Clients für den Zugriff auf die Instance.

Registrieren Sie die OAuth Anwendung

Gehen Sie wie folgt vor, um die OAuth Anwendung zu registrieren.

  1. Navigieren Sie in Ihrer ServiceNow Instanz zu Alle > System OAuth > Anwendungsregistrierung und wählen Sie Neu aus.

  2. Wählen Sie „ OAuth API-Endpunkt für externe Clients erstellen“.

  3. Füllen Sie das Formular aus:

    • Name — Ein beschreibender Name für die OAuth Anwendung.

    • URL umleiten — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

      {region}Ersetze es durch deine AWS Region (z. B.us-east-1).

  4. Wählen Sie Absenden aus.

  5. Öffnen Sie erneut den Registrierungseintrag der Anwendung und klicken Sie auf das Schlosssymbol neben Client Secret, um den Wert anzuzeigen.

  6. Kopieren Sie die Werte Client ID und Client Secret. Sie benötigen diese, wenn Sie die Integration in Amazon Quick konfigurieren.

Zusätzliche Schritte zur Serviceauthentifizierung (Kundenanmeldedaten)

Wenn Sie die Dienstauthentifizierung verwenden möchten, führen Sie diese zusätzlichen Schritte nach der Registrierung der OAuth Anwendung aus. Die Art der Gewährung von Kundenanmeldedaten wurde in der Version von ServiceNow Washington DC eingeführt. Weitere Informationen finden Sie unter Up Your OAuth2 2.0 Game: Eingehende Kundenanmeldedaten mit Washington DC in der ServiceNow Community.

  1. Aktivieren Sie den Gewährungstyp für Client-Anmeldeinformationen. Navigieren Sie zur sys_properties.list Verwendung des Filter-Navigators und erstellen Sie eine neue Systemeigenschaft mit den folgenden Werten:

    • Name (Name – glide.oauth.inbound.client.credential.grant_type.enabled

    • Typ: – true | false

    • Wert – true

  2. Stellen Sie sicher, dass die folgenden Plugins installiert sind (navigieren Sie zu Admin > Application Manager):

    • OAuth 2.0 (com.snc.platform.security.oauth)

    • REST-API-Anbieter (com.glide.rest)

    • Umfang der Authentifizierung (com.glide.auth.scope)

    • Plugin für den REST-API-Authentifizierungsbereich () com.glide.rest.auth.scope

  3. Kehren Sie zu Ihrer OAuth Anwendung unter System OAuth > Anwendungsregistrierung zurück. Fügen Sie das Feld OAuth Anwendungsbenutzer zum Formular hinzu, falls es nicht sichtbar ist (verwenden Sie „Konfigurieren“ > „Form Builder“, um es hinzuzufügen).

  4. Stellen Sie als OAuth Anwendungsbenutzer einen Benutzer mit entsprechenden Berechtigungen ein, z. B. einen Benutzer mit der Rolle Systemadministrator.

Wichtig

Bei der Dienstauthentifizierung werden alle Aktionen als konfigurierter OAuth Anwendungsbenutzer ausgeführt. Jeder Amazon Quick-Benutzer mit Zugriff auf diese Integration kann Aktionen mit den Berechtigungen dieses Kontos ausführen. Konfigurieren Sie die Kontoberechtigungen so, dass sie den Sicherheitsanforderungen Ihrer Organisation entsprechen.

Richten Sie die Integration in Amazon Quick ein

Nachdem Sie die ServiceNow OAuth Konfiguration abgeschlossen haben, erstellen Sie die Integration in Amazon Quick.

  1. Wählen Sie in der Amazon Quick-Konsole Integrationen aus.

  2. Wählen ServiceNowund wählen Sie die Schaltfläche Hinzufügen (plus „+“).

  3. Geben Sie die Integrationsdetails ein:

    • Name — Beschreibender Name für Ihre ServiceNow Integration.

    • Beschreibung (optional) — Zweck der Integration.

  4. Wählen Sie Ihren Verbindungstyp und geben Sie die Verbindungseinstellungen ein:

    1. Konfigurieren Sie für die Benutzerauthentifizierung (OAuth) die folgenden Felder:

      • Basis-URL — https://{your-instance}.service-now.com

      • Client-ID — Client-ID aus Ihrer ServiceNow OAuth Anwendung.

      • Geheimer Client-Schlüssel — Geheimer Client-Schlüssel aus Ihrer ServiceNow OAuth Anwendung.

      • Token-URL — https://{your-instance}.service-now.com/oauth_token.do

      • Authentifizierungs-URL — https://{your-instance}.service-now.com/oauth_auth.do

      • URL umleiten — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

    2. Konfigurieren Sie für die Dienstauthentifizierung (Client-Anmeldeinformationen) die folgenden Felder:

      • Authentifizierungstyp — Service-to-service OAuth

      • Basis-URL — https://{your-instance}.service-now.com

      • Client-ID — Client-ID aus Ihrer ServiceNow OAuth Anwendung.

      • Geheimer Client-Schlüssel — Geheimer Client-Schlüssel aus Ihrer ServiceNow OAuth Anwendung.

      • Token-URL — https://{your-instance}.service-now.com/oauth_token.do

  5. Wählen Sie Erstellen und fortfahren.

  6. Wählen Sie Benutzer aus, mit denen Sie die Integration teilen möchten.

  7. Wählen Sie Weiter aus.

Navigieren Sie zur Benutzerauthentifizierung zu Integrationen > Aktionen > Ihrem ServiceNow Integrationsnamen und wählen Sie Anmelden aus, um den OAuth Autorisierungsvorgang abzuschließen.

Verfügbare Aktionen

Nachdem Sie die Integration eingerichtet haben, sind die folgenden Aktionen verfügbar.

ServiceNow verfügbare Aktionen
Kategorie Action Description
Vorfälle Vorfälle auflisten Rufen Sie bestehende Vorfälle ab.
Vorfälle Vorfall erstellen Erstellen Sie einen Vorfalldatensatz, um Abweichungen von einem erwarteten Betriebsstandard zu dokumentieren.
Vorfälle Vorfall anzeigen Rufen Sie die Details eines bestimmten Vorfalls ab.
Vorfälle Vorfall aktualisieren Aktualisieren Sie einen Vorfalldatensatz.
Vorfälle Vorfall löschen Löschen Sie einen Vorfall.
Problems (Probleme) Probleme auflisten Rufen Sie bestehende Probleme ab.
Problems (Probleme) Problem erstellen Erstellen Sie einen neuen Problemdatensatz.
Problems (Probleme) Problem anzeigen Rufen Sie die Details eines bestimmten Problemdatensatzes ab.
Problems (Probleme) Problem aktualisieren Aktualisieren Sie einen Problemdatensatz.
Problems (Probleme) Problem löschen Lösche ein Problem.
Anfragen ändern Änderungsanfragen auflisten Rufen Sie alle Änderungsanfragen ab.
Änderungsanfragen Änderungsantrag erstellen Erstellen Sie eine Änderungsanforderung, um einen kontrollierten Prozess zur Änderung genehmigter und unterstützter Konfigurationselemente (CIs) zu implementieren.
Änderungsanfragen Änderungsanfrage anzeigen Rufen Sie detaillierte Informationen zu einer bestimmten Änderungsanforderung ab.
Änderungsanfragen Änderungsanfrage aktualisieren Ändern Sie eine Änderungsanforderung.
Änderungsanfragen Änderungsanfrage löschen Löschen Sie eine Änderungsanforderung.
Artikel in der Wissensdatenbank Wissensdatenbank-Artikel erstellen Erstellen Sie einen Wissensdatenbank-Artikel. Erfordert das Knowledge API (sn_km_api) -Plugin.
Artikel in der Wissensdatenbank Knowledge-Base-Artikel aktualisieren Ändern Sie einen Wissensdatenbank-Artikel.
Artikel in der Wissensdatenbank Knowledge-Base-Artikel löschen Löschen Sie einen Wissensdatenbank-Artikel.
Anlagen Metadaten von Anhängen abrufen Rufen Sie Metadaten für Anhangsdateien ab.
Anlagen Metadaten von Anhängen abrufen Rufen Sie Metadaten für eine bestimmte Anhangsdatei ab.
Anlagen Inhalt von Anhängen abrufen Ruft den Inhalt des Binärdateianhangs ab.
Anlagen Laden Sie den binären Anhang hoch Laden Sie eine Binärdatei als Anlage zu einem bestimmten Datensatz hoch.
Anlagen Laden Sie einen mehrteiligen Formularanhang hoch Laden Sie einen mehrteiligen Dateianhang hoch.
Anlagen Anlage löschen Löschen Sie einen Anhang.
Benutzer -Benutzer auflisten Listet alle Benutzerdatensätze auf.
System (System) Auswahlmöglichkeiten auflisten Ruft Auswahllistenwerte aus der Tabelle sys_choice ab.
Anmerkung

Die spezifischen verfügbaren Aktionen hängen von den in Ihrer ServiceNow Instanz konfigurierten Berechtigungen und der verwendeten Authentifizierungsmethode ab.

Einschränkungen

Diese Integration interagiert ServiceNow über die REST-API, die keine Benutzeroberflächenrichtlinien, Benutzeroberflächenaktionen oder Clientskripte erzwingt. Diese Regeln gelten nur in der ServiceNow Browseroberfläche. Serverseitige Geschäftsregeln und Datenrichtlinien werden durchgesetzt. ACLs Weitere Informationen finden Sie in der Dokumentation unter REST-API. ServiceNow

Verwaltung und Fehlerbehebung

Informationen zum Bearbeiten, Teilen oder Löschen Ihrer Integration finden Sie unterVerwaltung vorhandener Integrationen.

Probleme bei der Authentifizierung

  • OAuth Autorisierung schlägt fehl — Stellen Sie sicher, dass die Client-ID und der geheime Clientschlüssel mit den Werten in Ihrer ServiceNow Anwendungsregistrierung übereinstimmen. Vergewissern Sie sich, dass die Umleitungs-URL genau mit der URL in Ihrer Amazon Quick-Konfiguration ServiceNow übereinstimmt.

  • Die Serviceauthentifizierung schlägt fehl — Stellen Sie sicher, dass die glide.oauth.inbound.client.credential.grant_type.enabled Systemeigenschaft auf eingestellt isttrue. Vergewissern Sie sich, dass das Feld OAuth Anwendungsbenutzer im Datensatz der Anwendungsregistrierung ausgefüllt ist.

Häufige Fehlermeldungen

  • Aktionen geben Berechtigungsfehler zurück — Stellen Sie sicher, dass der ServiceNow Benutzer oder der OAuth Anwendungsbenutzer über die erforderlichen Rollen für den Zugriff auf die Zieltabellen verfügt (z. B. die itil Rolle für das Incident Management).

  • Verbindungstimeout oder nicht erreichbare Instanz — Stellen Sie sicher, dass die Basis-URL den richtigen ServiceNow Instanznamen verwendet. Stellen Sie sicher, dass auf die ServiceNow Instanz zugegriffen werden kann und sie sich nicht im Wartungsmodus befindet.