From 22e373048f96f18db8f7a8b71023dbcb1f28a924 Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Wed, 2 Aug 2023 13:21:36 -0400 Subject: [PATCH 1/7] Add section on Ecosystem Compatibility. (#1203) 17 approvals, open for more than a week, no objections during the Special topic call on 08-01-2023 * Add section on Ecosystem Compatibility. * Fix grammar in Ecosystem Compatibility section. Co-authored-by: Ted Thibodeau Jr * Add references to "digital credentials" specifications. * Update Ecosystem Compatibility based on VCWG Special Topic call. * Add clarification around when a transformation becomes a VC. * Add note about what constitutes a verifiable credential. * Clarify that a conforming document has two possible media types. * Clarify that JOSE, COSE, wrapped conforming documents are VCs/VPs. * Clarify which specs need to follow the ecosystem guidelines. Co-authored-by: Dave Longley * Remove vague statement about "any securing mechanism" per @jandrieu. Co-authored-by: Joe Andrieu * Apply editorial suggestions from @Sakurann to Ecosystem Compatibility. Co-authored-by: Kristina <52878547+Sakurann@users.noreply.github.com> --------- Co-authored-by: Ted Thibodeau Jr Co-authored-by: Dave Longley Co-authored-by: Joe Andrieu Co-authored-by: Kristina <52878547+Sakurann@users.noreply.github.com> --- index.html | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 77 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index ca7271b45..4274a8071 100644 --- a/index.html +++ b/index.html @@ -2230,7 +2230,7 @@

Data Schemas

If multiple schemas are present, validity is determined according to the -processing rules outlined by each associated credentialSchema +processing rules outlined by each associated credentialSchema type property.

@@ -3625,6 +3625,82 @@

Reserved Extension Points

+ +
+

Ecosystem Compatibility

+ +

+There are a number of digital credential formats that do not natively use the +data model provided in this document, but are aligned with a number of concepts +in this specification. At the time of publication, examples of these digital +credential formats include + +JSON Web Tokens (JWTs), + +CBOR Web Tokens (CWTs), +ISO-18013-5:2021 +(mDLs), + +AnonCreds, + +Gordian Envelopes, and + +Authentic Chained Data Containers (ACDCs). +

+ +

+If conceptually aligned digital credential formats can be transformed into a +conforming document according to the rules provided in this section, they +are considered "compatible with the W3C Verifiable Credentials ecosystem". +A conforming document is either a verifiable credential serialized +as the `application/vc+ld+json` media type or a verifiable presentation +serialized as the `application/vp+ld+json` media type. Specifications that +describe how to perform transformations that enable compatibility with +the Verifiable Credentials ecosystem: +

+ +
    +
  • +MUST identify whether the transformation to this data model is one-way-only or +round-trippable. +
    • +
  • +MUST preserve the `@context` values when performing round-trippable +transformation. +
    • +
  • +MUST result in a conforming document when transforming to the data +model described by this specification. +
    • +
  • +MUST specify a registered media type for the input document. +
    • +
  • +SHOULD provide a test suite that demonstrates that the specified transformation +algorithm to the data model in this specification results in +a conforming document. +
    • +
  • +SHOULD ensure that all semantics utilized in the transformed +conforming document follow best practices for Linked Data. See +Section , Section +, and Linked Data Best Practices [[?LD-BP]] +for additional guidance. +
    • +
+ +

+Readers are advised that a digital credential is only considered +compatible with the W3C Verifiable Credentials ecosystem if it is a +conforming document and it utilizes at least one securing mechanism, as +described by their respective requirements in this specification. While some communities might call some digital +credential formats that are not conforming documents +"verifiable credentials", doing so does NOT make that digital credential +compliant to this specification. +

+ +
+
From 6592f3b3aea7ec482f76a9ab2fe45af9313ef574 Mon Sep 17 00:00:00 2001 From: Orie Steele Date: Tue, 6 Jun 2023 13:28:35 -0500 Subject: [PATCH 2/7] Update reservation table --- contexts/credentials/v2 | 6 +++++- index.html | 20 +++++++++++++++++++- 2 files changed, 24 insertions(+), 2 deletions(-) diff --git a/contexts/credentials/v2 b/contexts/credentials/v2 index 69c14cbd8..3c8ba2a80 100644 --- a/contexts/credentials/v2 +++ b/contexts/credentials/v2 @@ -41,7 +41,7 @@ "credentialStatus": { "@id": "https://www.w3.org/2018/credentials#credentialStatus", "@type": "@id" - }, + }, "credentialSubject": { "@id": "https://www.w3.org/2018/credentials#credentialSubject", "@type": "@id" @@ -80,6 +80,10 @@ "termsOfUse": { "@id": "https://www.w3.org/2018/credentials#termsOfUse", "@type": "@id" + }, + "confidenceMethod": { + "@id": "https://www.w3.org/2018/credentials#confidenceMethod", + "@type": "@id" } } }, diff --git a/index.html b/index.html index 4274a8071..fdab49eb2 100644 --- a/index.html +++ b/index.html @@ -3555,6 +3555,23 @@

Reserved Extension Points

+ + `confidenceMethod` + +A property used for specifying one or more methods that a verifier +might rely on in order to authenticate the holder of a presentation. +The associated vocabulary URL MUST be +`https://www.w3.org/2018/credentials#confidenceMethod`. +

+This property reservation might be deleted in favor of an existing section +in the specification if at least one specification with two independent +implementations are demonstrated by the end of the Candidate Recommendation +Phase. If that does not occur, this reservation will remain, but the existing +section in the specification will be removed. +See Verifiable Credential Confidence Methods. +

+ + `evidence` @@ -3588,13 +3605,14 @@

Reserved Extension Points

`renderMethod` -A property used for specifying how to render a credential into a visual, +A property used for specifying one or more methods to render a credential into a visual, auditory, or haptic format. The associated vocabulary URL MUST be `https://www.w3.org/2018/credentials#renderMethod`.

This reserved property is at risk and will be removed from the specification if at least one specification with two independent implementations are not demonstrated by the end of the Candidate Recommendation Phase. +See Verifiable Credential Rendering Methods.

From 0ca0f708606a0d32de1ddf277d39d698c2061456 Mon Sep 17 00:00:00 2001 From: Orie Steele Date: Tue, 6 Jun 2023 13:29:38 -0500 Subject: [PATCH 3/7] Update contexts/credentials/v2 --- contexts/credentials/v2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contexts/credentials/v2 b/contexts/credentials/v2 index 3c8ba2a80..3148253fa 100644 --- a/contexts/credentials/v2 +++ b/contexts/credentials/v2 @@ -41,7 +41,7 @@ "credentialStatus": { "@id": "https://www.w3.org/2018/credentials#credentialStatus", "@type": "@id" - }, + }, "credentialSubject": { "@id": "https://www.w3.org/2018/credentials#credentialSubject", "@type": "@id" From 839c3b459ad90b05437cd9034a8434bd3f5327f5 Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Tue, 1 Aug 2023 18:16:18 -0400 Subject: [PATCH 4/7] Update URL to add confidenceMethod specification. --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index fdab49eb2..b93bb8a9a 100644 --- a/index.html +++ b/index.html @@ -3568,7 +3568,7 @@

Reserved Extension Points

implementations are demonstrated by the end of the Candidate Recommendation Phase. If that does not occur, this reservation will remain, but the existing section in the specification will be removed. -See Verifiable Credential Confidence Methods. +See Verifiable Credential Confidence Methods.

From f3e2b302406cbcea7b63093305f0087d030fa769 Mon Sep 17 00:00:00 2001 From: Orie Steele Date: Wed, 2 Aug 2023 12:30:13 -0500 Subject: [PATCH 5/7] Update index.html Co-authored-by: Ted Thibodeau Jr --- index.html | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index b93bb8a9a..cb3fee159 100644 --- a/index.html +++ b/index.html @@ -3559,7 +3559,10 @@

Reserved Extension Points

`confidenceMethod` A property used for specifying one or more methods that a verifier -might rely on in order to authenticate the holder of a presentation. +might use to increase their confidence that the value of an attribute in or of +a verifiable credential or verifiable presentation is accurate, including but not +limited to attributes such `initialRecipient` (a/k/a `issuee`), `presenter`, +`authorizedPresenter`, `holder`, etc. The associated vocabulary URL MUST be `https://www.w3.org/2018/credentials#confidenceMethod`.

From cf429b194ff89ae255a70cf271aac45f703f96c1 Mon Sep 17 00:00:00 2001 From: Brent Zundel Date: Wed, 2 Aug 2023 16:27:16 -0600 Subject: [PATCH 6/7] Update index.html minor typo fix. --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index cb3fee159..b104c9954 100644 --- a/index.html +++ b/index.html @@ -3561,7 +3561,7 @@

Reserved Extension Points

A property used for specifying one or more methods that a verifier might use to increase their confidence that the value of an attribute in or of a verifiable credential or verifiable presentation is accurate, including but not -limited to attributes such `initialRecipient` (a/k/a `issuee`), `presenter`, +limited to attributes such as `initialRecipient` (a/k/a `issuee`), `presenter`, `authorizedPresenter`, `holder`, etc. The associated vocabulary URL MUST be `https://www.w3.org/2018/credentials#confidenceMethod`. From 866b855c2305f9523c1dc6ab1d2237c2835061dc Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Thu, 3 Aug 2023 11:13:56 +0200 Subject: [PATCH 7/7] Added confidenceMethod --- vocab/credentials/v2/vocabulary.yml | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index 305711062..71d92164f 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -29,6 +29,12 @@ class: label: Credential status comment: A Credential Status provides enough information to determine the current status of the credential (for example, suspended or revoked). This class serves as a supertype for specific status types. + - id: ConfidenceMethod + label: Confidence method + defined_by: https://w3c-ccg.github.io/confidence-method-spec/ + comment: A Confidence Method provides enough information for a verifier to determine whether the holder can generate a verifiable presentation to increase the verifier's confidence that they are the same entity referenced by the confidence method. This class serves as a supertype for specific status types. + status: reserved + - id: JsonSchema2023 label: JSON schema validator 2023 defined_by: https://www.w3.org/TR/vc-json-schema/#jsonschema2023 @@ -79,6 +85,12 @@ property: range: IRI comment: An entity about which claims are made. + - id: confidenceMethod + label: Confidence method + defined_by: https://w3c-ccg.github.io/confidence-method-spec/ + status: reserved + range: cred:ConfidenceMethod + - id: evidence label: Evidence defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-evidence