Docs Italia beta

Documenti pubblici, digitali.

Flusso di autenticazione

Gli schemi di autenticazioni "Entra con SPID" e "Entra con CIE" implementano il flusso OpenID Connect Authorization Code Flow con l'estensione PKCE (Proof Key for Code Exchange, RFC 7636). Questo flusso restituisce un Authorization Code che può essere utilizzato per ottenere un ID Token e un Access Token e se possibile anche un Refresh Token. L'Authorization Code Flow ottiene l'Authorization Code dall'Authorization Endpoint dell'OpenID Provider e tutti i token sono restituiti dal Token Endpoint.

_images/flusso.svg

Segue la descrizione dei passaggi, come da numerazione indicata in figura.

  1. L'Utente, nella pagina di accesso del Relying Party (RP):

    • Seleziona il pulsante "Entra con SPID" o "Entra con CIE";

    • Nel caso SPID, seleziona l'OP con cui autenticarsi.

  2. Il RP prepara una Richiesta di Autorizzazione con i parametri necessari previsti da PKCE e la invia all'Authorization Endpoint dell'OP.

  3. L'OP autentica l'utente mediante l'inserimento delle credenziali e ottiene il consenso per l'accesso agli attributi dell'utente da parte del RP.

  4. L'OP reindirizza l'utente all'URL contenuto nel parametro redirect_uri specificato dal RP, passando un Authorization Code nell'Authorization Response.

  5. Il RP invia l'Authorization Code ricevuto al Token Endpoint dell'OP.

  6. Il Token Endpoint dell'OP rilascia un ID Token, un Access Token e se previsto un Refresh Token.

  7. Il RP riceve e valida l'Access Token e l'ID Token. Per chiedere gli attributi che erano stati autorizzati dall'utente al punto 3, invia una richiesta all'UserInfo Endpoint dell'OP utilizzando l'Access Token per l'autenticazione all'interno della intestazione HTTP Authorization.

  8. Lo UserInfo Endpoint dell'OP verifica la validità dell'Access Token e rilascia gli attributi richiesti al RP.