Digite para filtrar os verbetes do Glossário.

    Redes e segurança · Vibe Coding: Do Zero ao MVP

    O que é PKCE?

    O PKCE associa um código de autorização ao verificador criado pelo cliente. Na troca por tokens, o servidor confere esse valor contra o desafio inicial.

    Também chamado de: Proof Key for Code Exchange, OAuth PKCE

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano