From ff834c50547e30b8060a0d49b7fca4a71158d514 Mon Sep 17 00:00:00 2001 From: Marcos Caceres Date: Wed, 7 Aug 2024 14:19:53 +1000 Subject: [PATCH 1/4] Define registry inclusion rules --- index.html | 107 +++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 103 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index 498ffef..a10a100 100644 --- a/index.html +++ b/index.html @@ -388,9 +388,101 @@

Inclusion criteria

+ +

+ To be included in the registry, the [=digital credential/exchange + protocol=]: +

+
    +
  1. MUST be standardized at a recognized standards organization and have + a stable URL. +
    2. +
  2. MUST define a [[WebIDL]] [=dictionary=] representation of the + [=digital credential/exchange protocol=] request structure (i.e., the + [=dictionary=] to which the {{DigitalCredentialsProvider}}'s + {{DigitalCredentialsProvider/request}} is [=converted to idl + values|converted=] to before it is passed onto underlying platform). +
    3. +
  3. MUST define a [[WebIDL]] [=dictionary=] representation of the + [=digital credential/exchange protocol=] response structure (i.e., the + [=dictionary=] to which the {{DigitalCredential}}'s + {{DigitalCredential/data}} is [=converted to idl values|=] to before it + is made available to the relying party). +
    4. +
  4. MUST define validation rules for members of the request and response + structures. +
    5. +
  5. MUST have undergone privacy review by the W3C's Privacy Interest + Group and Federated Identity Working Group. +
    6. +
  6. MUST have undergone security review by the Federated Identity Working + Group. +
    7. +
  7. MUST have implementation commitment from at least two implementers in + independent browser engines, to meet the W3C's adequate implementation + experience requirements. +
    8. +
  8. MUST have formally recorded consensus by the Working Group to be + included in the registry. +
    9. +
+

+ Once the above criteria are met, the protocol will be included in the + registry. +

+

+ Change process +

- To be included in the registry... + To add a new [=digital credential/exchange protocol=]to the registry, or + to update an existing one:

+
+
+ Define a protocol identifier +
+
+ The protocol identifier MUST be a unique string that is not already in + use in the registry. Use only lowercase ASCII letters, digits, and + hyphens (e.g., "protocol", "the-protocol"). Avoid using version numbers + in the protocol identifier. +
+
+ Link to a Web IDL request dictionary +
+
+ The Web IDL request dictionary MUST be a [=dictionary=] that + defines the structure of the request that is passed, via + {{DigitalCredentialsProvider}}'s + {{DigitalCredentialsProvider/request}}, to the holder's a digital + wallet. +
+
+ Link to a Web IDL response dictionary +
+
+ The Web IDL response dictionary MUST be a [=dictionary=] + that defines the structure of {{DigitalCredential}}'s + {{DigitalCredential/data}}. +
+
+ Describe the protocol +
+
+ The description MUST be a brief summary of the protocol's purpose and + use case. +
+
+ Provide a link to the specification +
+
+ The specification MUST be a stable URL that points to the authoritative + source for the protocol, including validation rules. +
+

[=User agents=] MUST support the following [=digital credential/exchange @@ -404,13 +496,20 @@

- Protocol identifier + Protocol + identifier + + + Web IDL request + dictionary - Description + Web IDL response + dictionary - Specification + Specification From b808c7d8b0ba39a03fb089385fed9edd04780539 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Tue, 13 Aug 2024 17:00:25 +1000 Subject: [PATCH 2/4] Update index.html Co-authored-by: Tim Cappalli --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index a10a100..4699812 100644 --- a/index.html +++ b/index.html @@ -397,7 +397,7 @@

protocol=]:

    -
  1. MUST be standardized at a recognized standards organization and have +
  2. MUST be standardized at a recognized standards development organization and have a stable URL.
  3. MUST define a [[WebIDL]] [=dictionary=] representation of the From dbdffb7741050d50f0c8acd6783561d57b0cca51 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Tue, 13 Aug 2024 17:00:35 +1000 Subject: [PATCH 3/4] Update index.html Co-authored-by: Ted Thibodeau Jr --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 4699812..41b4de0 100644 --- a/index.html +++ b/index.html @@ -409,7 +409,7 @@

  4. MUST define a [[WebIDL]] [=dictionary=] representation of the [=digital credential/exchange protocol=] response structure (i.e., the [=dictionary=] to which the {{DigitalCredential}}'s - {{DigitalCredential/data}} is [=converted to idl values|=] to before it + {{DigitalCredential/data}} is [=converted to idl values|converted=] before it is made available to the relying party).
  5. MUST define validation rules for members of the request and response From f83e9ca2f233ff553b828cfc8b9fb0db1d153c7e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Tue, 13 Aug 2024 17:00:57 +1000 Subject: [PATCH 4/4] Update index.html Co-authored-by: Tim Cappalli --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 41b4de0..f51db06 100644 --- a/index.html +++ b/index.html @@ -437,7 +437,7 @@

    Change process

    - To add a new [=digital credential/exchange protocol=]to the registry, or + To add a new [=digital credential/exchange protocol=] to the registry, or to update an existing one: