Autorização de acesso por tokens
O OAuth 2.0 é um framework de autorização que permite a uma aplicação obter acesso limitado a um serviço HTTP. Numa integração com sua agenda, você pode conceder permissão para consultar compromissos sem fornecer à aplicação a senha usada no provedor.
O servidor de autorização emite um token de acesso com as permissões concedidas. A aplicação apresenta esse token ao chamar o serviço que mantém os recursos, como os eventos da agenda. Esse serviço verifica a autorização para a ação solicitada. A RFC 6749 define os participantes e os fluxos do OAuth 2.0.
Da autorização à consulta da agenda
No fluxo de código de autorização, a aplicação direciona o navegador ao servidor de autorização. Após as verificações e a autorização necessárias, recebe um código no endereço de retorno cadastrado. A aplicação troca esse código por um token e usa a credencial nas chamadas à agenda.
Neste exemplo didático, o provedor oferece um escopo chamado agenda.read, que permite consultar compromissos. O nome foi escolhido para o exemplo, pois cada serviço define seus próprios escopos e o alcance de cada um. A permissão de leitura deve permitir a consulta e levar à recusa de uma tentativa de exclusão.
Você pode comparar as permissões solicitadas com as funções da integração na tela de consentimento. Uma aplicação de consulta que solicita alteração de compromissos exige verificar a necessidade desse acesso. O teste da autorização precisa conferir a recusa da exclusão, além do sucesso da leitura.
Expiração e renovação do acesso
Um token pode expirar ou ser revogado. Quando o servidor emitir um refresh token, a aplicação poderá usá-lo para solicitar outro token de acesso conforme as condições do serviço. Essa possibilidade não significa acesso permanente. As credenciais precisam ficar fora de logs públicos, inclusive quando uma chamada falhar.
A RFC 9700 exige PKCE (Proof Key for Code Exchange) no fluxo de código para clientes públicos, como aplicações que não conseguem manter um segredo de cliente confidencial. O PKCE associa o início da autorização à troca do código, reduzindo o uso indevido de um código interceptado.
Dúvidas frequentes
Perguntas frequentes sobre OAuth
- O OAuth confirma a identidade para fazer login?
- O OAuth 2.0 define autorização de acesso. O OpenID Connect acrescenta um protocolo de autenticação sobre essa base para informar a identidade autenticada à aplicação.
- O que é um escopo no OAuth?
- O escopo identifica uma permissão solicitada ou concedida, como a leitura dos eventos de uma agenda. Cada serviço define seus nomes de escopo e as ações correspondentes, que precisam ser conferidas na documentação da integração.
- Um token permite qualquer ação no serviço?
- O serviço deve verificar o recurso e as permissões associados ao acesso. Um token válido para consultar compromissos não autoriza a exclusão se essa ação estiver fora das permissões concedidas.
Para continuar
Recursos relacionados
Site de referência
Desenvolvimento Colaborativo da Dev Side Studio
Orientação técnica ao vivo para revisar os escopos solicitados e investigar recusas de acesso numa integração OAuth.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O OAuth aparece nas integrações de aplicações com serviços externos que exigem consentimento e permissões delimitadas.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.