Autenticação por um provedor de identidade
O OIDC (OpenID Connect) é um protocolo que permite a uma aplicação verificar a identidade autenticada por um provedor de identidade. Ele acrescenta ao OAuth 2.0 uma camada própria para autenticação, com um ID Token que comunica à aplicação o resultado desse processo.
No fluxo de código de autorização, a aplicação direciona o navegador ao provedor com o escopo openid. Após a autenticação e a autorização necessárias, recebe um código no endereço de retorno cadastrado. A troca desse código no servidor de autorização fornece o ID Token. Outros escopos podem solicitar atributos do perfil, sujeitos à autorização concedida.
O que conferir no ID Token
A validação precisa confirmar que o token veio do emissor esperado, comparando o campo iss com o provedor configurado na aplicação. O campo aud precisa incluir o identificador da aplicação, chamado client_id, pois um token destinado a outro cliente não autentica este acesso. A validade temporal e as verificações criptográficas aplicáveis também fazem parte da validação definida no OpenID Connect Core.
Abrir o conteúdo do token para ler seus campos não confirma sua autenticidade. Você precisa usar uma implementação que execute as verificações do protocolo, inclusive a comparação do nonce quando esse valor tiver acompanhado a solicitação.
Entrada num painel da empresa
Como exemplo de integração, um painel associa o par iss e sub de um token validado ao cadastro local. O iss identifica o provedor e o sub, chamado subject, identifica o usuário dentro daquele emissor. A especificação define esse par como identificação estável, ao contrário do email, que pode mudar.
O cadastro encontrado pode entrar no painel e ainda não ter acesso ao relatório financeiro. A aplicação consulta suas permissões locais para autorizar essa ação. Num teste com dois cadastros autenticados pelo mesmo provedor, somente o cadastro com a permissão correspondente deve conseguir abrir o relatório.
Dúvidas frequentes
Perguntas frequentes sobre OIDC
- Qual é a função do escopo openid?
- O escopo openid identifica uma solicitação de autenticação pelo OpenID Connect. Outros escopos podem solicitar atributos adicionais do perfil, conforme a configuração e o consentimento.
- O ID Token substitui o token de acesso?
- O ID Token comunica à aplicação cliente o resultado da autenticação. O token de acesso é apresentado ao serviço para usar os recursos autorizados. Uma integração precisa respeitar a finalidade de cada token e as verificações do destinatário.
- O email deve identificar o cadastro local?
- A aplicação deve usar o par iss e sub do token validado como identificação estável do usuário no provedor. O email pode mudar ou coincidir entre perfis, portanto não deve ser usado isoladamente para vincular cadastros.
Para continuar
Recursos relacionados
Site de referência
Desenvolvimento Colaborativo da Dev Side Studio
Orientação técnica ao vivo para revisar a validação do ID Token e a associação da identidade ao cadastro da aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O OpenID Connect participa da autenticação de aplicações que usam um provedor externo de identidade.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.