diff --git a/README.md b/README.md index e6f0e30ab..6faaa9976 100644 --- a/README.md +++ b/README.md @@ -29,3 +29,33 @@ mailing list as well. ### Other useful links * [Public group email archive](https://lists.w3.org/Archives/Public/public-vc-wg/) + +## Process Overview for VC Data Model Pull Requests +1. For now, we will focus only on merging new errata PRs into this repository, +but encourage activity related to new features. +2. Once a PR is opened, chairs and editors make judgement call on whether +changes are substantive or editorial. +
proof
property of a
+verifiable presentation.
+In this example, the issuer has bound the verifiable credential to
+the holder (Pat) using the
+credentialSubject.id
property (rather than using the
+holder.id
property). The second proof
property in the
+verifiable presentation (with proofPurpose
of
+"authentication"
) is used by Pat to prove their relationship to the
+credentialSubject.id and thus, that they are the intended holder.
+
Implementers that are interested in understanding more about the
proof
mechanism used above can learn more in
@@ -1946,9 +1961,13 @@
proof
property ensures that
-the presentation is verifiable. For details related to the use of
-this property, see Section .
+If present, the value of the proof
property ensures that the
+presentation is verifiable. Where the issuer has bound the
+verifiable credential being presented to a specific holder, the
+proof
property
+contains verifiable data to prove the indicated holder is
+presenting the proof. For details related to the use of this property, see
+Section .
Subjects of verifiable credentials are identified using the
-credential.credentialSubject.id
field. The identifiers used to
-identify a subject create a greater risk of correlation when the
-identifiers are long-lived or used across more than one web domain.
+credential.credentialSubject.id
field. Holders of
+verifiable credentials are identified using the
+credential.holder.id
field. The identifiers used to identify a
+subject and/or holder create a greater risk of correlation when
+the identifiers are long-lived or used across more than one web domain.
@@ -4035,10 +4067,10 @@
-Verifiable credentials might contain long-lived identifiers that could -be used to correlate individuals. These types of identifiers include -subject identifiers, email addresses, government-issued identifiers, -organization-issued identifiers, addresses, healthcare vitals, +Verifiable credentials might contain long-lived identifiers that could be +used to correlate individuals. These types of identifiers include +subject and holder identifiers, email addresses, government-issued +identifiers, organization-issued identifiers, addresses, healthcare vitals, verifiable credential-specific JSON-LD contexts, and many other sorts of long-lived identifiers.
@@ -4181,9 +4213,8 @@
Verifiable credentials that are bearer credentials are made
-possible by not specifying the subject identifier, expressed using the
-id
property, which is nested in the
-credentialSubject
property. For example, the following
+possible by not specifying either the credentialSubject.id
or
+holder.id
identifiers. For example, the following
verifiable credential is a bearer credential:
-In the verifiable credentials presented by a holder, the value
-associated with the id
property for each
-credentialSubject
is expected to identify a subject to the
-verifier. If the holder is also the subject, then
-the verifier could authenticate the holder if they have
-public key metadata related to the holder. The verifier could then
-authenticate the holder using a signature generated by the holder
-contained in the verifiable presentation. The id
-property is optional. Verifiers could use other properties
-in a verifiable credential to uniquely identify a subject.
+An issuer may indicate that a verifiable credential has been
+issued to a specific holder using the holder
+property. Alternatively, when the holder is the subject,
+the credentialSubject.id
property could be used for the same
+purpose, ideally paired with the nonTransferable
property.
+When such verifiable credentials are used to produce a verifiable
+presentation, the
+verifier may authenticate the holder (or holder subject)
+using a holder-generated signature in the proof
property of
+the verifiable presentation.
+
+Where there is no issuer-designated holder the verifiable
+credential can be transferred to other holders, and no holder
+authentication is necessary by the verifier.
@@ -5049,6 +5084,20 @@
+In the verifiable credentials presented by a holder, the value
+associated with the id
property for each
+credentialSubject
is expected to identify a subject to the
+verifier. The id
property is optional. Verifiers
+could use other properties in a verifiable credential to uniquely
+identify a subject.
+