Skip to content

Commit

Permalink
Deploy to GitHub pages
Browse files Browse the repository at this point in the history
  • Loading branch information
github-actions[bot] authored Nov 27, 2024
1 parent 1dc14bc commit 52e967e
Show file tree
Hide file tree
Showing 46 changed files with 91 additions and 100 deletions.
Binary file modified versione-corrente/en/.doctrees/environment.pickle
Binary file not shown.
Binary file modified versione-corrente/en/.doctrees/trust.doctree
Binary file not shown.
48 changes: 22 additions & 26 deletions versione-corrente/en/_sources/trust.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -229,7 +229,7 @@ The configuration of the federation is published by the Trust Anchor within its

All the participants in the federation MUST obtain the federation configuration before entering the operational phase, and they
MUST keep it up-to-date. The federation configuration is the Trust Anchor's Entity Configuration, it contains the
public keys for signature operations and the maximum number of Intermediates allowed between a Leaf and the Trust Anchor (**max_path_length**).
public keys for signature operations.

Below is a non-normative example of a Trust Anchor Entity Configuration, where each parameter is documented in the `OpenID Federation <OID-FED>`_ specification:

Expand Down Expand Up @@ -293,14 +293,14 @@ The Entity Configuration is the verifiable document that each Federation Entity
The Entity Configuration HTTP Response MUST set the media type to `application/entity-statement+jwt`.

The Entity Configuration MUST be cryptographically signed. The public part of this key MUST be provided in the
Entity Configuration and within the Entity Statement issued by a immediate superior and related to its subordinate Federation Entity.
Entity Configuration and within the Subordinate Statement issued by a immediate superior and related to its subordinate Federation Entity.

The Entity Configuration MAY also contain one or more Trust Marks.

.. note::
**Entity Configuration Signature**

All the signature-check operations regarding the Entity Configurations, Entity Statements and Trust Marks, are carried out with the Federation public keys. For the supported algorithms refer to Section `Cryptografic Algorithm`.
All the signature-check operations regarding the Entity Configurations, Subordinate Statements and Trust Marks, are carried out with the Federation public keys. For the supported algorithms refer to Section `Cryptografic Algorithm`.

Entity Configurations Common Parameters
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Expand Down Expand Up @@ -343,10 +343,6 @@ The Trust Anchor Entity Configuration, in addition to the common parameters list
* - **Claim**
- **Description**
- **Required**
* - **constraints**
- JSON Object that describes the trust evaluation mechanisms bounds. It MUST contain the attribute **max_path_length** that
defines the maximum number of Intermediates between a Leaf and the Trust Anchor.
- |check-icon|
* - **trust_mark_issuers**
- JSON Array that defines which Federation authorities are considered trustworthy
for issuing specific Trust Marks, assigned with their unique identifiers.
Expand All @@ -372,7 +368,7 @@ In addition to the previously defined claims, the Entity Configuration of the Le
- **Required**
* - **authority_hints**
- Array of URLs (String). It contains a list of URLs of the immediate superior entities, such as the Trust Anchor or
an Intermediate, that issues an Entity Statement related to this subject.
an Intermediate, that issues an Subordinate Statement related to this subject.
- |check-icon|
* - **trust_marks**
- A JSON Array containing the Trust Marks.
Expand Down Expand Up @@ -466,20 +462,20 @@ The *federation_entity* metadata for Leaves MUST contain the following claims.
- See `OID-FED`_ Draft 36 Section 5.1.1


Entity Statements
-----------------
Subordinate Statements
-----------------------

Trust Anchors and Intermediates publish Entity Statements related to their immediate Subordinates.
The Entity Statement MAY contain a metadata policy and the Trust Marks related to a Subordinate.
Trust Anchors and Intermediates publish Subordinate Statements related to their immediate Subordinates.
The Subordinate Statement MAY contain a metadata policy and the Trust Marks related to a Subordinate.

The metadata policy, when applied, makes one or more changes to the final metadata of the Leaf. The final metadata of a Leaf is derived from the Trust Chain that contains all the statements, starting from the Entity Configuration up to the Entity Statement issued by the Trust Anchor.
The metadata policy, when applied, makes one or more changes to the final metadata of the Leaf. The final metadata of a Leaf is derived from the Trust Chain that contains all the statements, starting from the Entity Configuration up to the Subordinate Statement issued by the Trust Anchor.

Trust Anchors and Intermediates MUST expose the Federation Fetch endpoint, where the Entity Statements are requested to validate the Leaf's Entity Configuration signature.
Trust Anchors and Intermediates MUST expose the Federation Fetch endpoint, where the Subordinate Statements are requested to validate the Leaf's Entity Configuration signature.

.. note::
The Federation Fetch endpoint MAY also publish X.509 certificates for each of the public keys of the Subordinate. Making the distribution of the issued X.509 certificates via a RESTful service.

Below there is a non-normative example of an Entity Statement issued by an Registration Body (such as the Trust Anchor or its Intermediate) in relation to one of its Subordinates.
Below there is a non-normative example of an Subordinate Statement issued by an Registration Body (such as the Trust Anchor or its Intermediate) in relation to one of its Subordinates.

