Richten Sie die Amazon Alexa-Spoke ein

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

    • Integrieren Sie die Instanz ServiceNow und den Account Amazon Alexa, indem Sie in Amazon Alexa eine anwenderdefinierte OAuth-Anwendung erstellen, um Anforderungen ServiceNow von zu authentifizieren.

    Vorbereitungen

    • Fordern Sie ein IntegrationHub -Abonnement an.
    • Aktivieren Sie die Amazon Alexa-Spoke.
    • Erforderliche Rolle: Administrator

    Erstellen Sie ein Sicherheitsprofil

    Erstellen und registrieren Sie ein Sicherheitsprofil über die Entwicklerkonsole, um Anmeldung mit Amazon in Ihrer -Instanz ServiceNow zu verwenden.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Melden Sie sich mit Administratoranmeldeinformationen beim Amazon Developer Portal an.
    2. Erstellen Sie ein Sicherheitsprofil.
      Informationen zum Erstellen eines Sicherheitsprofils finden Sie unter LWA-Sicherheitsprofil erstellen in der Amazon-Entwicklerdokumentation.
    3. Kopieren Sie die Werte für Client-ID und Client-Secret, und notieren Sie sie zur späteren Verwendung.
    4. Konfigurieren Sie das Sicherheitsprofil, und geben Sie diese Werte in den Webeinstellungenan:
      Feld Wert
      Zulässige Ursprünge ServiceNow Instanz-URL.
      Zulässige Rückgabe-URLs ServiceNow Instanzumleitungs-URL in diesem Format: https://<Instance-Name> .com/oauth_redirect.do
      Weitere Informationen zum Konfigurieren der Sicherheitsrichtlinie finden Sie unter Website zu Ihrem Sicherheitsprofil hinzufügen in der Amazon-Entwicklerdokumentation.

    Registrieren Sie Amazon Alexa als OAuth-Anbieter

    Verwenden Sie die Informationen, die während der Konfiguration des Sicherheitsprofils generiert wurden, um Amazon Alexa als OAuth-Anbieter zu registrieren und der Instanz ServiceNow die Anforderung von OAuth 2.0-Token zu gestatten.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung.
    2. Öffnen Sie für den -Datensatz Amazon Alexa.
    3. Füllen Sie diese Werte im Formular aus.
      Tabelle : 1. Anwendungsregistrierungen-Formular
      Feld Beschreibung
      Client-ID Client-ID, die während der Konfiguration des Sicherheitsprofils erstellt wurde.
      Geheimer Clientschlüssel Geheimer Clientschlüssel, der während der Konfiguration des Sicherheitsprofils erstellt wurde.
      Autorisierungs-URL OAuth-Autorisierungscode-Endpunkt. Geben Sie Folgendes ein: https://www.amazon.com/ap/oa
      Token-URL OAuth-Servertoken-Endpunkt. Geben Sie Folgendes ein: https://api.amazon.com/auth/o2/token
      Umleitungs-URL OAuth-Callback-Endpunkt in diesem Format: https://<instance> .service-now.com/oauth_redirect.do
      Standardgewährungstyp Zum Erstellen des Tokens verwendeter Gewährungstyp. Wählen Sie Autorisierungscode.
      Anwendung Anwendungsbereich, der diesen Datensatz enthält.
      Aktiv Option zur aktiven Verwendung der Anwendungsregistrierung.
    4. Klicken Sie mit der rechten Maustaste auf den Formularheader und wählen Sie Speichern aus.

    Erstellen Sie einen Anmeldeinformationsdatensatz für die Amazon Alexa-Spoke

    Erstellen Sie einen Anmeldeinformationsdatensatz für den Account Amazon Alexa. Der Alias für Verbindungen und Anmeldeinformationen der Amazon Alexa-Spoke verwendet diese Anmeldeinformationen zum Autorisieren von Aktionen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Anmeldeinformationen.
    2. Klicken Sie auf Neu.

      Das System zeigt diese Nachricht an: Welche Art von Anmeldeinformationen möchten Sie erstellen?

    3. Wählen Sie OAuth 2.0-Anmeldeinformationen aus.
    4. Füllen Sie diese Werte im Formular aus.
      Tabelle : 2. Formular „OAuth 2.0-Anmeldeinformationen“
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: Alexa-Anmeldeinformationen
      Aktiv Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes.
      OAuth-Einheitenprofil OAuth-Profil, das während der Registrierung von Amazon Alexa als OAuth-Anbieter erstellt wurde. Beispiel: Amazon Alexa default_profile.
      Anmeldeinformationsalias Der Spoke zugeordneter Anmeldeinformationsalias.
    5. Klicken Sie mit der rechten Maustaste auf den Formularheader, und klicken Sie auf Absenden.
    6. Um das OAuth-Token zu generieren, klicken Sie auf den zugehörigen Link OAuth-Token abrufen.
      Sie werden zum Amazon-Portal weitergeleitet.
    7. Klicken Sie auf Zulassen.
      Sie werden zurück zur Instanz ServiceNow weitergeleitet.

    Erstellen Sie einen Verbindungsdatensatz für die Amazon Alexa-Spoke

    Erstellen Sie einen Verbindungsdatensatz für Ihren Account Amazon Alexa. Die Aliasse für Verbindungen und Anmeldeinformationen der Amazon Alexa-Spoke verwenden diese Verbindungen, um Aktionen in Amazon Alexaauszuführen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
    2. Öffnen Sie den Aliasdatensatz AmazonAlexa.
    3. Klicken Sie auf der Registerkarte Verbindungen auf Neu.
    4. Füllen Sie diese Felder im Formular aus.
      Tabelle : 3. Verbindungsformular
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: Alexa-Verbindung.
      Referenz Für Amazon Alexa-Spokeerstellter Anmeldeinformationsdatensatz. Beispiel: Alexa-Anmeldeinformationen
      Verbindungsalias Alias-Datensatz, der dieser Verbindung zugeordnet ist.
      Verbindungs-URL Basis-URL für die Verbindung mit Amazon Alexa. Geben Sie Folgendes ein: https://api.amazonalexa.com
      Aktiv Option zur aktiven Verwendung des Verbindungsdatensatzes.
      Domäne Domäne, in der die Aktion ausgeführt wird.
    5. Geben Sie auf der Registerkarte Attributev1 für Versionein.
    6. Klicken Sie auf Absenden.

    Richten Sie einen Webhook für die Spoke Amazon Alexa ein

    Authentifizieren Sie die eingehenden Anforderungen vom Konto Amazon Alexa gegenüber Ihrer Instanz ServiceNow, indem Sie eine Webhook-Registrierung erstellen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Geben Sie im Filternavigator token_verification.listein.
      Datensätze in der Tabelle „Token-Verifizierungen“ [token_verification] werden angezeigt.
    2. Klicken Sie auf Neu.
    3. Füllen Sie diese Werte im Formular aus.
      Tabelle : 4. Formular „Tokenverifizierung“
      Feld Beschreibung
      Name Name zur Identifizierung des Token-Datensatzes. Beispiel: Alexa-Token.
      Beschreibung Kurze Beschreibung des Tokens.
      Token Wert des Tokens. Dieser Wert wird verschlüsselt, bevor er verwendet wird.
    4. Klicken Sie auf Absenden.
    5. Navigieren zu Alexa-Webhooks > Alexa-Webhook-Registrierungen.
    6. Klicken Sie auf Neu.
    7. Füllen Sie diese Werte im Formular aus.
      Tabelle : 5. Alexa-Webhook-Registrierungsformular
      Feld Beschreibung
      Name Name zur Identifizierung des Webhook-Registrierungsdatensatzes. Beispiel: Alexa-Token.
      Beschreibung Kurze Beschreibung des Webhook-Registrierungsdatensatzes.
      Token Von Ihnen erstelltes Token. Beispiel: Alexa-Token.
      Pfad Geskripteter REST-Endpunkt. Ein Standardendpunkt ist verfügbar. Sie können den Standardwert entsprechend Ihren Anforderungen ändern.
    8. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.
    9. Klicken Sie auf Callback URL.
      In der Bestätigungsnachricht wird die Webhook-Callback-URL angezeigt. Kopieren Sie diesen Wert, und erfassen Sie ihn.
    10. Melden Sie sich bei der AWS-Verwaltungskonsolean.
    11. Geben Sie in der AWS Lambda-Funktion die Webhook-Rückruf-URL an, und speichern Sie die Änderungen.
      Webhook-Rückruf-URL
    12. Melden Sie sich bei der Alexa-Entwicklerkonsolean.
    13. Navigieren zu Bauen > BENUTZERDEFINIERT > Endpunkt und geben Sie den ARN der konfigurierten AWS Lambda-Funktion an.
      AWS Lambda-ARN