Revisar metadados OIDC e gerar valores PKCE

Cole metadados do provedor, não segredos ou tokens de produção. A análise não contata o provedor nem confirma registro do cliente ou redirecionamentos permitidos.

Funciona localmente no seu navegador
Esta página não chama o provedor de identidade. Cole apenas metadados; nunca um client secret de produção, código de autorização ou access token.
Contexto do cliente Valores opcionais tornam a verificação local mais específica.
Metadados de descoberta do OpenID Connect
Valores PKCE Gerado com Web Crypto neste navegador.
Verificador de código
Gere um conjunto PKCE para ver os valores locais.
Desafio de código S256
Gere um conjunto PKCE para ver os valores locais.
Valor state
Gere um conjunto PKCE para ver os valores locais.
Resumo da inspeção
  • Cole o JSON de descoberta do OpenID Connect para inspecioná-lo.

Prepare um login mais seguro para clientes públicos

Use Authorization Code com PKCE em clientes web e móveis. Este verificador local não confirma o registro no provedor, listas permitidas de redirect URI, política de consentimento nem o comportamento real dos tokens.

Como revisar metadados de descoberta OIDC e gerar valores PKCE

Cole o JSON retornado por /.well-known/openid-configuration, clique em Inspecionar configuração OIDC e leia os achados: a página nomeia os campos dos quais um cliente público com Authorization Code depende e separa problemas bloqueantes de pontos a revisar. Os campos de client ID e redirect URI são opcionais e apenas tornam essa revisão local mais específica.

O botão PKCE sorteia 48 bytes aleatórios, resume com SHA-256 e mostra o verificador de código, o desafio S256 e um valor state. Tudo roda nesta aba pela API Web Crypto; os metadados colados não são enviados ao VoriTools nem ao provedor de identidade.

  1. Copie o JSON do documento de descoberta do provedor, por exemplo https://login.example.com/.well-known/openid-configuration, e cole no campo de metadados. Clique em Carregar exemplo para ver antes o formato esperado.
  2. Informe o client ID e o redirect URI que você registrou quando quiser que a revisão local também os confira. Os dois campos são opcionais; vazios, o documento do provedor continua sendo verificado.
  3. Clique em Inspecionar configuração OIDC. Primeiro vêm os campos e URLs obrigatórios, depois os tipos de resposta, os tipos de concessão, os métodos PKCE e o JWKS URI, cada achado com o caminho do metadado que o gerou.
  4. Resolva os achados bloqueantes antes de integrar: endpoint ausente, PKCE anunciado só com plain ou redirect http em produção são os que quebram o fluxo. Os pontos a revisar merecem leitura, mas não impedem um teste.
  5. Clique em Gerar conjunto PKCE, copie os valores com Copiar valores PKCE, mantenha o verificador no cliente até a requisição de token e clique em Limpar antes de colar o próximo provedor.

O que o documento de descoberta declara e o que são os valores PKCE

O que o documento de descoberta precisa declarar

O inspetor lê os campos dos quais um cliente de navegador ou celular depende: issuer, authorization_endpoint e token_endpoint precisam ser URLs absolutas — HTTPS em produção e HTTP apenas em endereços de loopback — e jwks_uri precisa ser anunciado para que as assinaturas dos tokens possam ser verificadas. response_types_supported precisa incluir code e grant_types_supported precisa incluir authorization_code para o fluxo Authorization Code.

O campo de maior peso em um cliente público é code_challenge_methods_supported. Sem PKCE, um código de autorização capturado no celular ou por um esquema de URL próprio pode ser trocado por quem o interceptou; por isso um anúncio que só oferece plain, ou que omite o campo, é tratado aqui como bloqueante, e não como aviso.

Como os valores PKCE são gerados

Gerar conjunto PKCE pega 48 bytes aleatórios de crypto.getRandomValues, codifica em base64url e mostra o verificador de 64 caracteres. O desafio S256 é o base64url do resumo SHA-256 desse verificador — 43 caracteres — e o valor state são 24 bytes aleatórios, 32 caracteres, para comparar quando o provedor devolver o redirect com o código.

Use S256: o desafio vai na requisição de autorização, o verificador fica no cliente até a requisição de token, e um código capturado no meio não pode ser trocado. O método plain envia o próprio verificador na URL; por isso um documento que só aceita plain encerra esta inspeção com um achado bloqueante.

O que esta página não confirma

O documento é lido exatamente como foi colado. A página não sabe se o provedor registrou o seu cliente, se o redirect URI está na lista permitida, qual tela de consentimento o usuário vê nem se os endpoints se comportam como anunciam; isso exige uma requisição de autorização real contra o provedor.

Um resultado sem achados significa que os metadados copiados são coerentes para um cliente público, não que a integração funcione. Fluxos reais, validade dos tokens e renovação ainda precisam ser testados no provedor, e a checagem do redirect URI aqui é apenas um lembrete local de correspondência exata.

Ferramentas recentes: