Fluxo OIDC de referência

Diagrama educacional do fluxo Authorization Code + PKCE (OAuth 2.1) para aplicações que integram o pacote licenciado Área 51.

Nota de fidelidade: este diagrama modela a integração OIDC do cliente licenciado (app protegida + IdP). A loja pública em area51.caracore.com.br é vitrine institucional — não executa checkout OIDC nem entrega o pacote por download directo.

Sequência lab / homologação

Recurso protegidoProvedor deidentidadeApp protegida(RP)Recurso protegidoProvedor deidentidadeApp protegida(RP)Gera code_verifiere code_challengePKCE S256Gerastate paraproteção CSRFValida staterecebidoPKCE validado na troca —preferir back-end ou BFFValida JWTassinatura expaudiência eescoposUtilizadorAcede a rota /protected1Redirect /authorize com PKCEe state2Tela de login3Credenciais4Redirect com AuthorizationCode e state5POST /token com code ecode_verifier6ID Token e Access Token7Pedido com Bearer Access Token8Recurso autorizado9Sessão autenticada10Utilizador
Recurso protegidoProvedor deidentidadeApp protegida(RP)Recurso protegidoProvedor deidentidadeApp protegida(RP)Gera code_verifiere code_challengePKCE S256Gerastate paraproteção CSRFValida staterecebidoPKCE validado na troca —preferir back-end ou BFFValida JWTassinatura expaudiência eescoposUtilizadorAcede a rota /protected1Redirect /authorize com PKCEe state2Tela de login3Credenciais4Redirect com AuthorizationCode e state5POST /token com code ecode_verifier6ID Token e Access Token7Pedido com Bearer Access Token8Recurso autorizado9Sessão autenticada10Utilizador

Passos resumidos

  1. 1 — Intenção: o utilizador acede a uma rota protegida da aplicação cliente.
  2. 2 — PKCE: a RP gera par verifier/challenge antes do redirect (sem client secret no browser).
  3. 3 — Login: o IdP autentica e devolve um authorization code de uso único.
  4. 4 — Tokens: a RP troca o code por tokens; o IdP valida PKCE na troca.
  5. 5 — Acesso: a API ou rota protegida valida o access token antes de servir o recurso.

Ver também: fronteiras e segurança · o que recebe na entrega · apresentação técnica.