O que é o OAuth 2.0?

[OAuth 2.0](https://tools.ietf.org/html/rfc6749), que significa "Autorização Aberta", é um padrão projetado para permitir que um site ou aplicativo acesse recursos hospedados por outros aplicativos da web em nome de um usuário. Ele substituiu o OAuth 1.0 em 2012 e agora é o padrão de fato do setor para autorização online. O OAuth 2.0 fornece acesso consentido e restringe ações quanto ao que o aplicativo cliente pode executar em recursos em nome do usuário, sem nunca compartilhar as credenciais do usuário.\n\nEmbora a web seja a principal plataforma para o OAuth 2, a especificação também descreve como lidar com esse tipo de acesso delegado a outros tipos de clientes (aplicativos baseados em navegador, aplicativos da web do lado do servidor, aplicativos nativos/móveis, dispositivos conectados, etc.)

O OAuth 2.0 é um protocolo de autorização e NÃO um protocolo de autenticação. Como tal, ele foi projetado principalmente como um meio de conceder acesso a um conjunto de recursos, por exemplo, APIs remotas ou dados do usuário.\n\nO Oauth 2.0 usa tokens de acesso. Um **token de acesso** é um dado que representa a autorização para acessar recursos em nome do usuário final. O OAuth 2.0 não define um formato específico para tokens de acesso. No entanto, em alguns contextos, o formato JSON Web Token (JWT) é frequentemente usado. Isso permite que os emissores de token incluam dados no próprio token. Além disso, por razões de segurança, os tokens de acesso podem ter uma data de validade.

Princípios do OAuth2.0

A ideia de funções é parte da especificação central do framework de autorização do OAuth2.0. Elas definem os componentes essenciais de um sistema OAuth 2.0 e são: \n\n- **Proprietário do recurso:** o usuário ou sistema que possui os recursos protegidos e pode conceder acesso a eles.\n\n- **Cliente:** o cliente é o sistema que requer acesso aos recursos protegidos. Para acessar recursos, o Cliente deve ter o token de acesso apropriado.\n\n- **Servidor de autorização:** este servidor recebe solicitações do Cliente para tokens de acesso e os emite mediante autenticação e consentimento bem-sucedidos do proprietário do recurso. O servidor de autorização expõe dois endpoints: o endpoint de Autorização, que lida com a autenticação e o consentimento interativos do usuário, e o endpoint de Token, que está envolvido em uma interação máquina a máquina.\n\n- **Servidor de recursos:** um servidor que protege os recursos do usuário e recebe solicitações de acesso do Cliente. Ele aceita e valida um token de acesso do cliente e retorna os recursos apropriados para ele.

Funções do OAuth2.0

Os escopos são um conceito importante no OAuth 2.0. Eles são usados para especificar exatamente a razão pela qual o acesso aos recursos pode ser concedido. Valores de escopo aceitáveis e com quais recursos eles se relacionam dependem do servidor de recursos.

Escopos do OAuth 2.0

O servidor de autorização OAuth 2 não pode retornar diretamente um token de acesso após o proprietário do recurso ter autorizado o acesso. Em vez disso, e para melhor segurança, um **código de autorização** pode ser retornado, que é trocado por um token de acesso.  Além disso, o servidor de autorização também pode emitir um [token de atualização](https://auth0.com/blog/refresh-tokens-what-are-they-and-when-to-use-them/) com o token de acesso. Ao contrário dos tokens de acesso, os tokens de atualização normalmente têm validade longa e podem ser trocados por novos tokens de acesso após a expiração. Como os tokens de atualização têm essas propriedades, eles devem ser armazenados com segurança pelos clientes.

Tokens de acesso e código de autorização do OAuth 2.0

No nível mais básico, antes que o OAuth 2.0 possa ser usado, o Cliente deve adquirir suas próprias credenciais, uma _id do cliente_ e um _client secret_, do servidor de autorização para se identificar e autenticar ao solicitar um token de acesso. \n\nUsando o OAuth 2.0, as solicitações de acesso são iniciadas pelo Cliente, por exemplo, um aplicativo móvel, site, aplicativo de TV inteligente, aplicativo de desktop, etc. A solicitação, a troca e a resposta do token seguem este fluxo geral:\n\n1. O Cliente solicita autorização (solicitação de autorização) do servidor de Autorização, fornecendo a ID e o segredo do cliente como identificação; ele também fornece os escopos e um URI de endpoint (URI de redirecionamento) para enviar o token de acesso ou o código de autorização.\n\n2. O servidor de Autorização autentica o Cliente e verifica se os escopos solicitados são permitidos. \n\n3. O proprietário do recurso interage com o servidor de autorização para conceder acesso.\n\n4. O servidor de autorização é redirecionado de volta para o cliente com um código de autorização ou token de acesso, dependendo do tipo de concessão, como será explicado na próxima seção. Um token de atualização também pode ser retornado.\n\n5. Com o token de acesso, o cliente solicita acesso ao recurso a partir do servidor de recursos.

Como o OAuth 2.0 funciona?

No OAuth 2.0, **concessões** são o conjunto de etapas que um Cliente deve executar para obter a autorização de acesso a recursos. A estrutura de autorização fornece vários tipos de concessão para abordar diferentes cenários:\n\n- Concessão de [código de autorização](https://auth0.com/docs/api-auth/tutorials/authorization-code-grant): O servidor de autorização retorna um código de autorização de uso único para o cliente, que é trocado por um token de acesso. Esta é a melhor opção para aplicativos da web tradicionais onde a troca pode acontecer com segurança no lado do servidor. O fluxo do código de autorização pode ser usado por aplicativos de página única (SPA) e aplicativos móveis/nativos. No entanto, aqui, o client secret não pode ser armazenado de forma segura e, portanto, a autenticação, durante a troca, é limitada ao uso da _id do cliente_ sozinha. Uma alternativa melhor é a _concessão de código de autorização com PKCE_, abaixo.  \n\n- Concessão [implícita](https://auth0.com/docs/api-auth/tutorials/implicit-grant): Um fluxo simplificado onde o token de acesso é devolvido diretamente para o Cliente. No fluxo implícito, o servidor de autorização pode retornar o token de acesso como um parâmetro no URI de retorno de chamada ou como uma resposta a uma publicação de formulário. A primeira opção agora está obsoleta devido a um possível vazamento de token.\n\n- [Concessão de código de autorização com chave de prova para troca de código (PKCE)](https://auth0.com/docs/flows/concepts/auth-code-pkce): Esse fluxo de autorização é semelhante à concessão de _código de autorização_, mas com etapas adicionais que o tornam mais seguro para aplicativos e SPAs móveis/nativos.\n\n- [Tipo de concessão de credenciais do proprietário de recursos](https://auth0.com/docs/api-auth/tutorials/password-grant): Essa concessão requer que o Cliente primeiro adquira as credenciais do proprietário do recurso, que são passadas para o servidor de Autorização. É, portanto, limitado a Clientes que são completamente confiáveis. Ele tem a vantagem de não envolver nenhum redirecionamento para o servidor de autorização; portanto, é aplicável nos casos de uso em que um redirecionamento é inviável.\n\n- [Tipo de concessão de credenciais do cliente](https://auth0.com/docs/api-auth/tutorials/client-credentials): Usado para aplicações não interativas, como processos automatizados, microsserviços, etc. Neste caso, o aplicativo é autenticado por si mesmo, usando a ID e o client secret.\n\n- [Fluxo de autorização do dispositivo](https://auth0.com/docs/flows/concepts/device-auth): Uma concessão que permite o uso por aplicativos em dispositivos com restrição de entrada, como TVs inteligentes.\n\n- [Concessão de tokens de atualização](https://auth0.com/blog/refresh-tokens-what-are-they-and-when-to-use-them/): O fluxo que envolve a troca de um token de atualização por um novo token de acesso.

Tipos de concessão no OAuth 2.0

Continue lendo a [Introdução ao IAM](https://auth0.com/pt/intro-to-iam/) para conhecer outros tópicos sobre a Gestão de Identidades e Acesso.