Resposta rápida
OAuth 2.0 é o protocolo padrão para autorizar o acesso a APIs sem compartilhar senhas. Em vez de enviar usuário e senha a cada chamada, o sistema obtém um token de acesso com prazo de validade e permissões limitadas. Combinado com OpenID Connect, que confirma a identidade, é a base da autenticação de APIs modernas.
Conceitos principais
- Token de acesso: credencial temporária enviada em cada chamada à API.
- Escopos: o que aquele token pode fazer (ler pedidos, mas não alterá-los, por exemplo).
- Refresh token: permite renovar o acesso sem pedir login de novo.
- JWT: formato comum de token, que carrega informações assinadas digitalmente.
- OpenID Connect: camada sobre o OAuth 2.0 que informa quem é o usuário.
Boas práticas
- Tokens de curta duração, com renovação e possibilidade de revogação.
- Autorização por perfil (RBAC) e pelo menor privilégio necessário.
- Registro de todos os acessos para auditoria.
- Credenciais de sistemas guardadas em cofre, nunca no código.
Perguntas frequentes
API key identifica o sistema que chama, mas costuma ser uma chave fixa, sem prazo e sem limitar o que pode ser feito. OAuth 2.0 traz tokens temporários com permissões específicas, mais adequados quando há dados sensíveis ou pessoais.