# Federazione CIE errore sub

**URL:** <https://forum.italia.it/t/federazione-cie-errore-sub/49181>\
**Category:** CIE\
**Created:** [25 Settembre 2026, 12:02pm UTC](https://forum.italia.it/t/federazione-cie-errore-sub/49181 "2026-09-25T12:02:18Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Edp\_Alma](https://forum.italia.it/user_avatar/forum.italia.it/edp_alma/32/16126_2.png) [@Edp\_Alma](https://forum.italia.it/u/Edp_Alma)\
**Post date:** [25 Settembre 2026, 12:02pm UTC](https://forum.italia.it/t/federazione-cie-errore-sub/49181/1 "2026-09-25T12:02:18Z")

</div>

Buongiorno,  
sto sviluppando con la libreria [GitHub - italia/spid-cie-oidc-java: The SPID/CIE OIDC Federation Relying Party, written in Java · GitHub](https://github.com/italia/spid-cie-oidc-java) l’accesso CIE per la mia azienda.

Sto tentando di creare una componente tecnica per la federazione CIE con queste caratteristiche

- OIDC
- pre-produzione

ma non riesco ad inserire una “Chiave pubblica di federazione” che vada bene e ricevo sempre l’errore:

> La validazione non è andata a buon fine per i seguenti motivi:
> 
> [sub] Elemento mancante
> 
> Verifica la sintassi e inseriscilo di nuovo.

Ho alcuni dubbi:  
a fronte di un file generato dalla libreeia spid-cie-oidc-java in questo modo

> {  
> “sub”: “[https://mio-url-dev](https://mio-url-dev)”,  
> “metadata”: {  
> “federation\_entity”: {  
> “contacts”: [  
> ]  
> },  
> “openid\_relying\_party”: {  
> “client\_registration\_types”: [  
> “automatic”  
> ],  
> “jwks”: {  
> “keys”: [  
> {  
> “kty”: “RSA”,  
> “e”: “AQAB”,  
> “alg”: “RS256”,  
> “use”: “sig”,  
> “n”: “:bbbbb…”,  
> “kid”: “xxxxx”  
> },  
> {  
> “kty”: “RSA”,  
> “e”: “AQAB”,  
> “alg”: “RSA-OAEP-256”,  
> “use”: “enc”,  
> “n”: “aaaa…”,  
> “kid”: “yyyy”  
> }  
> ]  
> },  
> “grant\_types”: [  
> “refresh\_token”,  
> “authorization\_code”  
> ],  
> “application\_type”: “web”,  
> “redirect\_uris”: [  
> “[https://mio-url-dev/CIECallbackAction.action](https://mio-url-dev/CIECallbackAction.action)”  
> ],  
> “client\_name”: “MioNome”,  
> “client\_id”: “[https://mio-url-dev](https://mio-url-dev)”,  
> “contacts”: [  
> ],  
> “response\_types”: [  
> “code”  
> ]  
> }  
> },  
> “jwks”: {  
> “keys”: [  
> {  
> “kty”: “RSA”,  
> “e”: “AQAB”,  
> “alg”: “RS256”,  
> “use”: “sig”,  
> “n”: “cccc…”,  
> “kid”: “zzzzz”  
> }  
> ]  
> },  
> “iss”: “[https://mio-url-dev](https://mio-url-dev)”,  
> “authority\_hints”: [  
> “[https://preprod.oidc.registry.servizicie.interno.gov.it](https://preprod.oidc.registry.servizicie.interno.gov.it)”  
> ],  
> “exp”: 1790345252,  
> “iat”: 1790343452  
> }

cosa devo inserire nel campo “Chiave pubblica di federazione” ? Tutto il json o solo una parte?

Inoltre, la stringa incollata nella pagina di onboarding deve essere in chiaro o no?

infine l’indirizzi del client\_id è un webserver presente sul mio PC di sviluppo, non raggiungibile dall’esterno: può essere questo il problema?

Grazie.

---

<div class="post-metadata">

**Author:** ![madbob](https://forum.italia.it/user_avatar/forum.italia.it/madbob/32/223_2.png) [@madbob](https://forum.italia.it/u/madbob)\
**Post date:** [29 Settembre 2026, 9:25am UTC](https://forum.italia.it/t/federazione-cie-errore-sub/49181/2 "2026-09-29T09:25:53Z")

</div>

> [@Edp\_Alma](#):
>
> infine l’indirizzi del client\_id è un webserver presente sul mio PC di sviluppo, non raggiungibile dall’esterno: può essere questo il problema?

A prescindere da qualsiasi altro contenuto o errore: l’istanza deve essere raggiungibile dal portale, che all’atto della registrazione tenta di accedere al tuo file `/.well-known/openid-federation` per validarlo.

---

<div class="post-metadata">

**Author:** ![Edp\_Alma](https://forum.italia.it/user_avatar/forum.italia.it/edp_alma/32/16126_2.png) [@Edp\_Alma](https://forum.italia.it/u/Edp_Alma)\
**Post date:** [30 Settembre 2026, 7:49am UTC](https://forum.italia.it/t/federazione-cie-errore-sub/49181/3 "2026-09-30T07:49:37Z")

</div>

Grazie per il chiarimento,  
il mio problema comunque persiste anche dopo aver fatto un test con un client\_id pubblico accessibile dall’esterno.

Qualcuno ha avuto il mio stesso problema ed è riuscito a risolverlo?

Grazie

---

<div class="post-metadata">

**Author:** ![Mirkochip](https://forum.italia.it/user_avatar/forum.italia.it/mirkochip/32/16056_2.png) [@Mirkochip](https://forum.italia.it/u/Mirkochip)\
**Post date:** [1 Ottobre 2026, 11:57am UTC](https://forum.italia.it/t/federazione-cie-errore-sub/49181/4 "2026-10-01T11:57:19Z")

</div>

Ciao, abbiamo federato un RP CIE OIDC e verificato il formato sul portale.

1. Cosa incollare in “Chiave pubblica di federazione”  
Non va incollata tutta l’Entity Configuration, ma un JWKS con la sola chiave di federazione (il jwks di primo livello, quello che firma l’Entity Configuration, non openid\_relying\_party.jwks). Il testo va in chiaro, JSON puro, senza base64 e non come JWT, e con la sola parte pubblica:

{  
“keys”: [  
{  
“kty”: “RSA”,  
“kid”: “…”,  
“e”: “AQAB”,  
“n”: “…”  
}  
]  
}

alg e use non servono. Il kid deve coincidere con quello nell’header del JWT servito su n. Probabilmente [sub] Elemento mancante compare quando il validatore non riconosce la  
{  
“kty”: “RSA”,  
“kid”: “…”,  
“e”: “AQAB”,  
“n”: “…”  
}  
]  
}

alg e use non servono. Il kid deve coincidere con quello nell’header del JWT servito su /.well-known/openid-federation. Probabilmente [sub] Elemento mancante compare quando il validatore non riconosce la struttura, per esempio se si incolla l’intero documento o una chiave singola senza l’array keys.

1. Altri punti da controllare

- Cifratura: il portale accetta RSA-OAEP + A256CBC-HS512. A noi RSA-OAEP-256 è stato rifiutato.
- contacts: in federation\_entity non può essere vuoto e deve contenere la PEC dell’ente/impresa
- authority\_hints: deve essere il Trust Anchor dell’ambiente scelto, non l’OP. Conviene verificare l’URL di preproduzione nella documentazione del portale.
- Entity ID: deve coincidere esattamente con iss/sub. L’URL \<entity\_id\>/.well-known/openid-federation deve essere raggiungibile pubblicamente in HTTPS e restituire il JWT firmato (application/entity-statement+jwt).

1. Riferimento  
Il nostro proxy è open source (EUPL-1.2): [GitHub - Provincia-di-Pescara/pa-sso-proxy: SPID/CIE SSO proxy per Pubblica Amministrazione — SATOSA-based, multi-client OIDC, WebUI di configurazione · GitHub](https://github.com/Provincia-di-Pescara/pa-sso-proxy)  
È pensato per la Pubblica Amministrazione: per SPID non è adatto a un’impresa, perché il metadata SAML e il certificato sono generati con il profilo da SP pubblico (IPACode, spid:Public, PA:IT-). Puoi però consultare il sorgente come esempio per la parte CIE OIDC Federation, che non ha vincoli specifici della PA:

- config-api/app/satosa\_config\_generator.py: metadata federation\_entity e openid\_relying\_party;
- config-api/app/jwk\_generator.py: chiavi federation/sig/enc e formato da incollare nel portale;
- satosa/plugins/cieoidc-backend/: backend RP CIE OIDC (Entity Configuration, trust chain, callback).

---

<div class="post-metadata">

**Author:** ![Edp\_Alma](https://forum.italia.it/user_avatar/forum.italia.it/edp_alma/32/16126_2.png) [@Edp\_Alma](https://forum.italia.it/u/Edp_Alma)\
**Post date:** [2 Ottobre 2026, 9:21am UTC](https://forum.italia.it/t/federazione-cie-errore-sub/49181/5 "2026-10-02T09:21:33Z")

</div>

Buongiorno,  
finalmente sono riuscito a eseguire l’onboarding per la federazione CIE come _Relying Party_ e sviluppando in Java con la libreria [GitHub - italia/spid-cie-oidc-java: The SPID/CIE OIDC Federation Relying Party, written in Java · GitHub](https://github.com/italia/spid-cie-oidc-java) .

Premessa:  
ho incontrato tre grossi problemi riguardanti tutta la gestione del progetto da parte del team di sviluppo:

- l’assistenza ufficiale CIE contattata attraverso [cie.enti@interno.it](mailto:cie.enti%40interno.it) non mi è stata di aiuto, ho sempre ricevuto risposte frettolose, parziali, poco chiare e assolutamente non risolutive.
- **la pagina di onboarding gestisce in maniera terribile gli errori** riguardanti l’inserimento dei dati, in particolare nell’inserimento della _Chiave pubblica di federazione:_ vengono restituiti pochi errori generici che non aiutano assolutamente a capire cosa non va nelle stringhe inserite (i fantomatici _“[sub] Elemento mancante”_ e _“L’entità non rispetta i requisiti di federazione”_).  
In pratica dà errore _[sub] Elemento mancante_ sia se la _Chiave pubblica di federazione_ non è corretta, sia se l’EC servito alla pagina _.well-known/openid-federation_ non è accessibile o non è corretto, anche se in realtà l’elemento _sub_ è presente.
- La documentazione sull’onboarding è inesistente:
  - per l’inserimento della _Chiave pubblica di federazione_, non è chiaro cosa vada inserito e non c’è un semplice esempio ufficiale, o se c’è non è facile da trovare, visto che nessuno me lo ha indicato: sarebbe molto semplice metterne un template nel pulsante informativo a fianco del campo da compilare
  - non viene detto da nessuna parte che durante l’onboarding l’EC deve essere accessibile su indirizzo pubblico https non in chiaro (ci si può arrivare, ma scriverlo esplicitamente cosa costa?)

- non vengono indicati tool di validazione che in realtà esistono
- non vengono indicate repository con progetti relativi a diversi ambienti di sviluppo (ci ho messo un bel po’ a trovare il progetto OIDC che utilizza java [GitHub - italia/spid-cie-oidc-java: The SPID/CIE OIDC Federation Relying Party, written in Java · GitHub](https://github.com/italia/spid-cie-oidc-java))

Mi spiace farlo presente qui ma se qualche responsabile del progetto legge questo post deve essere a conoscenza di queste problematiche che rallentano enormente lo sviluppo dei progetti.

Vi riassumo come ho risolto le varie problematiche.

**OnBoarding**

- _Identificativo componente_:
  - deve essere un _i_ **ndirizzo pubblico in HTTPS** , accessibile durante il processo di onboarding;
  - deve servire l’Entity Configuration con questi requistiti al path _\*/.well-known/openid-federation_
    - è un jwt firmato con la chiave **privata** di federazione

    - il _Content-Type_ deve essere _application/entity-statement+jwt_

    - Il corpo è un’unica stringa nel formato `header.payload.firma`, con le tre parti in base64url.

    - ecco un esempio in chiaro (non so se sono proprio tutti i campi obbligatori, ma così è valido)

- _Chiave pubblica di federazione_ fatta esattamente così:\*  
\*  
`{`  
` "keys": [`  
` {`  
` "kty": "RSA",`  
` "kid": "zm2Kky....",`  
` "e": "AQAB",`  
` "use": "sig",`  
` "alg": "RS256",`  
` "n": "7pKFhq6W9......"`  
` }`  
` ]`  
`}`
  - meglio inserire una stringa unica senza spazi e a capo per evitare problemi (poi la pagina di onboarding la formatta in automatico)
  - se manca la parte iniziale _{ “keys”: [{]}_ si genera errore _[sub] Elemento mancante_
  - se manca anche solo un elemento non va bene, senza “alg” e “use” da errore _“L’entità non rispetta i requisiti di federazione”_

**Validazione in DEV**  
Grazie a @dametto.luca ho scoperto il tool di validazione

> **[GitHub - stfbk/OIDC-SPID-CIE-Validator: OIDC-SPID/CIE-Validator](https://github.com/stfbk/OIDC-SPID-CIE-Validator)**
>
> OIDC-SPID/CIE-Validator

che valida l’EC e ti fa capire gli errori e le parti mancanti (ad esempio il logo in svg)

In realtà anche questo tool ha un errore (io ho usato la versione **[v1.0.1](https://github.com/stfbk/OIDC-SPID-CIE-Validator/releases/tag/v1.0.1))** in quanto se manca il Trustmark (che non ci deve essere in fase di onboarding) la validazione va in errore:  
ho risolto eseguendo la modifica indicata qui [mig\_validator.py in errore per mancanza trustmark · Issue #8 · stfbk/OIDC-SPID-CIE-Validator · GitHub](https://github.com/stfbk/OIDC-SPID-CIE-Validator/issues/8)

Non sono stati invece utili né il validatore online [SPID OIDC CHECK RP](https://validator.spid.gov.it/oidc/rp) che ad oggi non funziona,  
né la sua versione locale con docker [GitHub - italia/spid-saml-check: Tool di verifica implementazione SPID SAML · GitHub](https://github.com/italia/spid-saml-check) (sono riuscito a farlo funzionare ma non mi ha risolto i problemi sull’EC)

Se avete bisogno di altre info (anche sul codice sviluppato in Java) chiedete pure, intanto mi avventuro nello sviluppo dell’AuthenticationRequest.
