Vinculação da autorização à troca do código
O PKCE (Proof Key for Code Exchange) é uma extensão do OAuth 2.0 que exige uma comprovação adicional na troca do código de autorização por tokens. O cliente apresenta um verificador associado à solicitação inicial. Interceptar apenas o código não fornece esse segredo necessário para completar a troca.
O cliente gera um valor aleatório novo para cada solicitação, chamado code_verifier, e envia na etapa inicial um desafio derivado dele, o code_challenge. O servidor associa esse desafio ao código emitido para conferir a troca posterior por tokens. Ao receber o código com o verificador, calcula o desafio novamente e compara os valores. Uma divergência exige a recusa da troca, conforme a RFC 7636.
Como o S256 deriva o desafio
O método S256 aplica SHA-256 à representação ASCII do verificador e codifica o resultado em base64url sem preenchimento final. Assim, a solicitação inicial contém o desafio derivado, sem expor o verificador. O verificador precisa ter de 43 a 128 caracteres permitidos pela especificação e ser gerado com aleatoriedade criptográfica.
A RFC 9700 exige PKCE para clientes públicos no fluxo de código de autorização e recomenda seu uso para clientes confidenciais. Também orienta usar um método que não exponha o verificador na solicitação inicial, condição atendida pelo S256.
Duas janelas de autorização
Num exemplo de teste, você inicia a autorização em duas janelas. Cada tentativa gera seu próprio verificador e precisa preservá-lo até a troca do respectivo código. Quando o código da primeira tentativa é enviado com o verificador da segunda, o desafio calculado difere daquele associado ao código. O servidor deve responder com o erro invalid_grant, mesmo que você tenha autorizado os dois acessos no provedor.
A aplicação precisa associar cada retorno à tentativa correta. Registrar os identificadores das tentativas pode ajudar a investigar a troca de verificadores, mas esses registros não devem expor os segredos. O PKCE também não substitui o transporte seguro nem a autenticação de um cliente confidencial quando ela for exigida.
Dúvidas frequentes
Perguntas frequentes sobre PKCE
- Qual é a diferença entre code_verifier e code_challenge?
- O code_verifier é um segredo aleatório temporário criado pelo cliente. O code_challenge deriva desse valor e acompanha a solicitação inicial. Na troca do código, o servidor recebe o verificador e confere se ele corresponde ao desafio associado.
- O mesmo verificador pode ser usado em todos os acessos?
- Cada solicitação de autorização exige um novo verificador aleatório. Reutilizar um valor fixo permite que a exposição desse único segredo comprometa outras tentativas que usem o mesmo valor.
- O PKCE substitui um client secret?
- O PKCE demonstra a associação entre as duas etapas da autorização. A autenticação de um cliente confidencial continua sendo uma função distinta, quando exigida pelo servidor.
Para continuar
Recursos relacionados
Site de referência
Desenvolvimento Colaborativo da Dev Side Studio
Orientação técnica ao vivo para investigar a associação entre a solicitação de autorização e o verificador usado na troca do código.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O PKCE participa da implementação de autorização OAuth em aplicações web e clientes instalados.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.