Tabella attributi utente¶

La seguente tabella riporta l'elenco degli attributi utente supportati da SPID e/o CIE. La variable $PREFIX=https://attributes.eid.gov.it rappresenta il namespace.

Claim	Descrizione	Supportato da
$PREFIX/spid_code Categoria: anagrafica	Codice identificativo. String. Il codice identificativo è assegnato dal gestore dell'identità digitale e deve essere univoco. Il formato è il seguente: `<codice_Identificativo>=<cod_IdP><nr.univoco>` Dove: <cod_IdP>: è un codice composto da 4 lettere univocamente assegnato al gestore delle identità; <nr.univoco>: è una stringa alfanumerica composta da 10 caratteri che il gestore delle identità genera in maniera univoca nell'ambito del proprio dominio. Esempio: `"$PREFIX/spid_code":"ABCD123456789A"`
given_name Categoria: anagrafica	Nome. String. Stringa composta da una sequenza di parole con carattere iniziale maiuscolo, intervallate da spazi singoli. Esempio: `"given_name":"Giovanni Mario"`
family_name Categoria: anagrafica	Cognome. String. Stringa composta da una sequenza di parole con carattere iniziale maiuscolo, intervallate da spazi singoli. Esempio: `"family_name":"Bianchi Verdi"`
place_of_birth Categoria: anagrafica	Luogo di nascita, Provincia di nascita. JSON Object: "locality : Stringa corrispondente al codice catastale (Codice Belfiore) del Comune o della nazione estera di nascita (Es. "F205" per la città di Milano) "region" : Stringa corrispondente alla sigla della provincia di nascita Esempio: "place_of_birth":{ "region":"MI", "locality":"F205" }
birthdate Categoria: anagrafica	Data di nascita. String. Secondo specifica ISO8601-2004 nel formato YYYY indica l'anno utilizzando 4 cifre MM indica il mese in (due) cifre DD indica il giorno in (due) cifre Esempio: `"birthdate":"2002-09-24"`
gender Categoria: anagrafica	Sesso. String. Valori ammessi: "female" per sesso femminile "male" per sesso maschile Esempio: `"gender":"female"`
$PREFIX/company_name Categoria: anagrafica	Ragione o denominazione sociale. String. Stringa composta da una sequenza di parole intervallate da spazi singoli. In maiuscolo le sottostringhe corrispondenti a nomi (es. “Agenzia per l'Italia Digitale”) "$PREFIX/company_name": "Agenzia per l'Italia Digitale"
$PREFIX/registered_office Categoria: extra anagrafica	Sede legale. JSON Object: formatted, street_address, locality, region, postal_code, country, country_code. Json composto da una stringa composta da una sequenza di parole intervallate da spazi singoli rappresentanti: Tipologia( via, viale, piazza …) Indirizzo Nr.civico CAP Luogo Provincia la stringa è inserita nel claim "formatted" del JSON Object "address" Esempio: "$PREFIX/registered_office":{ "formatted":"via Listz 21 00144 Roma" }
$PREFIX/fiscal_number Categoria: anagrafica	Codice fiscale della persona fisica. String. Per il formato si faccia riferimento alla codifica dell'attributo CF per i certificati, proposta nell'ambito del Draft ETSI EN 319 412-1, che nel caso specifico prevede la seguente composizione: TINIT-<CodiceFiscale> Esempio: `"$PREFIX/fiscal_number":“TINIT-ABCXYZ00W00Z000Z"`
$PREFIX/company_fiscal_number Categoria: anagrafica	Codice fiscale Persona Giuridica. String. Per il formato si faccia riferimento alla codifica dell'attributo CF per i certificati, proposta nell'ambito del Draft ETSI EN 319 412-1, che nel caso specifico prevede la seguente composizione: `TINIT-segue il codice fiscale` Esempio: `"$PREFIX/company_fiscal_number":"TINIT-ABCXYZ00W00Z000Z"`
$PREFIX/vat_number Categoria: anagrafica	Partita IVA. String. Per il formato si faccia riferimento alla codifica dell'attributo Partita IVA per i certificati, proposta nell'ambito del Draft ETSI EN 319 412-1, che nel caso specifico prevede la seguente composizione: `VATIT-<PartitaIVA>` Esempio: `"$PREFIX/vat_number": "VATIT-12345678901"`
document_details Categoria: extra anagrafica	Documento d'identità. JSON Object (document): Json contenente le proprietà che rappresentano: "type" : valori ammessi: cartaIdentita, passaporto, patenteGuida, patenteNautica, librettoPensione, patentinoImpTermici, portoArmi, tesseraRiconoscimento; "document_number" : Numero del documento; "issuer" : <ente emettitore> JSON Object: "name" stringa ottenuta dalla concatenazione dei termini costituenti la denominazione dell'ente a meno di congiunzioni, articoli e preposizioni. Es. regioneLazio ( Regione Lazio); provinciaCatania ( Provincia di Catania); prefetturaRoma (Prefettura di Roma); MinisteroEconomiaFinanze ( Ministero dell'Economia e delle Finanze); "date_of_issuance" : data di rilascio del documento; "date_of_expiry" : data di scadenza del documento; Esempio: "document_details":{ "type":"cartaIdentita", "document_number":"AS09452389", "issuer":{ "name":"ComuneRoma" }, "date_of_issuance":"2013-01-02", "date_of_expiry":"2013-01-31" }
phone_number Categoria: extra anagrafica	Numero di telefono mobile. String. Stringa numerica senza spazi intermedi Esempio: `"phone_number":"12345678901"`
phone_number_verified Categoria: extra anagrafica	Valore Booleano che indica se il numero di telefono mobile dell'utente è stato verificato dall'OP.
$PREFIX/landline_number Categoria: extra anagrafica	Numero di telefono fisso. String. Stringa numerica senza spazi intermedi Esempio: `"$PREFIX/landline_number":"12345678901"`
email Categoria: extra anagrafica	Indirizzo di posta elettronica. String. Formato standard indirizzo di posta elettronica Esempio: `"email":"name@domain.it"`
email_verified Categoria: extra anagrafica	Valore Booleano che indica se l'email dell'utente è stata verificata dall'OP.
$PREFIX/e_delivery_service Categoria: extra anagrafica	Domicilio digitale. Indirizzo casella PEC Esempio: `"$PREFIX/e_delivery_service":"nome@pecdomain.it"`
$PREFIX/eid_exp_date Categoria: extra anagrafica	Data di scadenza identità. Secondo specifica ISO8601-2004 nel formato "YYYY-MM-DD" dove YYYY indica l'anno utilizzando 4 cifre MM indica il mese in (due) cifre DD indica il giorno in (due) cifre Esempio: `"$PREFIX/eid_exp_date":"2002-09-24"`
address Categoria: extra anagrafica	JSON Object (address): "street_address": L'attributo contiene la tipologia (via, viale, piazza …), l'indirizzo e il numero civico. Le tre informazioni sono preferibilmente ordinate come d'uso per lo specifico Stato. "postal_code": CAP "locality": Comune "region": Provincia "country_code": Nazione Esempio: "address":{ "street_address":"Via Liszt 21", "postal_code":"00144", "locality":"Roma", "region":"RM", "country_code":"IT" }

Esempi¶

Si riportano per comodità gli esempi che danno luogo alla composizione di un unico JSON Object da parte di più attributi ed in particolare i claim "place_of_birth", "address", "document_details", $PREFIX/registered_office.

Si riportano a titolo di esempio due indirizzi italiani:

Attributo	Esempio codifica OIDC
Indirizzo domicilio fisico CAP domicilio fisico Comune domicilio fisico Provincia domicilio fisico Nazione domicilio fisico	"address": { "street_address":"Via Liszt 21", "postal_code":"00144", "locality":"Roma", "region":"RM", "country_code":"IT" }
Indirizzo domicilio fisico CAP domicilio fisico Comune domicilio fisico Provincia domicilio fisico Nazione domicilio fisico	"address": { "street_address":"S.S. Salaria Km 23,800", "postal_code":"00015", "locality":"Monterotondo", "region":"RM", "country_code":"IT" }

Vi sono casi, come per gli Stati Uniti d'America, dove oltre alla nazione (US) esiste uno Stato. In tali casi lo Stato è indicato nel campo Provincia. Si riporta il seguente esempio:

Attributo	Esempio codifica OIDC
Indirizzo domicilio fisico CAP domicilio fisico Comune domicilio fisico Provincia domicilio fisico Nazione domicilio fisico	"address":{ "street_address":"503,Washington Avenue", "postal_code":"12401", "locality":"Kingston", "region":"New york", "country_code":"US" }