diff --git a/index.html b/index.html index ca705cdbf..16a6f4e7a 100644 --- a/index.html +++ b/index.html @@ -1493,7 +1493,7 @@

Credential Subject

-
credentialSubject
+
credentialSubject
The value of the credentialSubject property is defined as a set of objects that MUST contain one or more claims that are each related to a @@ -1569,7 +1569,7 @@

Issuer

-
issuer
+
issuer
The value of the issuer property MUST be either a URL or an object containing an id property. It is @@ -1650,7 +1650,7 @@

Validity Period

-
validFrom
+
validFrom
If present, the value of the validFrom property MUST be an [XMLSCHEMA11-2] @@ -1660,7 +1660,7 @@

Validity Period

at which the information associated with the credentialSubject property becomes valid.
-
validUntil
+
validUntil
If present, the value of the validUntil property MUST be an [XMLSCHEMA11-2] @@ -1896,7 +1896,7 @@

Status

-
credentialStatus
+
credentialStatus
If present, the value of the credentialStatus property MUST include the following: @@ -1996,14 +1996,14 @@

Presentations

VerifiablePresentation, but additional types MAY be included. The related normative guidance in Section MUST be followed.
-
verifiableCredential
+
verifiableCredential
The verifiableCredential property MAY be present. The value MUST be an array of one or more verifiable credentials, or of data derived from verifiable credentials in a cryptographically verifiable format.
-
holder
+
holder
The verifiable presentation MAY include a holder property. If present, the value MUST be either a URL or an object @@ -2903,7 +2903,7 @@

Refreshing

-
refreshService
+
refreshService
The value of the refreshService property MUST be one or more refresh services that provides enough information to the recipient's software @@ -2991,7 +2991,7 @@

Terms of Use

-
termsOfUse
+
termsOfUse
The value of the termsOfUse property MUST specify one or more terms of use policies under which the creator issued the credential @@ -3154,7 +3154,7 @@

Evidence

-
evidence
+
evidence
The value of the evidence property MUST be one or more evidence schemes providing enough information for a verifier to determine diff --git a/vocab/credentials/v2/template.html b/vocab/credentials/v2/template.html index 3e529b349..0b7c893c1 100644 --- a/vocab/credentials/v2/template.html +++ b/vocab/credentials/v2/template.html @@ -133,7 +133,15 @@ archives).

-
+
+

Specification of terms

+

+ In general, the terms — i.e., the properties and classes — used in the VCDM are formally specified in Recommendation Track documents published by the W3C Verifiable Credentials Working Group or, for some deprecated or reserved terms, in Reports published by the W3C Credentials Community Group. In each case of such external definition, the term's description in this document contains a link to the relevant specification. Additionally, the `rdfs:definedBy` property in the RDFS representation(s) refers to the formal specification. +

+

+ In some cases, a local explanation is necessary to complement, or to replace, the definition found in an external specification. For instance, this is so when the term is needed to provide a consistent structure to the RDFS vocabulary, such as when the term defines a common supertype for class instances that are used as objects of specific properties, or when RDF Graphs are involved. For such cases, the extra definition is included in the current document (and the `rdfs:comment` property is used to include them in the RDFS representations). +

+

Namespaces

This specification makes use of the following namespaces:

@@ -142,40 +150,62 @@

Namespaces

-

Term definitions

+

Regular terms

Class definitions

- +

Property definitions

- +

Definitions for individuals

-
+ + +
+

Reserved term definitions

+ +

All terms in this section are + reserved. + Implementers may use these properties, but should expect them and/or their meanings to change during the process to + normatively specify them. +

+ +
+

Reserved classes

+
+ +
+

Reserved properties

+
+ +
+

Reserved individuals

+
+
-

Deprecated term definitions

+

Deprecated terms

-

All terms in this section are deprecated, and are only kept in this vocabulary for backward compatibility. +

All terms in this section are deprecated, and are only kept in this vocabulary for backward compatibility.
New applications should not use them.

Deprecated classes

- +

Deprecated properties

- +

Deprecated individuals

