Richten Sie die Amazon Alexa-Spokeein

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Integrieren Sie die Instanz Amazon AlexaServiceNow und das Konto [], indem Sie in [] eine benutzerdefinierte OAuth-Anwendung erstellen, um Anforderungen von ServiceNowAmazon Alexa zu authentifizieren.

    Vorbereitungen

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

    Erstellen Sie ein Sicherheitsprofil

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

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Melden Sie sich mit Administratoranmeldeinformationen beim Amazon Developer Portal an.
    2. Erstellen Sie ein Sicherheitsprofil.
      Weitere Informationen zum Erstellen eines Sicherheitsprofils finden Sie unter Erstellen eines LwA-Sicherheitsprofils in der Amazon-Entwicklerdokumentation.
    3. Kopieren Sie die Werte der Client-ID und des geheimen Clientschlüssels, 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 Hinzufügen Ihrer Website zu Ihrem Sicherheitsprofil in der Amazon-Entwicklerdokumentation.

    Registrieren Sie Amazon Alexa als OAuth-Provider

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

    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. Formular „Anwendungsregistrierungen“
      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 ein: https://www.amazon.com/ap/oa
      Token-URL OAuth-Servertoken-Endpunkt. Geben Sie 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 aus.
      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 das Konto 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 > Berechtigungen.
    2. Klicken Sie auf Neu.

      Das System zeigt die folgende Meldung 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. Zum Beispiel Alexa Cred.
      Aktiv Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes.
      OAuth-Einheitenprofil OAuth-Profil, das während der Registrierung von Amazon Alexa als OAuth-Provider 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 Ihr Konto 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 die folgenden Felder im Formular aus.
      Tabelle : 3. Formular „Verbindung“
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: Alexa-Verbindung.
      Anmeldeinformation Für die Amazon Alexa-Spokeerstellter Anmeldeinformationsdatensatz. Zum Beispiel Alexa Cred.
      Verbindungsalias Alias-Datensatz, der dieser Verbindung zugeordnet ist.
      Verbindungs-URL Basis-URL für die Verbindung mit Amazon Alexa. Geben Sie 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 den Webhook für die Spoke Amazon Alexa ein

    Authentifizieren Sie die eingehenden Anforderungen vom Konto Amazon Alexa bei 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 „Tokenverifizierungen“ [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. Formular „Alexa-Webhook-Registrierung“.
      Feld Beschreibung
      Name Name zur Identifizierung des Webhook-Registrierungsdatensatzes. Beispiel: Alexa-Token.
      Beschreibung Kurze Beschreibung des Webhook-Registrierungsdatensatzes.
      Token Token, das Sie erstellt haben. 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 des Formulars und wählen Sie Speichern aus.
    9. Klicken Sie auf Callback URL.
      Die Webhook-Rückruf-URL wird in der Bestätigungsmeldung angezeigt. Kopieren Sie diesen Wert, und notieren 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 Build > BENUTZERDEFINIERT > Endpunkt und geben Sie die ARN der von Ihnen konfigurierten AWS Lambda-Funktion an.
      AWS Lambda-ARN