From ad0144220746a3e4b425a9d0d23072fadd713a4c Mon Sep 17 00:00:00 2001 From: cmarco0 <146938645+cmarco0@users.noreply.github.com> Date: Tue, 21 May 2024 15:00:43 +0200 Subject: [PATCH 1/7] Editorial change in Wallet Solution 'alg' HEADER --- docs/en/wallet-solution.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/wallet-solution.rst b/docs/en/wallet-solution.rst index 31fd4893c..b05c0cd73 100644 --- a/docs/en/wallet-solution.rst +++ b/docs/en/wallet-solution.rst @@ -88,7 +88,7 @@ Header +---------+-----------------------------------------------------------------+ | **Key** | **Value** | +---------+-----------------------------------------------------------------+ -| alg | Algorithm used to verify the token signature (e.g., ES256). | +| alg | Algorithm used to verify the token signature. It MUST be one of the possibile values indicated `here `_ (e.g., ES256).| +---------+-----------------------------------------------------------------+ | kid | Thumbprint of the public key used for signing. | +---------+-----------------------------------------------------------------+ From 2fc40b36c24e05d14fd93e8eca31a153f2dd881f Mon Sep 17 00:00:00 2001 From: cmarco0 <146938645+cmarco0@users.noreply.github.com> Date: Tue, 21 May 2024 16:20:40 +0200 Subject: [PATCH 2/7] Editorial change on the table --- docs/en/wallet-solution.rst | 82 ++++++++++++++++--------------------- 1 file changed, 35 insertions(+), 47 deletions(-) diff --git a/docs/en/wallet-solution.rst b/docs/en/wallet-solution.rst index b05c0cd73..fcda85798 100644 --- a/docs/en/wallet-solution.rst +++ b/docs/en/wallet-solution.rst @@ -84,56 +84,44 @@ The returning Entity Configuration of the Wallet Provider MUST contain the attributes listed below: Header -^^^^^^ -+---------+-----------------------------------------------------------------+ -| **Key** | **Value** | -+---------+-----------------------------------------------------------------+ -| alg | Algorithm used to verify the token signature. It MUST be one of the possibile values indicated `here `_ (e.g., ES256).| -+---------+-----------------------------------------------------------------+ -| kid | Thumbprint of the public key used for signing. | -+---------+-----------------------------------------------------------------+ -| typ | Media type, set to ``entity-statement+jwt``. | -+---------+-----------------------------------------------------------------+ +^^^^^^^ +.. list-table:: + :widths: 20 60 20 + :header-rows: 1 + + * - **Key** + - **Value** + * - **alg** + - Algorithm used to verify the token signature. It MUST be one of the possibile values indicated `here `_ (e.g., ES256). + * - **kid** + - Thumbprint of the public key used for signing. + * - **typ** + - Media type, set to ``entity-statement+jwt``. + Payload ^^^^^^^ -+-----------------------------------+-----------------------------------+ -| **Key** | **Value** | -+-----------------------------------+-----------------------------------+ -| iss | Public URL of the Wallet | -| | Provider. | -+-----------------------------------+-----------------------------------+ -| sub | Public URL of the Wallet | -| | Provider. | -+-----------------------------------+-----------------------------------+ -| iat | Issuance datetime in | -| | Unix Timestamp format. | -+-----------------------------------+-----------------------------------+ -| exp | Expiration datetime | -| | in Unix Timestamp format. | -+-----------------------------------+-----------------------------------+ -| authority_hints | Array of URLs (String) containing | -| | the list of URLs of the | -| | immediate superior Entities, such | -| | as the Trust Anchor or an | -| | Intermediate, that MAY issue an | -| | Entity Statement related to this | -| | subject. | -+-----------------------------------+-----------------------------------+ -| jwks | A JSON Web Key Set (JWKS) `RFC | -| | 7517 `_ | -| | that represents the public part | -| | of the signing keys of the Entity | -| | at issue. Each JWK in the JWK set | -| | MUST have a key ID (claim kid). | -+-----------------------------------+-----------------------------------+ -| metadata | Contains the | -| | metadata | -| | ``wallet_provider`` | -| | and the | -| | ``federation_entity`` metadata. | -+-----------------------------------+-----------------------------------+ +.. list-table:: + :widths: 20 60 20 + :header-rows: 1 + + * - **Key** + - **Value** + * - **iss** + - Public URL of the Wallet Provider. + * - **sub** + - Public URL of the Wallet Provider. + * - **iat** + - Issuance datetime in Unix Timestamp format. + * - **exp** + - Expiration datetime in Unix Timestamp format. + * - **authority_hints** + - Array of URLs (String) containing the list of URLs of the immediate superior Entities, such as the Trust Anchor or an Intermediate, that MAY issue an Entity Statement related to this subject. + * - **jwks** + - A JSON Web Key Set (JWKS) `RFC 7517 `_ that represents the public part of the signing keys of the Entity at issue. Each JWK in the JWK set MUST have a key ID (claim kid). + * - **metadata** + - Contains the metadata ``wallet_provider`` and the ``federation_entity`` metadata. + `wallet_provider` metadata ~~~~~~~~~~~~~~~~~~~~~~~~~~ From 8dbdf094730133683c25baff1c94b86884257aee Mon Sep 17 00:00:00 2001 From: cmarco0 <146938645+cmarco0@users.noreply.github.com> Date: Tue, 21 May 2024 17:14:01 +0200 Subject: [PATCH 3/7] Editorial change on tables --- docs/en/wallet-solution.rst | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/en/wallet-solution.rst b/docs/en/wallet-solution.rst index fcda85798..6925d50d2 100644 --- a/docs/en/wallet-solution.rst +++ b/docs/en/wallet-solution.rst @@ -86,40 +86,40 @@ attributes listed below: Header ^^^^^^^ .. list-table:: - :widths: 20 60 20 + :widths: 20 80 :header-rows: 1 * - **Key** - **Value** - * - **alg** + * - alg - Algorithm used to verify the token signature. It MUST be one of the possibile values indicated `here `_ (e.g., ES256). - * - **kid** + * - kid - Thumbprint of the public key used for signing. - * - **typ** + * - typ - Media type, set to ``entity-statement+jwt``. Payload ^^^^^^^ .. list-table:: - :widths: 20 60 20 + :widths: 20 80 :header-rows: 1 * - **Key** - **Value** - * - **iss** + * - iss - Public URL of the Wallet Provider. - * - **sub** + * - sub - Public URL of the Wallet Provider. - * - **iat** + * - iat - Issuance datetime in Unix Timestamp format. - * - **exp** + * - exp - Expiration datetime in Unix Timestamp format. - * - **authority_hints** + * - authority_hints - Array of URLs (String) containing the list of URLs of the immediate superior Entities, such as the Trust Anchor or an Intermediate, that MAY issue an Entity Statement related to this subject. - * - **jwks** + * - jwks - A JSON Web Key Set (JWKS) `RFC 7517 `_ that represents the public part of the signing keys of the Entity at issue. Each JWK in the JWK set MUST have a key ID (claim kid). - * - **metadata** + * - metadata - Contains the metadata ``wallet_provider`` and the ``federation_entity`` metadata. From 57bfdda157d6d2cedefc2277f9ee412e6f18f71a Mon Sep 17 00:00:00 2001 From: cmarco0 <146938645+cmarco0@users.noreply.github.com> Date: Tue, 21 May 2024 18:05:59 +0200 Subject: [PATCH 4/7] editorial change in hypertext --- docs/en/wallet-solution.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/wallet-solution.rst b/docs/en/wallet-solution.rst index 6925d50d2..bd47e6906 100644 --- a/docs/en/wallet-solution.rst +++ b/docs/en/wallet-solution.rst @@ -92,7 +92,7 @@ Header * - **Key** - **Value** * - alg - - Algorithm used to verify the token signature. It MUST be one of the possibile values indicated `here `_ (e.g., ES256). + - Algorithm used to verify the token signature. It MUST be one of the possibile values indicated here [here](https://italia.github.io/eudi-wallet-it-docs/versione-corrente/en/algorithms.html) (e.g., ES256). * - kid - Thumbprint of the public key used for signing. * - typ From 762729ea814f910f938e111e3e06f9ce7d29f1bc Mon Sep 17 00:00:00 2001 From: cmarco0 <146938645+cmarco0@users.noreply.github.com> Date: Fri, 24 May 2024 14:31:02 +0200 Subject: [PATCH 5/7] Editorial update change from markdown hyperlink form to RST hyperlink form --- docs/en/wallet-solution.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/wallet-solution.rst b/docs/en/wallet-solution.rst index bd47e6906..6925d50d2 100644 --- a/docs/en/wallet-solution.rst +++ b/docs/en/wallet-solution.rst @@ -92,7 +92,7 @@ Header * - **Key** - **Value** * - alg - - Algorithm used to verify the token signature. It MUST be one of the possibile values indicated here [here](https://italia.github.io/eudi-wallet-it-docs/versione-corrente/en/algorithms.html) (e.g., ES256). + - Algorithm used to verify the token signature. It MUST be one of the possibile values indicated `here `_ (e.g., ES256). * - kid - Thumbprint of the public key used for signing. * - typ From 25e5583852d91014c2dd4ac46f8449506a6064d5 Mon Sep 17 00:00:00 2001 From: cmarco0 <146938645+cmarco0@users.noreply.github.com> Date: Fri, 24 May 2024 14:37:27 +0200 Subject: [PATCH 6/7] editorial update changed the hyperlink word from *here* to *table* --- docs/en/wallet-solution.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/wallet-solution.rst b/docs/en/wallet-solution.rst index 6925d50d2..be339541f 100644 --- a/docs/en/wallet-solution.rst +++ b/docs/en/wallet-solution.rst @@ -92,7 +92,7 @@ Header * - **Key** - **Value** * - alg - - Algorithm used to verify the token signature. It MUST be one of the possibile values indicated `here `_ (e.g., ES256). + - Algorithm used to verify the token signature. It MUST be one of the possibile values indicated in this `table `_ (e.g., ES256). * - kid - Thumbprint of the public key used for signing. * - typ From ba64121c9f9922715d782ba59b9bc78055b4aaa6 Mon Sep 17 00:00:00 2001 From: cmarco0 <146938645+cmarco0@users.noreply.github.com> Date: Mon, 27 May 2024 11:06:37 +0200 Subject: [PATCH 7/7] editorial update added RCF reference added RCF reference from standards.rst --- docs/en/wallet-solution.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/wallet-solution.rst b/docs/en/wallet-solution.rst index be339541f..6bcade214 100644 --- a/docs/en/wallet-solution.rst +++ b/docs/en/wallet-solution.rst @@ -94,7 +94,7 @@ Header * - alg - Algorithm used to verify the token signature. It MUST be one of the possibile values indicated in this `table `_ (e.g., ES256). * - kid - - Thumbprint of the public key used for signing. + - Thumbprint of the public key used for signing, according to :ref:`rfc7638`. * - typ - Media type, set to ``entity-statement+jwt``.