---
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


---

# Perfis e escopos do OAuth

# Perfis e escopos do 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

No cenário do provedor OAuth, os perfis e escopos especificam o tipo de concessão, o tipo de autorização e o nível de acesso.
No cenário do provedor OAuth, o perfil OAuth se refere a uma combinação de um tipo de concessão e pelo menos um escopo. O escopo especifica o acesso que o usuário tem ao recurso protegido, como leitura ou gravação. Você pode criar um perfil para cada provedor de terceiros e obter o conjunto específico de escopos do provedor. Para obter mais informações, consulte [Especificar um perfil OAuth](https://servicenow-prod.fluidtopics.net/BkTTHFLQXqpdHVqcMf6AzA "Um perfil OAuth inclui o tipo de concessão que o provedor OAuth de terceiros precisa para obter acesso ao recurso restrito.") e [Especificar um escopo do OAuth](https://servicenow-prod.fluidtopics.net/DK9Sm51~YfDP6G0lxNmElQ "Especifique os escopos do OAuth que você obtém do provedor. Os escopos podem ser qualquer nível de acesso especificado pelo provedor, como leitura, gravação ou qualquer cadeia de caracteres, incluindo um URL."). A instância também usa perfis OAuth quando uma chamada REST especifica a autenticação OAuth 2.0. A instância cria automaticamente um perfil padrão para cada registro de provedor de terceiros criado. Só pode haver um perfil padrão.  
Especifique os seguintes parâmetros, que são salvos na tabela Perfil do solicitante do OAuth \[OAuth_requestor_profile\]: {#c_OAuthProviderAndScope__table_u14_lcp_vs__entry__2}

| Parâmetro | Descrição |
|-|-|
| `oauth_requestor` | O sys_id do objeto, que pode ser um registro de usuário ou uma conta de e-mail. |
| `oauth_requestor_context` | Descritor que fornece contexto para o solicitante do OAuth. Como prática recomendada, use o nome da tabela em que o objeto `oauth_requestor` foi salvo. |
| `oauth_provider_profile` | O sys_id do registro de perfil OAuth que é o padrão (consulte [Especificar um perfil OAuth](https://servicenow-prod.fluidtopics.net/BkTTHFLQXqpdHVqcMf6AzA "Um perfil OAuth inclui o tipo de concessão que o provedor OAuth de terceiros precisa para obter acesso ao recurso restrito.")). |
[Tabela 1. Parâmetros OAuth para suporte de perfil padrão]

{#c_OAuthProviderAndScope__table_u14_lcp_vs}

Quando o usuário tenta se autenticar, o provedor acessa a tabela Perfil do solicitante do OAuth para procurar o usuário. Se o usuário for encontrado, a autenticação será bem-sucedida. Caso contrário, o provedor acessará o perfil padrão para determinar o tipo de concessão e como prosseguir com a autenticação.
* **[Especificar um perfil OAuth](https://servicenow-prod.fluidtopics.net/BkTTHFLQXqpdHVqcMf6AzA)**   
  Um perfil OAuth inclui o tipo de concessão que o provedor OAuth de terceiros precisa para obter acesso ao recurso restrito.
* **[Especificar um escopo do OAuth](https://servicenow-prod.fluidtopics.net/DK9Sm51~YfDP6G0lxNmElQ)**   
  Especifique os escopos do OAuth que você obtém do provedor. Os escopos podem ser qualquer nível de acesso especificado pelo provedor, como leitura, gravação ou qualquer cadeia de caracteres, incluindo um URL.