# Linee Guida OpenID Connect in SPID

**URL:** https://forum.italia.it/c/documenti-in-consultazione/linee-guida-openid-connect-in-spid/65.md

[Più recenti](https://forum.italia.it/latest.md) · [Categorie](https://forum.italia.it/categories.md)

---

## [Definizione della categoria Linee Guida OpenID Connect in SPID](https://forum.italia.it/t/definizione-della-categoria-linee-guida-openid-connect-in-spid/10904)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 9:41am UTC](https://forum.italia.it/t/definizione-della-categoria-linee-guida-openid-connect-in-spid/10904 "2019-08-27T09:41:04Z")

</div>

La consultazione pubblica è attiva dal 27 agosto al 26 settembre 2019 . Questa categoria raccoglie i commenti al testo delle Linee Guida OpenID Connect in SPID, disponibile per la consultazione pubblica.

---

## [1.1. Scopo](https://forum.italia.it/t/1-1-scopo/10909)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:37am UTC](https://forum.italia.it/t/1-1-scopo/10909 "2019-08-27T11:37:58Z")

</div>

Le Linee Guida vengono emesse ai sensi dell’articolo 71 del decreto legislativo 7 marzo 2005, n. 82 e successive modifiche e integrazioni (di seguito CAD) e della Determinazione AgID n. 160 del 2018 recante «Regolamento …

---

## [1.2. Gruppo di lavoro](https://forum.italia.it/t/1-2-gruppo-di-lavoro/10910)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:39am UTC](https://forum.italia.it/t/1-2-gruppo-di-lavoro/10910 "2019-08-27T11:39:15Z")

</div>

La redazione del documento è stata curata dal gruppo di lavoro composto da: Agenzia per l’Italia Digitale; Agenzia delle Entrate; Aruba S.p.A.; Continua a leggere su Docs Italia.

---

## [2.1. Riferimenti Normativi](https://forum.italia.it/t/2-1-riferimenti-normativi/10911)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:39am UTC](https://forum.italia.it/t/2-1-riferimenti-normativi/10911 "2019-08-27T11:39:51Z")

</div>

\[Reg. UE n.910/2014\] Regolamento (UE) n. 910/2014 del 23 luglio 2014 in materia di identificazione elettronica e servizi fiduciari per le transazioni elettroniche nel mercato interno e che abroga la direttiva 1999/93/CE…

---

## [2.2. Standard di riferimento](https://forum.italia.it/t/2-2-standard-di-riferimento/10912)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 2\
**Ultimo aggiornamento:** [26 Settembre 2019, 12:51pm UTC](https://forum.italia.it/t/2-2-standard-di-riferimento/10912 "2019-09-26T12:51:27Z")

</div>

SPID OpenID Connect è basato sul profilo iGov (openid-gov-profile) di OpenID Connect, International Government Assurance Profile (iGov) for OpenID Connect 1.0 , con la seguente personalizzazione: paragrafo 4,2 di open…

---

## [2.3. Termini e definizioni](https://forum.italia.it/t/2-3-termini-e-definizioni/10913)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [26 Settembre 2019, 12:50pm UTC](https://forum.italia.it/t/2-3-termini-e-definizioni/10913 "2019-09-26T12:50:04Z")

</div>

Essendo le funzionalità simili, ritroviamo gli stessi concetti di SAML 2.0 anche in OpenID Connect. Continua a leggere su Docs Italia.

---

## [3. Metadata](https://forum.italia.it/t/3-metadata/10914)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 2\
**Ultimo aggiornamento:** [15 Novembre 2019, 1:41pm UTC](https://forum.italia.it/t/3-metadata/10914 "2019-11-15T13:41:21Z")

</div>

I metadata sono strutture dati contenenti le informazioni di OpenID Provider (OP) e di Relying Party (RP), mantenute e distribuite dal Registry SPID a tutti i soggetti della federazione, secondo le modalità definite dall…

---

## [3.1. OpenID Provider (OP) Metadata](https://forum.italia.it/t/3-1-openid-provider-op-metadata/10915)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 2\
**Ultimo aggiornamento:** [14 Novembre 2019, 10:49pm UTC](https://forum.italia.it/t/3-1-openid-provider-op-metadata/10915 "2019-11-14T22:49:39Z")

</div>

Il formato del metadata deriva da quanto specificato nel documento «OpenID Connect Discovery 1.0» , del quale costituisce un sottoinsieme con alcuni campi in aggiunta. Continua a leggere su Docs Italia.

---

## [3.2. Client Metadata (Relying Party Metadata)](https://forum.italia.it/t/3-2-client-metadata-relying-party-metadata/10916)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 4\
**Ultimo aggiornamento:** [6 Novembre 2019, 9:15am UTC](https://forum.italia.it/t/3-2-client-metadata-relying-party-metadata/10916 "2019-11-06T09:15:13Z")

</div>

Il formato del metadata deriva da quanto specificato nel documento «OpenID Connect Discovery 1.0» , del quale costituisce un sottoinsieme con alcuni campi in aggiunta. Continua a leggere su Docs Italia.

---

## [4. Flusso](https://forum.italia.it/t/4-flusso/10917)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [25 Settembre 2019, 8:29pm UTC](https://forum.italia.it/t/4-flusso/10917 "2019-09-25T20:29:55Z")

</div>

Il modello di flusso è l’ « OpenID Connect Authorization Code Flow » che è infatti l’unico flusso previsto da iGov. L’Authorization code flow restituisce un codice di autorizzazione che può essere scambiato per un ID to…

---

## [4.1. Applicazioni per dispositivi mobili](https://forum.italia.it/t/4-1-applicazioni-per-dispositivi-mobili/10918)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:44am UTC](https://forum.italia.it/t/4-1-applicazioni-per-dispositivi-mobili/10918 "2019-08-27T11:44:00Z")

</div>

Nel caso di applicazioni mobili rimane il requisito di seguire l’Authorization Code Flow descritto sopra. In tale contesto, nel diagramma di cui al paragrafo precedente, l’elemento identificato come Relying Party sta ad…

---

## [5. Authorization Endpoint (Authentication Request)](https://forum.italia.it/t/5-authorization-endpoint-authentication-request/10919)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 5\
**Ultimo aggiornamento:** [6 Novembre 2019, 2:07pm UTC](https://forum.italia.it/t/5-authorization-endpoint-authentication-request/10919 "2019-11-06T14:07:29Z")

</div>

Per avviare il processo di autenticazione, il RP manda l’utente all’Authorization Endpoint dell’OP selezionato passando in POST o GET una richiesta in formato JWT. Tale richiesta DEVE essere firmata e cifrata, secondo l…

---

## [5.1. Claims](https://forum.italia.it/t/5-1-claims/10920)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [25 Settembre 2019, 8:30pm UTC](https://forum.italia.it/t/5-1-claims/10920 "2019-09-25T20:30:42Z")

</div>

Il parametro claims definisce gli attributi e il livello SPID richiesti. all’interno dell’elemento « userinfo » si elencano gli attributi, da richiedere come chiavi di oggetti JSON, i cui valori devono essere null . Gli…

---

## [5.2. Generazione del code\_challenge per PKCE](https://forum.italia.it/t/5-2-generazione-del-code-challenge-per-pkce/10921)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:45am UTC](https://forum.italia.it/t/5-2-generazione-del-code-challenge-per-pkce/10921 "2019-08-27T11:45:59Z")

</div>

PKCE (Proof Key for Code Exchange, RFC7636) è un’estensione del protocollo OAuth 2.0 finalizzata ad evitare un potenziale attacco attuato con l’intercettazione dell’authorization code, soprattutto nel caso di applicazion…

---

## [6. Authentication response](https://forum.italia.it/t/6-authentication-response/10922)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [26 Settembre 2019, 12:28pm UTC](https://forum.italia.it/t/6-authentication-response/10922 "2019-09-26T12:28:15Z")

</div>

Un’Authentication response è un messaggio di risposta di autorizzazione OAuth 2.0 restituito dall’authorization endpoint dell’OpenID Provider (OP) al termine del flusso di autenticazione. L’OP reindirizzerà l’utente al r…

---

## [6.1. Response](https://forum.italia.it/t/6-1-response/10923)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [26 Settembre 2019, 12:35pm UTC](https://forum.italia.it/t/6-1-response/10923 "2019-09-26T12:35:12Z")

</div>

Se l’autenticazione è avvenuta con successo, l’OpenID Provider (OP) Authorization server, reindizza l’utente con i seguenti parametri. Continua a leggere su Docs Italia.

---

## [6.2. Errori](https://forum.italia.it/t/6-2-errori/10924)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:47am UTC](https://forum.italia.it/t/6-2-errori/10924 "2019-08-27T11:47:45Z")

</div>

In caso di errore, l’OP visualizza i messaggi definiti dalle Linee Guida UX SPID. Nei casi in cui tali linee guida prescrivono un redirect dell’utente verso il RP, l’OP effettua il redirect verso l’URL indicata nel param…

---

## [7. Token Endpoint (richiesta token)](https://forum.italia.it/t/7-token-endpoint-richiesta-token/10925)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:48am UTC](https://forum.italia.it/t/7-token-endpoint-richiesta-token/10925 "2019-08-27T11:48:26Z")

</div>

Il Token Endpoint rilascia access token , ID Token e refresh token , vi sono due scenari distinti in cui il client chiama il Token Endpoint: al termine del flusso di autenticazione descritto nel paragrafo precedent…

---

## [7.1. Request](https://forum.italia.it/t/7-1-request/10926)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 3\
**Ultimo aggiornamento:** [6 Novembre 2019, 2:24pm UTC](https://forum.italia.it/t/7-1-request/10926 "2019-11-06T14:24:41Z")

</div>

Esempio di richiesta con authorization code (caso 1) Continua a leggere su Docs Italia.

---

## [7.2. Response](https://forum.italia.it/t/7-2-response/10927)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [25 Settembre 2019, 8:31pm UTC](https://forum.italia.it/t/7-2-response/10927 "2019-09-25T20:31:18Z")

</div>

Dopo avere ricevuto e validato la Token request dal client, il Token endpoint dell’OpenID Provider (OP) restituisce una response che include ID Token e Access Token e un eventuale Refresh Token, in formato JWT e firmati …

---

## [7.3. ID Token](https://forum.italia.it/t/7-3-id-token/10928)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [25 Settembre 2019, 8:33pm UTC](https://forum.italia.it/t/7-3-id-token/10928 "2019-09-25T20:33:39Z")

</div>

L’ID Token è un JSON Web Token (JWT) che contiene informazioni sull’utente che ha eseguito l’autenticazione. I Client devono eseguire la validazione dell’ID Token. Continua a leggere su Docs Italia.

---

## [7.4. Errori](https://forum.italia.it/t/7-4-errori/10929)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [16 Settembre 2019, 6:59am UTC](https://forum.italia.it/t/7-4-errori/10929 "2019-09-16T06:59:47Z")

</div>

In caso di errore, l’OP restituisce un codice HTTP 401 con un JSON nel body avente gli elementi di seguito indicati. Continua a leggere su Docs Italia.

---

## [8. UserInfo Endpoint (attributi)](https://forum.italia.it/t/8-userinfo-endpoint-attributi/10930)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:51am UTC](https://forum.italia.it/t/8-userinfo-endpoint-attributi/10930 "2019-08-27T11:51:33Z")

</div>

Lo UserInfo Endpoint è una risorsa protetta OAuth 2.0 che restituisce attributi dell’utente autenticato. Per ottenere gli attributi richiesti dal Relying Party, il client inoltra una richiesta allo UserInfo endpoint util…

---

## [8.1. Response](https://forum.italia.it/t/8-1-response/10931)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [25 Settembre 2019, 8:37pm UTC](https://forum.italia.it/t/8-1-response/10931 "2019-09-25T20:37:32Z")

</div>

La response dello UserInfo Endpoint deve essere firmata e cifrata secondo le modalità definite dall’Agenzia per l’Italia Digitale. Lo UserInfo Endpoint restituisce i claim autorizzati nella Authentication Request. Conti…

---

## [9. Introspection Endpoint (verifica validità token)](https://forum.italia.it/t/9-introspection-endpoint-verifica-validita-token/10932)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [20 Novembre 2019, 2:12pm UTC](https://forum.italia.it/t/9-introspection-endpoint-verifica-validita-token/10932 "2019-11-20T14:12:44Z")

</div>

L’Introspection Endpoint esposto dall’OP consente ai RP di ottenere informazioni su un token in loro possesso, come ad esempio la sua validità. Continua a leggere su Docs Italia.

---

## [9.1. Request](https://forum.italia.it/t/9-1-request/10933)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:53am UTC](https://forum.italia.it/t/9-1-request/10933 "2019-08-27T11:53:09Z")

</div>

La richiesta all’Introspection Endpoint consiste nell’invio del token su cui si vogliono ottenere informazioni unitamente ad una Client Assertion che consente di identificare il RP che esegue la richiesta. Continua a le…

---

## [9.2. Response](https://forum.italia.it/t/9-2-response/10934)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:53am UTC](https://forum.italia.it/t/9-2-response/10934 "2019-08-27T11:53:50Z")

</div>

L’Introspection Endpoint risponde con un oggetto JSON definito come segue. Continua a leggere su Docs Italia.

---

## [9.3. Errori](https://forum.italia.it/t/9-3-errori/10935)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:54am UTC](https://forum.italia.it/t/9-3-errori/10935 "2019-08-27T11:54:21Z")

</div>

In caso di errore, l’OP restituisce un codice HTTP 401 con un JSON nel body avente gli elementi di seguito indicati. Continua a leggere su Docs Italia.

---

## [10. Revocation Endpoint (logout)](https://forum.italia.it/t/10-revocation-endpoint-logout/10936)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 1\
**Ultimo aggiornamento:** [20 Novembre 2019, 2:58am UTC](https://forum.italia.it/t/10-revocation-endpoint-logout/10936 "2019-11-20T02:58:52Z")

</div>

Il Revocation Endpoint consente al RP di chiedere la revoca di un access token o di un refresh token in suo possesso. Quando l’utente esegue il logout, o quando la sua sessione presso il RP scade (in base alle polic…

---

## [10.1. Request](https://forum.italia.it/t/10-1-request/10937)

<div class="topic-metadata">

**Author:** [@docs-italia](https://forum.italia.it/u/docs-italia)\
**Risposte:** 0\
**Ultimo aggiornamento:** [27 Agosto 2019, 11:55am UTC](https://forum.italia.it/t/10-1-request/10937 "2019-08-27T11:55:49Z")

</div>

La richiesta al Revocation Endpoint consiste nell’invio del token che si vuole revocare unitamente ad una Client Assertion che consente di identificare il RP che esegue la richiesta. Continua a leggere su Docs Italia.

[Pagina seguente](https://forum.italia.it/c/documenti-in-consultazione/linee-guida-openid-connect-in-spid/65.md?page=1)
