Richten Sie ein Amazon Alexa-Spoke

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer
  • Integrieren Sie ServiceNowInstanz und Amazon Alexa Account durch Erstellen einer anwenderdefinierten OAuth-Anwendung in Amazon Alexa Zur Authentifizierung ServiceNowAnforderungen.

    Vorbereitungen

    • Fordern Sie an IntegrationHubAbonnement.
    • Aktivieren Sie Amazon Alexa-Spoke .
    • Erforderliche Rolle: Administrator

    Erstellen Sie ein Sicherheitsprofil

    Erstellen und registrieren Sie über die Entwicklerkonsole ein Sicherheitsprofil, um „Anmelden bei Amazon“ auf Ihrem zu verwenden ServiceNowInstanz.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Melden Sie sich bei an Amazon-Entwicklerportal Mit Administratoranmeldeinformationen.
    2. Erstellen Sie ein Sicherheitsprofil.
      Informationen zum Erstellen eines Sicherheitsprofils finden Sie unter Erstellen Sie ein LWA-Sicherheitsprofil In Amazon-Entwicklerdokumentation .
    3. Kopieren Sie die Werte der Client-ID und des geheimen Clientschlüssels, und zeichnen Sie sie zur späteren Verwendung auf.
    4. Konfigurieren Sie das Sicherheitsprofil, und geben Sie diese Werte in an Webeinstellungen :
      Feld Wert
      Zulässige Ursprünge ServiceNow Instanz-URL.
      Zulässige Rückgabe-URLs ServiceNowInstanzumleitungs-URL in diesem Format: https://<Instance-Name>.com/oauth_redirect.do
      Weitere Informationen zum Konfigurieren der Sicherheitsrichtlinie finden Sie unter Fügen Sie Ihre Website Ihrem Sicherheitsprofil hinzu In Amazon-Entwicklerdokumentation .

    Registrieren Amazon Alexa Als OAuth-Anbieter

    Verwenden Sie die Informationen, die während der Konfiguration des Sicherheitsprofils zur Registrierung generiert wurden Amazon Alexa Als OAuth-Anbieter und zulassen ServiceNowInstanz zum anfordern von OAuth 2,0-Token.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierungan.
    2. Offen 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. Eingabetaste: https://www.amazon.com/ap/oa
      Token-URL OAuth-Servertoken-Endpunkt. Eingabetaste: https://api.amazon.com/auth/o2/token
      Umleitungs-URL OAuth-Rückrufendpunkt 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 Amazon Alexa-Spoke

    Erstellen Sie einen Anmeldeinformationsdatensatz für Amazon Alexa Account. Die Amazon Alexa-Spoke Der Alias für Verbindungen und Anmeldeinformationen verwendet diese Anmeldeinformationen, um Aktionen zu autorisieren.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Anmeldeinformationenan.
    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-Anmeldeinformation .
      Aktiv Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes.
      OAuth-Einheitenprofil OAuth-Profil, das während der Registrierung von erstellt wurde Amazon Alexa Als OAuth-Anbieter. 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 zu weitergeleitet ServiceNowInstanz.

    Erstellen Sie einen Verbindungsdatensatz für Amazon Alexa-Spoke

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

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse Für Verbindungen Und Anmeldeinformationenan.
    2. Öffnen Sie den Aliasdatensatz, AmazonAlexa .
    3. Von Verbindungen Klicken Sie auf die Registerkarte 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 .
      Anmeldeinformationen Anmeldeinformationsdatensatz für erstellt Amazon Alexa-Spoke . Beispiel: Alexa-Anmeldeinformation .
      Verbindungsalias Alias-Datensatz, der dieser Verbindung zugeordnet ist.
      Verbindungs-URL Basis-URL, mit der eine Verbindung hergestellt werden soll Amazon Alexa . Eingabetaste: https://api.amazonalexa.com
      Aktiv Option zur aktiven Verwendung des Verbindungsdatensatzes.
      Domäne Domäne, in der die Aktion ausgeführt wird.
    5. In Attribute Registerkarte, Eingabetaste v1 Für Version .
    6. Klicken Sie auf Absenden.

    Richten Sie den Webhook für ein Amazon Alexa Spoke

    Authentifizieren Sie die eingehenden Anforderungen von Amazon Alexa Account für Ihr ServiceNowInstanz durch Erstellen einer Webhook-Registrierung.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Geben Sie im Filternavigator ein Token_Verification.list .
      Datensätze in der Tabelle „Tokenverifizierungen“ [Token_Verifizierung] werden angezeigt.
    2. Klicken Sie auf Neu.
    3. Füllen Sie diese Werte im Formular aus.
      Tabelle : 4. Token-Verifizierungsformular
      Feld Beschreibung
      Name Name zur Identifizierung des Token-Datensatzes. Beispiel: Alexa-Token .
      Beschreibung Kurze Beschreibung des Tokens.
      Token Wert des Tokens. Dieser Wert wird vor der Verwendung verschlüsselt.
    4. Klicken Sie auf Absenden.
    5. Navigieren zu Alexa-Webhooks > Alexa-Webhook-Registrierungenan.
    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 Token, das Sie erstellt haben. Beispiel: Alexa-Token .
      Pfad Geskripteter REST-Endpunkt. Ein Standardendpunkt ist verfügbar. Sie können den Standardwert gemäß 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 Rückruf-URL .
      Die Webhook-Rückruf-URL wird in der Bestätigungsnachricht angezeigt. Kopieren Sie diesen Wert, und zeichnen Sie ihn auf.
    10. Melden Sie sich bei an AWS-Verwaltungskonsole .
    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 an Alexa-Entwicklerkonsole .
    13. Navigieren zu Build > ANWENDERDEFINIERT > Endpunkt Und geben Sie die ARN der konfigurierten AWS-Lambda-Funktion an.
      AWS Lambda ARN