.. code-block:: text
Expand Down Expand Up @@ -535,16 +531,16 @@ Below there is a non-normative example of an Entity Statement issued by an Regis
.. note::

**Entity Statement Signature**
**Subordinate Statement Signature**

The same considerations and requirements made for the Entity Configuration
and in relation to the signature mechanisms MUST be applied for the Entity Statements.
and in relation to the signature mechanisms MUST be applied for the Subordinate Statements.


Entity Statement
^^^^^^^^^^^^^^^^^^
Subordinate Statement
^^^^^^^^^^^^^^^^^^^^^

The Entity Statement issued by Trust Anchors and Intermediates contains the following attributes:
The Subordinate Statement issued by Trust Anchors and Intermediates contains the following attributes:


.. list-table::
Expand Down Expand Up @@ -576,7 +572,7 @@ The Entity Statement issued by Trust Anchors and Intermediates contains the foll
- JSON Array containing the Trust Marks issued by itself for the subordinate subject.
- |uncheck-icon|
* - **constraints**
- It MAY contain the **allowed_leaf_entity_types**, that restricts what types of metadata the subject is allowed to publish.
- It MAY contain the **allowed_leaf_entity_types**, that restricts what types of metadata the subject is allowed to publish. It MAY contain the maximum number of Intermediates allowed between a itself and the Leaf (**max_path_length**)
- |check-icon|


Expand All @@ -585,16 +581,16 @@ Trust Evaluation Mechanism

Trust Anchors MUST distribute their Federation Public Keys through secure out-of-band mechanisms, such as publishing them on a verified web page or storing them in a remote repository as part of a trust list. The rationale behind this requirement is that relying solely on the data provided within the Trust Anchor's Entity Configuration does not adequately mitigate risks associated with DNS and TLS manipulation attacks. To ensure security, all participants MUST obtain the Trust Anchor's public keys using these out-of-band methods. They should then compare these keys with those obtained from the Trust Anchor's Entity Configuration, discarding any keys that do not match. This process helps to ensure the integrity and authenticity of the Trust Anchor's public keys and the overall security of the federation.

The Trust Anchor publishes the list of its Subordinates (Federation Subordinate Listing endpoint) and the attestations of their metadata and public keys (Entity Statements).
The Trust Anchor publishes the list of its Subordinates (Federation Subordinate Listing endpoint) and the attestations of their metadata and public keys (Subordinate Statements).

Each participant, including Trust Anchor, Intermediate, Credential Issuer, Wallet Provider, and Relying Party, publishes its own metadata and public keys (Entity Configuration endpoint) in the well-known web resource **.well-known/openid-federation**.

Each of these can be verified using the Entity Statement issued by a superior, such as the Trust Anchor or an Intermediate.
Each of these can be verified using the Subordinate Statement issued by a superior, such as the Trust Anchor or an Intermediate.

Each Entity Statement is verifiable over time and MUST have an expiration date. The revocation of each statement is verifiable in real time and online (only for remote flows) through the federation endpoints.
Each Subordinate Statement is verifiable over time and MUST have an expiration date. The revocation of each statement is verifiable in real time and online (only for remote flows) through the federation endpoints.

.. note::
The revocation of an Entity is made with the unavailability of the Entity Statement related to it. If the Trust Anchor or its Intermediate doesn't publish a valid Entity Statement, or if it publishes an expired/invalid Entity Statement, the subject of the Entity Statement MUST be intended as not valid or revoked.
The revocation of an Entity is made with the unavailability of the Subordinate Statement related to it. If the Trust Anchor or its Intermediate doesn't publish a valid Subordinate Statement, or if it publishes an expired/invalid Subordinate Statement, the subject of the Subordinate Statement MUST be intended as not valid or revoked.

The concatenation of the statements, through the combination of these signing mechanisms and the binding of claims and public keys, forms the Trust Chain.

Expand Down Expand Up @@ -748,7 +744,7 @@ Privacy Remarks

