Docs Italia beta

Documenti pubblici, digitali.

Entity Configuration

Un'Entity Configuration (EC) è un Metadata di Federazione in formato Jose e firmato da una Entità e riguardante se stessa, pubblicato presso il web endpoint .well-known/openid-federation.

Firma della Entity Configuration

Tutte le operazioni di verifica della firma relative agli ES, EC e TM sono eseguite con le chiavi pubbliche di Federazione. Per quanto riguarda gli algoritmi di firma supportati si veda la Sezione Algoritmi Crittografici.

Avvertimento

Distinguiamo le chiavi di Federazione da quelle di OIDC Core. Queste ultime risiedono nei Metadata OIDC. Un EC contiene sia le chiavi pubbliche di Federazione che i Metadata OIDC. Le chiavi di Federazione DOVREBBERO essere diverse da quelle di OIDC Core.

Entity Configuration - claim comuni

Claim Descrizione Supportato da
iss String. Identificativo dell'entità che lo emette. spid-icon cieid-icon
sub String. Identificativo del soggetto a cui è riferito. spid-icon cieid-icon
iat UNIX Timestamp con l'istante di generazione del JWT, codificato come NumericDate come indicato in RFC 7519 spid-icon cieid-icon
exp UNIX Timestamp con l'istante di scadenza del JWT, codificato come NumericDate come indicato in RFC 7519. spid-icon cieid-icon
jwks Un JSON Web Key Set (JWKS) RFC 7517 che rappresenta la parte pubblica delle chiavi di firma dell'entità interessata. Ogni JWK nel set JWK DEVE avere un ID di chiave (claim kid). spid-icon cieid-icon
metadata

JSON Object. Ogni chiave dell'oggetto JSON rappresenta un identificatore del tipo di Metadata e ogni valore DEVE essere un oggetto JSON che rappresenta i Metadata secondo lo schema di Metadata di quel tipo.

Una configurazione di entità PUÒ contenere più dichiarazioni di Metadata, ma solo una per ogni tipo di Metadata (<entity_type>).

I tipi consentiti sono i seguenti:

  • openid_relying_party
  • openid_provider
  • federation_entity
  • oauth_authorization_server
  • oauth_resource
spid-icon cieid-icon

Avvertimento

All'interno dell'EC i valori degli attributi iss e sub contengono il medesimo valore (URL).

Entity Configuration Foglia e intermediari

Gli EC delle entità Foglia e intermediari, in aggiunta ai claim precedentemente definiti, contengono anche i seguenti claim:

Claim Descrizione Supportato da
authority_hints Array di URL. Contiene una lista di URL delle entità superiori, quali TA o SA che POSSONO emettere un ES relativo a questo soggetto. spid-icon cieid-icon
trust_marks Un array JSON contenente i Trust Mark. Vedere la Sezione Trust Mark. Obbligatorio per tutti i partecipanti fatta esclusione del Trust Anchor. spid-icon cieid-icon

Entity Configuration Trust Anchor

Gli EC di un TA, in aggiunta ai claim comuni a tutti i partecipanti, contengono anche i seguenti:

Claim Descrizione Supportato da
constraints JSON Object che descrive un insieme di vincoli della Trust Chain e che DEVE contenere l'attributo max_path_length. Rappresenta il numero massimo di SA tra una Foglia e il TA. PUÒ anche contenere il claim allowed_leaf_entity_types, che restringe i tipi di Entità riconoscobili come suoi discendenti. spid-icon cieid-icon
trust_mark_issuers JSON Array che indica quali autorità sono considerate attendibili nella Federazione per l'emissione di specifici TM, questi assegnati mediante il proprio identificativo univoco. spid-icon cieid-icon