---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Configurar uma mensagem REST com OAuth

# Configurar uma mensagem REST com OAuth {#ariaid-title1}

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

Você pode configurar uma mensagem REST de saída para enviar credenciais OAuth com a solicitação.

## Antes de Iniciar

Função necessária: web_service_admin e oauth_admin  
Antes de iniciar este procedimento, certifique-se de:

* Há um registro de Mensagem de REST que você deseja configurar para usar o OAuth.
* Há um provedor OAuth configurado no registro da aplicação OAuth com as informações do cliente OAuth a serem usadas.
* O provedor OAuth tem um perfil OAuth 2.0 associado.
* Os métodos HTTP de mensagem REST não estão configurados para usar um MID Server.

{#t_ConfigureARESTMessageWithOAuth__ul_kpk_wzd_ts}  
Nota:  
Certifique-se de que todos os scripts que chamam esta mensagem REST usem a API RESTMessageV2. A API RESTMessageV2 é necessária para enviar mensagens REST autenticadas por meio de scripts.

## Procedimento

1. Navegar até TodosServiços web do sistemaSaídaMensagem REST.
2. Selecione um registro de mensagem REST.
3. No campo Tipo de autenticação, selecione OAuth 2.0.
4. No campo Perfil OAuth, selecione o perfil OAuth 2.0 que especifica as credenciais que você deseja enviar.
5. Clique com o botão direito no cabeçalho do formulário e selecione Salvar.  
   Uma mensagem informativa aparece na parte superior do formulário indicando que você deve solicitar um novo token OAuth.
6. Clique no link relacionado Obter token OAuth.  
   Dependendo do seu provedor OAuth, uma janela separada do seu provedor pode aparecer solicitando confirmação antes de fornecer um token. Conclua todas as etapas exigidas pelo provedor para obter o token.
{#t_ConfigureARESTMessageWithOAuth__steps_ak2_sp4_3s}

## O que Fazer Depois

Teste a mensagem REST para garantir que você receba a resposta esperada. Opcionalmente, você pode especificar diferentes configurações de autenticação para cada método HTTP relacionado a esta mensagem REST, substituindo as configurações de mensagem REST primária.
* **[Usar um provedor OAuth de terceiros](https://servicenow-prod.fluidtopics.net/XypzjYT0xouIBd9UxN7jJQ)**   
  Cada aplicação cliente deve ser registrada na instância para participar da autorização do OAuth.
* **[Tutorial de REST de saída com perfil OAuth 2.0 - integração com a API de contatos do Google](https://servicenow-prod.fluidtopics.net/LmtnySfJqhskPR_G5dHKYQ)**   
  Este tutorial explica como usar um perfil OAuth 2.0 para autenticar uma mensagem REST de saída com o Google para recuperar informações de contato.