- Wallet Instances MUST NOT publish their metadata through an online service.
- The trust infrastructure MUST be public, with all endpoints publicly accessible without any client credentials that may disclose who is requesting access.
- When a Wallet Instance requests the Entity Statements to build the Trust Chain for a specific Relying Party or validates a Trust Mark online, issued for a specific Relying Party, the Trust Anchor or its Intermediate do not know that a particular Wallet Instance is inquiring about a specific Relying Party; instead, they only serve the statements related to that Relying Party as a public resource.
- When a Wallet Instance requests the Subordinate Statements to build the Trust Chain for a specific Relying Party or validates a Trust Mark online, issued for a specific Relying Party, the Trust Anchor or its Intermediate do not know that a particular Wallet Instance is inquiring about a specific Relying Party; instead, they only serve the statements related to that Relying Party as a public resource.
- The Wallet Instance metadata MUST not contain information that may disclose technical information about the hardware used.
- Leaf entity, Intermediate, and Trust Anchor metadata may include the necessary amount of data as part of administrative, technical, and security contact information. It is generally not recommended to use personal contact details in such cases. From a legal perspective, the publication of such information is needed for operational support concerning technical and security matters and the GDPR regulation.

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/algorithms.html
Original file line number Diff line number Diff line change
Expand Up @@ -360,7 +360,7 @@ <h3 id="searchlabel">Quick search</h3>


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/authentic-sources.html
Original file line number Diff line number Diff line change
Expand Up @@ -245,7 +245,7 @@ <h2>Security Patterns<a class="headerlink" href="#security-patterns" title="Link


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/backup-restore.html
Original file line number Diff line number Diff line change
Expand Up @@ -259,7 +259,7 @@ <h2>External references<a class="headerlink" href="#external-references" title="


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/contribute.html
Original file line number Diff line number Diff line change
Expand Up @@ -262,7 +262,7 @@ <h2>Acknowledgements<a class="headerlink" href="#acknowledgements" title="Link t


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/defined-terms.html
Original file line number Diff line number Diff line change
Expand Up @@ -574,7 +574,7 @@ <h2>Acronyms<a class="headerlink" href="#acronyms" title="Link to this heading">


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/genindex.html
Original file line number Diff line number Diff line change
Expand Up @@ -284,7 +284,7 @@ <h2 id="R">R</h2>


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
6 changes: 3 additions & 3 deletions versione-corrente/en/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -205,8 +205,8 @@ <h2>Index of content<a class="headerlink" href="#index-of-content" title="Link t
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="trust.html#metadata-of-federation-entity-leaves">Metadata of federation_entity Leaves</a></li>
<li class="toctree-l2"><a class="reference internal" href="trust.html#entity-statements">Entity Statements</a><ul>
<li class="toctree-l3"><a class="reference internal" href="trust.html#entity-statement">Entity Statement</a></li>
<li class="toctree-l2"><a class="reference internal" href="trust.html#subordinate-statements">Subordinate Statements</a><ul>
<li class="toctree-l3"><a class="reference internal" href="trust.html#subordinate-statement">Subordinate Statement</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="trust.html#trust-evaluation-mechanism">Trust Evaluation Mechanism</a><ul>
Expand Down Expand Up @@ -494,7 +494,7 @@ <h2>Index of content<a class="headerlink" href="#index-of-content" title="Link t


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
Binary file modified versione-corrente/en/objects.inv
Binary file not shown.
2 changes: 1 addition & 1 deletion versione-corrente/en/pid-eaa-data-model.html
Original file line number Diff line number Diff line change
Expand Up @@ -1466,7 +1466,7 @@ <h3>MDOC-CBOR Examples<a class="headerlink" href="#mdoc-cbor-examples" title="Li


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/pid-eaa-entity-configuration.html
Original file line number Diff line number Diff line change
Expand Up @@ -1013,7 +1013,7 @@ <h2>Example of a (Q)EAA Provider Entity Configuration<a class="headerlink" href=


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/pid-eaa-issuance.html
Original file line number Diff line number Diff line change
Expand Up @@ -1522,7 +1522,7 @@ <h3>Notification Response<a class="headerlink" href="#notification-response" tit


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/proximity-flow.html
Original file line number Diff line number Diff line change
Expand Up @@ -623,7 +623,7 @@ <h2>Session Termination<a class="headerlink" href="#session-termination" title="


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/pseudonyms.html
Original file line number Diff line number Diff line change
Expand Up @@ -252,7 +252,7 @@ <h2>Implementation Considerations<a class="headerlink" href="#implementation-con


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -439,7 +439,7 @@ <h2>Example of a Relying Party Entity Configuration<a class="headerlink" href="#


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/relying-party-solution.html
Original file line number Diff line number Diff line change
Expand Up @@ -1387,7 +1387,7 @@ <h3>Session Termination<a class="headerlink" href="#session-termination" title="


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/remote-flow.html
Original file line number Diff line number Diff line change
Expand Up @@ -937,7 +937,7 @@ <h2>Redirect URI Errors<a class="headerlink" href="#redirect-uri-errors" title="


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/revocation-lists.html
Original file line number Diff line number Diff line change
Expand Up @@ -1066,7 +1066,7 @@ <h2>Error Assertion<a class="headerlink" href="#error-assertion" title="Link to


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/search.html
Original file line number Diff line number Diff line change
Expand Up @@ -193,7 +193,7 @@ <h1 id="search-documentation">Search</h1>


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/searchindex.js

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion versione-corrente/en/security-privacy-considerations.html
Original file line number Diff line number Diff line change
Expand Up @@ -902,7 +902,7 @@ <h3>SPR-W-50<a class="headerlink" href="#spr-w-50" title="Link to this heading">


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/ssi-introduction.html
Original file line number Diff line number Diff line change
Expand Up @@ -213,7 +213,7 @@ <h3 id="searchlabel">Quick search</h3>


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
2 changes: 1 addition & 1 deletion versione-corrente/en/standards.html
Original file line number Diff line number Diff line change
Expand Up @@ -326,7 +326,7 @@ <h1>Technical References<a class="headerlink" href="#technical-references" title


<div class="footer" role="contentinfo">
Last updated on 20/11/2024.
Last updated on 27/11/2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.5.
</div>

Expand Down
Loading

0 comments on commit 52e967e

Please sign in to comment.