-
+ diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index ddc7a584a..305711062 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -2,9 +2,9 @@ vocab: - id: cred value: https://w3.org/2018/credentials# -prefix: - - id: odrl - value: http://www.w3.org/ns/odrl/2/ +# prefix: +# - id: odrl +# value: http://www.w3.org/ns/odrl/2/ ontology: - property: dc:title @@ -17,160 +17,144 @@ ontology: value: https://www.w3.org/TR/vc-data-model-2.0/ class: - - id: JsonSchemaValidator2018 - label: Json schema validator 2018 - upper_value: cred:CredentialSchema - deprecated: true - comment: A type of validator that can be used to syntactically validate JSON documents using the JSON Schema language. - - - id: JsonSchema2023 - label: JSON schema validator 2023 - upper_value: cred:CredentialSchema - comment: A type of validator that can be used to syntactically validate JSON documents using the JSON Schema language. - - - id: VerifiableCredentialSchema2023 - label: Credential schema validator 2023 - comment: A type of validator that can be used to syntactically validate JSON documents packaged as Verifiable Credentials using the JSON Schema language. - - - id: ManualRefreshService2018 - label: Manual refresh service 2018 - upper_value: cred:RefreshService - deprecated: true - comment: A type of Refresh Service that must be interacted with in a manual fashion. - - - id: RefreshService - label: Refresh service - comment: A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential. + - id: CredentialEvidence + label: Credential Evidence + comment: A Credential Evidence provides evidence schemes that are used by the evidence property. This class serves as a supertype for specific evidence types. - id: CredentialSchema label: Credential schema - comment: A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema. + comment: A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema. This class serves as a supertype for specific schemas (e.g., JsonSchema2023). - id: CredentialStatus label: Credential status - comment: A Credential Status provides enough information to determine the current status of the credential (for example, suspended or revoked). It MUST include the `id` property, which MUST be a URL, and the `type` property, which expresses the credential status type (also referred to as the credential status scheme) + 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: JsonSchema2023 + label: JSON schema validator 2023 + defined_by: https://www.w3.org/TR/vc-json-schema/#jsonschema2023 + upper_value: cred:CredentialSchema + comment: A type of validator for the validation of Verifiable Credentials, based on JSON Schema. - - id: StatusList2021Entry - label: Status List 2021 Entry - comment: A Status List 2021 Entry provides issuers with a mechanism to provide status information for verifiable credentials. + - id: RefreshService + label: Refresh service + comment: A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential. This class serves as a supertype for specific refresh service types. - - id: StatusList2021Credential - label: Status List 2021 Credential - comment: A Status List 2021 Credential provides issuers with a mechanism to publish a verifiable credential which encapsulates a status list. + - id: TermsOfUse + label: Terms of use + comment: Policy under which the creator issued the credential or presentation. This class serves as a supertype for specific types for terms of use. - - id: CredentialEvidence - label: Credential evidence - comment: A Credential Evidence scheme provides enough information to a verifier to determine whether the evidence gathered meets their requirements for issuing a credential. The precise content of each evidence scheme is determined by the specific evidence type definition. + # - id: StatusList2021Entry + # label: Status List 2021 Entry + # comment: A Status List 2021 Entry provides issuers with a mechanism to provide status information for verifiable credentials. - id: VerifiableCredential + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#credentials label: Verifiable credential - comment: | - A Credential is a set of one or more claims made by an issuer. A Verifiable Credential is a tamper-evident credential that has authorship that can be cryptographically verified. Verifiable Credentials can be used to build Verifiable Presentations, which can also be cryptographically verified. - id: VerifiableCredentialGraph label: Verifiable credential graph - comment: Instances of this class are RDF Graphs, where each of these graphs must include exactly one Verifiable Credential + comment: Instances of this class are RDF Graphs [[RDF12-CONCEPTS]], where each of these graphs must include exactly one Verifiable Credential. - id: VerifiablePresentation + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#presentations label: Verifiable presentation - comment: | - A Presentation is data derived from one or more Credentials, issued by one or more `issuers`, that is shared with a specific `verifier`. A Verifiable Presentation is a tamper-evident Presentation encoded in such a way that authorship of the data can be trusted after a process of cryptographic verification. Certain types of verifiable presentations might contain data that is synthesized from, but do not contain, the original verifiable credentials (for example, zero-knowledge proofs). property: - id: credentialSchema label: Credential schema + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-credentialSchema domain: cred:VerifiableCredential range: cred:CredentialSchema - comment: The value of the `credentialSchema` property MUST be one or more Credential schema instances. - id: credentialStatus label: Credential status + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-credentialStatus domain: cred:VerifiableCredential range: cred:CredentialStatus - comment: The value of the `credentialStatus` property MUST be an instance of a Credential status. - id: credentialSubject label: Credential subject + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-credentialSubject domain: cred:VerifiableCredential range: IRI comment: An entity about which claims are made. - id: evidence label: Evidence + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-evidence domain: cred:VerifiableCredential + status: reserved range: cred:CredentialEvidence - comment: The value of the `evidence` property MUST be one or more Credential evidence instances. - id: expirationDate label: Expiration date - domain: cred:VerifiableCredential + defined_by: https://www.w3.org/TR/2022/REC-vc-data-model-20220303/#expiration range: xsd:dateTime deprecated: true - comment: The value of the `expirationDate` property was used to express the date and time the credential ceases to be valid. It has been deprecated in favor of `validUntil` + comment: The value of this property was used in the past to express the date and time the credential ceased to be valid. It has been deprecated in favor of validUntil - id: holder label: Holder domain: cred:VerifiablePresentation + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-holder range : IRI - comment: | - The value of the `holder` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the holder that can be used to verify the information expressed in the credential. - id: issuanceDate label: Issuance date - domain: cred:VerifiableCredential + defined_by: https://www.w3.org/TR/2022/REC-vc-data-model-20220303/#issuance-date range: xsd:dateTime deprecated: true - comment: | - The value of the `issuanceDate` property was used to represents the earliest date when the information associated with the `credentialSubject` property became valid. This property has been deprecated in favour of `validFrom`. - - - id: issued - label: issue date - domain: cred:VerifiableCredential - range: xsd:dateTime - comment: | - The value of the `issued` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential was issued. Note that this date represents the earliest date when the information associated with the credentialSubject property became valid. This property has been deprecated in favor of validFrom. - id: issuer - label: issuer + label: Issuer + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-issuer domain: cred:VerifiableCredential range: IRI - comment: | - The value of the `issuer` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the issuer that can be used to verify the information expressed in the credential. + comment: The value of this property must be a URL uniquely identifying the issuer. - id: refreshService - label: refresh service + label: Refresh service + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-refreshService + domain: cred:VerifiableCredential + status: reserved + range: cred:RefreshService + + - id: renderMethod + label: Render method domain: cred:VerifiableCredential + defined_by: https://w3c-ccg.github.io/vc-render-method/#the-rendermethod-property + status: reserved range: cred:RefreshService - comment: The value of the `refreshService` property MUST be one or more Refresh Service instances such that the holder can refresh the credential. - id: serviceEndpoint - label: service endpoint + label: Service endpoint domain: cred:RefreshService range: IRI - comment: The value of the `serviceEndpoint` property MUST be a URL to the service endpoint associated with the subject. + comment: The value of this property must be a URL to the service endpoint associated with the subject. There is no URL yet in a VCWG document to define this term. - id: termsOfUse - label: terms of use - domain: cred:VerifiableCredential,cred:VerifiablePresentation - range: odrl:Policy - comment: | - If specified, the value of the optional `termsOfUse` property MUST specify one or more terms of use policies under which the issuer issued the credential or presentation. Each `termsOfUse` policy MUST specify its type (for example, `IssuerPolicy`) and MAY specify its instance `id`. The precise content of each term of use is determined by the specific `TermsOfUse` type definition. If the recipient (a holder or verifier) violates the specified terms of use, the responsibility is their own, and such violation may incur legal liability. + label: Terms of use + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-termsOfUse + domain: [cred:VerifiableCredential, cred:VerifiablePresentation] + status: reserved + range: cred:TermsOfUse - id: validFrom label: Valid from - domain: cred:VerifiableCredential + domain: [cred:VerifiableCredential, cred:VerifiablePresentation] + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-validFrom range: xsd:dateTime - comment: | - The value of the `validFrom` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential was issued. Note that this date represents the earliest date when the information associated with the Verifiable credential graph (informally, it indirectly identifies a Verifiable credential contained in a separate graph). + comment: The value of this property identifies a Verifiable credential graph. (Informally, it indirectly identifies a Verifiable credential contained in a separate graph.)