---
sourceDocument: Interfaces conversacionais do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais do Xanadu

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Configurar autenticação de mensagem para comunicação de entrada

# Configurar autenticação de mensagem para comunicação de entrada {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Você pode configurar a autenticação de mensagem para a API Virtual Agent em vez de Básica ou OAuth. A autenticação de mensagem envolve a configuração de tokens estáticos ou de hash, a configuração da autenticação do provedor e a definição da identidade do canal.

## Antes de Iniciar

Siga as etapas em [Revise o endpoint REST de entrada e configure a autenticação de entrada](https://servicenow-prod.fluidtopics.net/RNA_e5nsQ_A0vkZX42oVdg "Depois de instalar a API Virtual Agent, navegue até o recurso de API REST de script para revisar o endpoint e configurar a autenticação.").

Função necessária: admin

## Procedimento

1. Configure o token executando um dos procedimentos a seguir, dependendo do tipo de token.
   * Token estático:
     1. Navegue até Todos e, em seguida, insira <kbd class="ph userinput">token_verification.list</kbd> no filtro.
     2. Clique em Novo.
     3. No formulário Verificações de token, preencha os campos.  
        {#set-up-message-auth-va-api__table_lml_hbq_kqb__entry__2}

        | Campo | Descrição |
        |-|-|
        | Nome | Nome do token de autenticação, como <kbd class="ph userinput">B2BTestAppAuthToken</kbd>. |
        | Descrição | Descrição do token de autenticação, como <kbd class="ph userinput">Token de autenticação da aplicação de teste B2B</kbd>. |
        | Token | Insira um token de autenticação que você gerou usando qualquer programação geral ou linguagem de script, ou clique em Gerar token seguro nos Links relacionados. |
        [ ]

        {#set-up-message-auth-va-api__table_lml_hbq_kqb}
     4. Clique em Enviar.
     {#set-up-message-auth-va-api__ol_m4d_kcx_v4b}
   * Token de hash:
     1. Navegue até Todos e, em seguida, insira <kbd class="ph userinput">hash_message_verification.list</kbd> no filtro.
     2. Clique em Novo.
     3. No formulário Verificação de mensagem hash, preencha os campos.  
        {#set-up-message-auth-va-api__table_zwd_nbq_kqb__entry__2}

        | Campos | Descrição |
        |-|-|
        | Nome | Nome do token de autenticação, como <kbd class="ph userinput">B2BTestAppAuthToken</kbd>. |
        | Descrição | Descrição do token de autenticação, como <kbd class="ph userinput">Token de autenticação da aplicação de teste B2B</kbd>. |
        | Segredo | Token de autenticação (cadeia de caracteres aleatória). |
        [ ]

        {#set-up-message-auth-va-api__table_zwd_nbq_kqb}
     4. Clique em Enviar.
     {#set-up-message-auth-va-api__ol_o4d_kcx_v4b}
2. Configure a autenticação do provedor para autenticação baseada em token.
   1. Navegue até Todos e, em seguida, insira <kbd class="ph userinput">message_auth.list</kbd> no filtro.
   2. Clique em Novo.
   3. No formulário Message Auths, preencha os campos.  
      {#set-up-message-auth-va-api__table_ujp_1dp_kqb__entry__2}

      | Campo | Descrição |
      |-|-|
      | Nome | Nome da autenticação da mensagem, como <kbd class="ph userinput">Token de autenticação B2B</kbd>. |
      | Provedor | Nome do provedor. |
      | Nome do grupo | Não necessário. |
      | Portal de serviços | Não necessário. |
      | Verificação de mensagem de entrada | Selecione o token estático ou o token de mensagem hash que você criou. |
      | Criação de mensagem de saída | Este campo não é compatível com a API Virtual Agent. Selecione o token estático ou o token de mensagem hash que você criou. |
      | Token de serviço de saída | Este campo não é compatível com a API Virtual Agent. |
      [ ]

      {#set-up-message-auth-va-api__table_ujp_1dp_kqb}
   4. Clique em Enviar.
   {#set-up-message-auth-va-api__substeps_pqj_dqv_4tb}
3. Defina a identidade do canal.
   1. Navegue até Todos e, em seguida, insira <kbd class="ph userinput">sys_cs_provider_application.list</kbd> no filtro.
   2. Selecione o registro Aplicação do provedor de VA de bot a bot para abri-lo.
   3. No formulário Identidade do canal do provedor, localize o campo Autenticação da mensagem e selecione a autenticação da mensagem que você configurou anteriormente.  
   4. Clique em Atualizar.
   {#set-up-message-auth-va-api__substeps_wnh_hqv_4tb}
4. Somente para autenticação baseada em token de hash, envie a x-b2b-signature nos cabeçalhos da solicitação.  
   O valor é o valor codificado HmacSHA1 da carga da solicitação, que usa o token criado na instância ServiceNow. Por exemplo, no Postman, siga estas etapas:
   1. Nos cabeçalhos, defina a assinatura x-b2b como `{{hashValue}}`.  
   2. Na área Script de pré-solicitação, defina o token da seguinte forma:  

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

   {#set-up-message-auth-va-api__substeps_aj4_4rv_4tb}

## O que Fazer Depois

[Configure o endpoint REST de resposta de saída e a autenticação de saída para a API Virtual Agent](https://servicenow-prod.fluidtopics.net/FXkkw6oNXZqwqDMkP24jOw "Especifique a URL do endpoint de saída para a qual as respostas Virtual Agent são postadas. Configurar autenticação de saída.")