Skip to content

Commit

Permalink
Merge branch 'fix-typo' of https://github.com/italia/spid-cie-oidc-docs
Browse files Browse the repository at this point in the history
… into fix-typo
  • Loading branch information
fmarino-ipzs committed Oct 31, 2023
2 parents 22faeb1 + 8d02895 commit f7013e9
Show file tree
Hide file tree
Showing 9 changed files with 27 additions and 27 deletions.
16 changes: 8 additions & 8 deletions docs/common/common_examples.rst
Original file line number Diff line number Diff line change
Expand Up @@ -165,22 +165,22 @@ EN 1.2. Entity Configuration Response Openid Provider
"https://www.spid.gov.it/SpidL3"
],
"claims_supported": [
"https://attributes.spid.gov.it/spid_code",
"https://attributes.eid.gov.it/spid_code",
"given_name",
"family_name",
"place_of_birth",
"birthdate",
"gender",
"https://attributes.spid.gov.it/company_name",
"https://attributes.spid.gov.it/registered_office",
"https://attributes.spid.gov.it/fiscal_number",
"https://attributes.spid.gov.it/vat_number",
"https://attributes.spid.gov.it/document_details",
"https://attributes.eid.gov.it/company_name",
"https://attributes.eid.gov.it/registered_office",
"https://attributes.eid.gov.it/fiscal_number",
"https://attributes.eid.gov.it/vat_number",
"https://attributes.eid.gov.it/document_details",
"phone_number",
"email",
"address",
"https://attributes.spid.gov.it/eid_exp_date",
"https://attributes.spid.gov.it/e_delivery_service"
"https://attributes.eid.gov.it/eid_exp_date",
"https://attributes.eid.gov.it/e_delivery_service"
],
"grant_types_supported": [
"authorization_code",
Expand Down
4 changes: 2 additions & 2 deletions docs/en/attributi_utente.rst
Original file line number Diff line number Diff line change
Expand Up @@ -201,15 +201,15 @@ The following table shows the list of user attributes supported by SPID and/or C
* - **phone_number** |br| Category: extra registry
- Mobile phone name. String. Numeric string without internal spaces |br|
Example: |br|
``"phone_number": "VATIT-12345678901"``
``"phone_number": "12345678901"``
- |spid-icon| |cieid-icon|
* - **phone_number_verified** |br| Category: extra registry
- Boolean value indicating whether the user's mobile phone number has been verified by the OP.
- |cieid-icon|
* - **$PREFIX/landline_number** |br| Category: extra registry
- Landline number. String. Numeric string without internal spaces |br|
Example: |br|
``"$PREFIX/landline_number":"VATIT-12345678901"``
``"$PREFIX/landline_number":"12345678901"``
- |cieid-icon|
* - **email** |br| Category: extra registry
- E-mail address. String. Standard e-mail address |br|
Expand Down
2 changes: 1 addition & 1 deletion docs/en/trust_marks.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Typical examples include the Entity's national or international identification c
by the issuing subject.

During the registration process of a new Leaf Entity (onboarding), the TMs are issued and signed by the TA
or its Intermediates (SA) or by Attribute Authorities (AA), if they are defined inside the attribute **trust_mark_issuers**, published inside the TA's Entity Configuration.
or its Intermediates (SA) or by Attribute Authorities (AA), if they are defined inside the attribute **trust_marks_issuers**, published inside the TA's Entity Configuration.

Each member Entity MUST expose, in its own configuration (EC), the TMs released by the issuing authorities.

Expand Down
4 changes: 2 additions & 2 deletions docs/it/attributi_utente.rst
Original file line number Diff line number Diff line change
Expand Up @@ -203,15 +203,15 @@ La seguente tabella riporta l'elenco degli attributi utente supportati da SPID e
* - **phone_number** |br| Categoria: extra anagrafica
- Numero di telefono mobile. String. Stringa numerica senza spazi intermedi |br|
Esempio: |br|
``"phone_number":"VATIT-12345678901"``
``"phone_number":"12345678901"``
- |spid-icon| |cieid-icon|
* - **phone_number_verified** |br| Categoria: extra anagrafica
- Valore Booleano che indica se il numero di telefono mobile dell'utente è stato verificato dall'OP.
- |cieid-icon|
* - **$PREFIX/landline_number** |br| Categoria: extra anagrafica
- Numero di telefono fisso. String. Stringa numerica senza spazi intermedi |br|
Esempio: |br|
``"$PREFIX/landline_number":"VATIT-12345678901"``
``"$PREFIX/landline_number":"12345678901"``
- |cieid-icon|
* - **email** |br| Categoria: extra anagrafica
- Indirizzo di posta elettronica. String. Formato standard indirizzo di posta elettronica |br|
Expand Down
2 changes: 1 addition & 1 deletion docs/it/entity_configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ Gli EC di un TA, in aggiunta ai claim comuni a tutti i partecipanti, contengono
- 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_marks_issuers**
* - **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|

Expand Down
2 changes: 1 addition & 1 deletion docs/it/la_federazione_delle_identita.rst
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Configurazione della Federazione

La configurazione della Federazione è pubblicata dal Trust Anchor all'interno della sua :ref:`Entity Configuration<entity_configuration_ta>`, disponibile presso un web path ben noto e corrispondente a **.well-known/openid-federation**.

Tutti i partecipanti DEVONO ottenere, prima della fase di esercizio, la configurazione della Federazione e mantenerla aggiornata su base giornaliera. All'interno della configurazione della Federazione sono pubblicate le chiave pubbliche del Trust Anchor usate per le operazioni di firma, il numero massimo di Intermediari consentiti tra una Foglia e il Trust Anchor (**max_path length**) e le autorità abilitate all'emissione dei Trust Mark (**trust_marks_issuers**).
Tutti i partecipanti DEVONO ottenere, prima della fase di esercizio, la configurazione della Federazione e mantenerla aggiornata su base giornaliera. All'interno della configurazione della Federazione sono pubblicate le chiave pubbliche del Trust Anchor usate per le operazioni di firma, il numero massimo di Intermediari consentiti tra una Foglia e il Trust Anchor (**max_path length**) e le autorità abilitate all'emissione dei Trust Mark (**trust_mark_issuers**).


Si veda qui un esempio non normativo di :ref:`Entity Configuration response Trust Anchor<Esempio_EN1.4>`
Expand Down
14 changes: 7 additions & 7 deletions docs/it/trust_marks.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,19 +13,19 @@ Esempi tipici includono il codice di identificazione nazionale o internazionale

I TM sono emessi e firmati, durante il processo di registrazione di una nuova entità di tipo Foglia (Onboarding), dal (TA) o suoi Intermediari (SA) o da Gestori Qualificati di Attributi (AA), se definiti all'interno dell'attributo **trust_mark_issuers**, pubblicato all'interno dell'Entity Configuration del TA.

Di seguito un esempio non normativo dell'oggetto **trust_marks_issuers** all'interno della Entity Configuration del TA.
Di seguito un esempio non normativo dell'oggetto **trust_mark_issuers** all'interno della Entity Configuration del TA.

.. code-block:: json
{
"trust_marks_issuers":{
"trust_mark_issuers":{
"https://registry.agid.gov.it/openid_relying_party/public/":[
"https://registry.spid.agid.gov.it/",
"https://public.intermediary.spid.it/"
"https://public.intermediate.spid.it/"
],
"https://registry.agid.gov.it/openid_relying_party/private/":[
"https://registry.spid.agid.gov.it/",
"https://private.other.intermediary.it/"
"https://private.other.intermediate.it/"
]
}
}
Expand All @@ -35,7 +35,7 @@ Ogni entità partecipante DEVE esporre nella propria configurazione (EC) i TM ri

Nello scenario CIE / SPID, un TM viene firmato dal TA **MinInterno** / **Agid** o loro Intermediari (SA) o Gestori Qualificati di Attributi (AA).

Il TA definisce i soggetti abilitati all'emissione dei TM riconoscibili all'interno della Federazione, mediante il claim **trust_marks_issuers**, presente all'interno del proprio Entity Configuration. Il valore dell'attributo **trust_marks_issuers** è composto da un oggetto JSON avente come chiavi gli identificativi dei TM e come valori la lista degli identificativi (URL) delle entità abilitate ad emetterli.
Il TA definisce i soggetti abilitati all'emissione dei TM riconoscibili all'interno della Federazione, mediante il claim **trust_mark_issuers**, presente all'interno del proprio Entity Configuration. Il valore dell'attributo **trust_mark_issuers** è composto da un oggetto JSON avente come chiavi gli identificativi dei TM e come valori la lista degli identificativi (URL) delle entità abilitate ad emetterli.

I Trust Mark rappresentano il primo filtro per l'instaurazione della fiducia tra le parti, sono elementi indispensabili per avviare la risoluzione dei metadati. In loro assenza una entità non è riconoscibile come partecipante all’interno della Federazione.

Expand Down Expand Up @@ -65,7 +65,7 @@ La tabella seguente definisce i <entity_role> riconoscibili all'interno delle Fe
* - **openid_provider**
- l'entità nel claim *sub* è un OP.
- OP
* - **intermediary**
* - **intermediate**
- l'entità nel claim *sub* è un Soggetto Aggregatore.
- SA
* - **oauth_resource**
Expand Down Expand Up @@ -93,7 +93,7 @@ La tabella seguente definisce i <trustmark_profile> riconoscibili all'interno de
federation_entity Trust Mark
--------------------------------

In aggiunta ai claim dei profili **public** e **private**, il profilo **intermediary** individua i SA e aggiunge le estensioni **full** e **light** all'interno del claim **sa_profile**, a seconda della modalità con cui operano rispetto ai Soggetti Aggregati
In aggiunta ai claim dei profili **public** e **private**, il profilo **intermediate** individua i SA e aggiunge le estensioni **full** e **light** all'interno del claim **sa_profile**, a seconda della modalità con cui operano rispetto ai Soggetti Aggregati

.. seealso::

Expand Down
2 changes: 1 addition & 1 deletion docs/it/trust_negotiation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Ottenuto il Metadata finale, il Provider valida la richiesta del RP secondo le m
Nei casi in cui un RP avesse come entità superiore un SA e non direttamente il TA, la procedura di acquisizione e validazione dell'Entity Configuration del RP avviene mediante l'Entity Statement pubblicato dal SA nei confronti del RP e mediante la convalida dell'Entity Configuration del SA con l'Entity Statement emesso dalla TA in relazione al SA. Se la soglia del massimo numero di Intermediari verticali, definita dal valore di **max_path_length**, viene superata, l'OP blocca il processo di Federation Entity Discovery e rigetta la richiesta del RP.


.. [1] I Trust Mark di Federazione sono configurati nel claim **trust_marks_issuers** e contenuti nell'Entity Configuration del Trust Anchor.
.. [1] I Trust Mark di Federazione sono configurati nel claim **trust_mark_issuers** e contenuti nell'Entity Configuration del Trust Anchor.
.. [2] Un RP può esporre più di una entità superiore all'interno del proprio claim di **authority_hints**. Si pensi ad un RP che partecipa sia alla Federazione SPID che a quella CIE. Inoltre un RP può risultare come aggregato di molteplici Intermediari, sia questi SPID o CIE.
Expand Down
8 changes: 4 additions & 4 deletions requirements-dev.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
alabaster==0.7.12
Babel==2.10.1
certifi==2022.12.7
certifi==2023.7.22
charset-normalizer==2.0.12
commonmark==0.9.1
doc8==0.11.1
Expand All @@ -11,12 +11,12 @@ imagesize==1.3.0
Jinja2==3.1.2
MarkupSafe==2.1.1
packaging==21.3
Pygments==2.12.0
Pygments==2.15.0
pyparsing==3.0.9
pytz==2022.1
PyYAML==6.0
recommonmark==0.7.1
requests==2.27.1
requests==2.31.0
snowballstemmer==2.2.0
Sphinx==5.0.1
sphinxcontrib-applehelp==1.0.2
Expand All @@ -25,4 +25,4 @@ sphinxcontrib-htmlhelp==2.0.0
sphinxcontrib-jsmath==1.0.1
sphinxcontrib-qthelp==1.0.3
sphinxcontrib-serializinghtml==1.1.5
urllib3==1.26.9
urllib3==1.26.18

0 comments on commit f7013e9

Please sign in to comment.