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 |
|---|---|---|
$PREFIX/spid_code |
Codice identificativo. String. Il codice identificativo è assegnato dal gestore dell'identità digitale e deve essere univoco. Il formato è il seguente:
Dove:
Esempio:
|
|
given_name |
Nome. String. Stringa composta da una sequenza di parole con carattere iniziale maiuscolo, intervallate da spazi singoli. Esempio:
|
|
family_name |
Cognome. String. Stringa composta da una sequenza di parole con carattere iniziale maiuscolo, intervallate da spazi singoli. Esempio:
|
|
place_of_birth |
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 |
Data di nascita. String. Secondo specifica ISO8601-2004 nel formato
YYYY indica l'anno utilizzando 4 cifre
|
|
gender |
Sesso. String. Valori ammessi:
|
|
$PREFIX/company_name |
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 |
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:
la stringa è inserita nel claim "formatted" del JSON Object "address" Esempio: "$PREFIX/registered_office":{
"formatted":"via Listz 21 00144 Roma"
}
|
|
$PREFIX/fiscal_number |
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/company_fiscal_number |
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:
Esempio:
|
|
$PREFIX/vat_number |
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:
Esempio:
|
|
document_details |
Documento d'identità. JSON Object (document): Json contenente le proprietà che rappresentano:
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 |
Numero di telefono mobile. String. Stringa numerica senza spazi intermedi |
|
phone_number_verified |
Valore Booleano che indica se il numero di telefono mobile dell'utente è stato verificato dall'OP. |
|
$PREFIX/landline_number |
Numero di telefono fisso. String. Stringa numerica senza spazi intermedi |
|
email |
Indirizzo di posta elettronica. String. Formato standard indirizzo di posta elettronica |
|
email_verified |
Valore Booleano che indica se l'email dell'utente è stata verificata dall'OP. |
|
$PREFIX/e_delivery_service |
Domicilio digitale. Indirizzo casella PEC |
|
$PREFIX/eid_exp_date |
Data di scadenza identità. Secondo specifica ISO8601-2004 nel formato
"YYYY-MM-DD" dove |
|
address |
JSON Object (address):
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"
}
|