Configurer l’authentification de message pour la communication entrante

Vous pouvez configurer l’authentification de message pour l’API Agent virtuel au lieu de l’authentification de base ou OAuth. L’authentification de message implique la configuration de jetons statiques ou de hachage, la configuration de l’authentification du fournisseur et la définition de l’identité du canal.

Avant de commencer

Suivez les étapes dans Examiner le point de terminaison REST entrant et configurer l’authentification entrante.

Rôle requis : admin

Procédure

1. Configurez le jeton en effectuant l’une des opérations suivantes, en fonction du type de jeton :
   • Jeton statique :
     1. Accédez à Tous, puis saisissez token_verification.list dans le filtre.
     2. Cliquez sur Nouveau.
     3. Renseignez les champs du formulaire Vérifications des jetons.

        Champ	Description
        Nom	Nom du jeton d’authentification, par exemple B2BTestAppAuthToken.
        Description	Description du jeton d’authentification, tel que jeton d’authentification de l’application de test B2B.
        Jeton	Entrez un jeton d’authentification que vous avez généré à l’aide d’un langage de script ou de programmation général, ou cliquez sur Générer un jeton sécurisé dans les liens connexes.

     4. Cliquez sur Envoyer.
   • Jeton de hachage :
     1. Accédez à Tout, puis saisissez hash_message_verification.list dans le filtre.
     2. Cliquez sur Nouveau.
     3. Renseignez les champs du formulaire Vérification du message de hachage.

        Champs	Description
        Nom	Nom du jeton d’authentification, par exemple B2BTestAppAuthToken.
        Description	Description du jeton d’authentification, tel que jeton d’authentification de l’application de test B2B.
        Clé secrète	Jeton d’authentification (chaîne aléatoire).

     4. Cliquez sur Envoyer.
2. Configurez l’authentification du fournisseur pour l’authentification basée sur les jetons.
   1. Accédez à Tous, puis saisissez message_auth.list dans le filtre.
   2. Cliquez sur Nouveau.
   3. Renseignez les champs du formulaire Authentification de message.

      Champ	Description
      Nom	Nom de l’authentification du message, tel que jeton d’authentification B2B.
      Fournisseur	Nom du fournisseur.
      Nom du groupe	Non requis.
      Portail de services	Non requis.
      Vérification du message entrant	Sélectionnez le jeton statique ou le jeton de message de hachage que vous avez créé.
      Création de message sortant	Ce champ n’est actuellement pas pris en charge dans l’API Agent virtuel . Sélectionnez le jeton statique ou le jeton de message de hachage que vous avez créé.
      Jeton de service sortant	Ce champ n’est actuellement pas pris en charge dans l’API Agent virtuel .

   4. Cliquez sur Envoyer.
3. Définissez l’identité du canal.
   1. Accédez à Tous, puis saisissez sys_cs_provider_application.list dans le filtre.
   2. Sélectionnez l’enregistrement d’application du fournisseur d’agent à agent VA pour l’ouvrir.
   3. Dans le formulaire Identité du canal du fournisseur, localisez le champ Authentification du message et sélectionnez l’authentification du message que vous avez configurée précédemment.

      

   4. Cliquez sur Mettre à jour.
4. Pour l’authentification basée sur un jeton de hachage uniquement, envoyez le x-b2b-signature dans les en-têtes de demande.
   La valeur est la HmacSHA1 valeur codée de la charge utile de la demande, qui utilise le jeton créé dans l’instance ServiceNow . Par exemple, dans Postman, procédez comme suit :
   1. Dans les en-têtes, définissez la signature x-b2b sur {{hashValue}}.

      

   2. Dans la zone Script de pré-demande, définissez le jeton comme suit :

      pm.environment.set('hashValue', CryptoJS.HmacSHA1(JSON.stringify(JSON.parse(request.data)), '<insert your token>').toString(CryptoJS.enc.Hex));

      

Que faire ensuite

Configurer le point de terminaison REST de réponse de sortie et l’authentification sortante pour l’API Agent virtuel