Configurer le spoke Amazon Alexa

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • Intégrez l’instance et Alexa d’Amazon le ServiceNow compte en créant une application OAuth personnalisée pour Alexa d’Amazon authentifier les ServiceNow demandes.

    Avant de commencer

    • Demander un Hub d'intégration abonnement.
    • Activez le spoke Amazon Alexa.
    • Rôle requis : administrateur

    Créer un profil de sécurité

    Créez et enregistrez un profil de sécurité via la console développeur pour utiliser Login with Amazon sur votre ServiceNow instance.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Connectez-vous à Amazon Developer Portal avec les informations d’identification d’administrateur.
    2. Créez un profil de sécurité.
      Pour plus d’informations sur la création d’un profil de sécurité, consultez Créer un profil de sécurité LwA dans la documentation Amazon Developer.
    3. Copiez et enregistrez les valeurs ID client et Secret client pour une utilisation ultérieure.
    4. Configurez le profil de sécurité et spécifiez ces valeurs dans les paramètres Web :
      Champ Valeur
      Origines autorisées ServiceNow URL de l’instance.
      URL de retour autorisées ServiceNow URL de redirection d’instance au format suivant : https://<Nom-Instance>.com/oauth_redirect.do
      Pour plus d’informations sur la configuration de la stratégie de sécurité, consultez Ajouter votre site Web à votre profil de sécurité dans la documentation Amazon Developer.

    S’inscrire Alexa d’Amazon en tant que fournisseur OAuth

    Utilisez les informations générées lors de la configuration du profil de sécurité pour vous enregistrer Alexa d’Amazon en tant que fournisseur OAuth et permettre à l’instance ServiceNow de demander des jetons OAuth 2.0.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > OAuth système > Registre d'application.
    2. Ouvrez pour mémoire, Amazon Alexa.
    3. Renseignez ces valeurs sur le formulaire.
      Tableau 1. Formulaire des registres d'application
      Champ Description
      ID client ID client créé lors de la configuration du profil de sécurité.
      Secret client Secret client créé lors de la configuration du profil de sécurité.
      URL d'autorisation Point de terminaison du code d'autorisation OAuth. Entrez : https://www.amazon.com/ap/oa
      URL de jeton Point de terminaison de jeton du serveur OAuth. Entrez : https://api.amazon.com/auth/o2/token
      URL de redirection Point de terminaison de rappel OAuth au format suivant : https://<instance>.service-now.com/oauth_redirect.do
      Type d'accord par défaut Type d'accord utilisé pour établir le jeton. Sélectionnez Code d'autorisation.
      Application Périmètre de l'application qui contient cet enregistrement.
      Actif Option permettant d’utiliser activement le registre d’application.
    4. Cliquez avec le bouton droit de la souris sur l'en-tête du formulaire, puis cliquez sur Enregistrer.

    Créer un enregistrement d’informations d’identification pour le spoke Amazon Alexa

    Créez un enregistrement d’informations d’identification pour le Alexa d’Amazon compte. Les alias de connexion et d’informations d’identification du spoke Amazon Alexa utilisent ces informations d’identification pour autoriser des actions.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Informations d'identification.
    2. Cliquez sur Nouveau.

      Le système affiche ce message : Quel type d’informations d’identification voulez-vous créer ?

    3. Sélectionnez Informations d'identification OAuth 2.0.
    4. Renseignez ces valeurs sur le formulaire.
      Tableau 2. Formulaire Informations d'identification OAuth 2.0
      Champ Description
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, Alexa Cred.
      Actif Option permettant d'utiliser activement l'enregistrement des informations d'identification.
      Profil de l'entité OAuth Profil OAuth créé lors de l’inscription Alexa d’Amazon en tant que fournisseur OAuth. Par exemple, Amazon Alexa default_profile.
      Alias d'informations d'identification Alias d'informations d'identification associé au spoke.
    5. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Envoyer.
    6. Pour générer le jeton OAuth, cliquez sur le lien connexe Obtenir le jeton OAuth.
      Vous serez redirigé vers le portail Amazon.
    7. Cliquez sur Autoriser.
      Vous allez être redirigé vers l’instance ServiceNow .

    Créer un enregistrement de connexion pour le spoke Amazon Alexa

    Créez un enregistrement de connexion pour votre Alexa d’Amazon compte. Les alias de connexion et d’informations d’identification du spoke Amazon Alexa utilisent ces connexions pour effectuer des actions dans Alexa d’Amazon.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Alias de connexion et d’informations d’identification.
    2. Ouvrez l’enregistrement d’alias, AmazonAlexa.
    3. Dans l’onglet Connexions , cliquez sur Nouveau.
    4. Renseignez les champs suivants du formulaire.
      Tableau 3. Formulaire Connexion
      Champ Description
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, Connexion Alexa.
      Informations d'identification Enregistrement d’informations d’identification créé pour le spoke Amazon Alexa. Par exemple, Alexa Cred.
      Alias de connexion Enregistrement d'alias associé à cette connexion.
      URL de connexion URL de base pour se connecter Alexa d’Amazon. Entrez : https://api.amazonalexa.com
      Actif Option permettant d’utiliser activement l’enregistrement de connexion.
      Domaine Domaine dans lequel l’action s’exécute.
    5. Dans l’onglet Attributs , entrez v1 pour la version.
    6. Cliquez sur Envoyer.

    Configurer le webhook pour le Alexa d’Amazon spoke

    Authentifiez les demandes entrantes du Alexa d’Amazon compte vers votre ServiceNow instance en créant un registre Webhook.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Dans le navigateur de filtre, saisissez token_verification.list.
      Les enregistrements de la table Vérifications des jetons [token_verification] s’affichent.
    2. Cliquez sur Nouveau.
    3. Renseignez ces valeurs sur le formulaire.
      Tableau 4. Formulaire de vérification de jeton
      Champ Description
      Nom Nom permettant d’identifier l’enregistrement de jeton. Par exemple, jeton Alexa.
      Description Brève description du jeton.
      Jeton Valeur du jeton. Cette valeur est chiffrée avant d’être utilisée.
    4. Cliquez sur Envoyer.
    5. Accédez à la Webhooks Alexa > Registres Webhook Alexa.
    6. Cliquez sur Nouveau.
    7. Renseignez ces valeurs sur le formulaire.
      Tableau 5. Formulaire du registre Webhook Alexa
      Champ Description
      Nom Nom permettant d’identifier l’enregistrement de registre webhook. Par exemple, jeton Alexa.
      Description Brève description de l’enregistrement du registre webhook.
      Jeton Jeton que vous avez créé. Par exemple, jeton Alexa.
      Chemin d'accès Point de terminaison REST scripté. Un point de terminaison par défaut est disponible. Vous pouvez modifier la valeur par défaut selon vos besoins.
    8. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
    9. Cliquez sur URL de rappel.
      L’URL de rappel webhook s’affiche dans le message de confirmation. Copiez et enregistrez cette valeur.
    10. Connectez-vous à AWS Management Console.
    11. Dans la fonction AWS Lambda, spécifiez l’URL de rappel Webhook et enregistrez les modifications.
      URL de rappel webhook
    12. Connectez-vous à la console développeur Alexa.
    13. Accédez à la Version > COUTUME > Point de terminaison et spécifiez l’ARN de la fonction AWS Lambda que vous avez configurée.
      AWS Lambda ARN