From 6bfde2b405f560e6a02d57046044386ec0546532 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Fri, 28 Oct 2022 10:26:11 +0200 Subject: [PATCH] adding validFrom/validUntil to the v2 vocabulary --- vocab/credentials/v2/vocabulary.html | 12 ++-- vocab/credentials/v2/vocabulary.jsonld | 86 ++++++++++++++++++-------- vocab/credentials/v2/vocabulary.ttl | 70 +++++++++++++-------- vocab/credentials/v2/vocabulary.yml | 61 +++++++++++------- 4 files changed, 149 insertions(+), 80 deletions(-) diff --git a/vocab/credentials/v2/vocabulary.html b/vocab/credentials/v2/vocabulary.html index 016a79321..a22426d20 100644 --- a/vocab/credentials/v2/vocabulary.html +++ b/vocab/credentials/v2/vocabulary.html @@ -109,7 +109,7 @@ JSON-LD.

-
Published:
+
Published:
Version Info:
2.0
See Also: https://www.w3.org/TR/vc-data-model-2.0/
@@ -139,11 +139,11 @@

Term definitions

Class definitions

-

The following are class definitions in the cred namespace:

RefreshServiceRefresh Service

A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential.

CredentialSchemaCredential Schema

A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema.

CredentialStatusCredential Status

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)

CredentialEvidenceCredential Evidence

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.

VerifiableCredentialVerifiable Credential

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.

VerifiableCredentialGraphVerifiable Credential Graph

Instances of this class are RDF Graphs, where each of these graphs must include exactly one Verifiable Credential

VerifiablePresentationVerifiable Presentation

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).

+

The following are class definitions in the cred namespace:

RefreshServiceRefresh service

A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential.

CredentialSchemaCredential schema

A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema.

CredentialStatusCredential status

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)

CredentialEvidenceCredential evidence

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.

VerifiableCredentialVerifiable credential

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.

VerifiableCredentialGraphVerifiable credential graph

Instances of this class are RDF Graphs, where each of these graphs must include exactly one Verifiable Credential

VerifiablePresentationVerifiable presentation

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 definitions

-

The following are property definitions in the cred namespace:

credentialSchemacredential schema

The value of the `credentialSchema` property MUST be one or more Credential Schema instances.

Range:
cred:CredentialSchema
Domain:
cred:VerifiableCredential
credentialStatuscredential status

The value of the `credentialStatus` property MUST be an instance of Credential Status.

Range:
cred:CredentialStatus
Domain:
cred:VerifiableCredential
credentialSubjectcredential subject

An entity about which claims are made.

Domain:
cred:VerifiableCredential
evidenceevidence

The value of the `evidence` property MUST be one or more Credential Evidence instances.

Range:
cred:CredentialEvidence
Domain:
cred:VerifiableCredential
expirationDateexpiration date

The value of the `expirationDate` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential ceases to be valid.

Range:
xsd:dateTime
Domain:
cred:VerifiableCredential
holderholder

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.
The property's value should be a URL, i.e., not a literal.

Domain:
Union of:
cred:VerifiableCredential
cred:VerifiablePresentation
issuanceDateissuance date

The value of the `issuanceDate` 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.

Range:
xsd:dateTime
Domain:
cred:VerifiableCredential
issuedissue date

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.

Range:
xsd:dateTime
Domain:
cred:VerifiableCredential
issuerissuer

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.
The property's value should be a URL, i.e., not a literal.

Domain:
cred:VerifiableCredential
refreshServicerefresh service

The value of the `refreshService` property MUST be one or more Refresh Service instances such that the holder can refresh the credential.

Range:
cred:RefreshService
Domain:
cred:VerifiableCredential
serviceEndpointservice endpoint

The value of the `serviceEndpoint` property MUST be a URL to the service endpoint associated with the subject.
The property's value should be a URL, i.e., not a literal.

Domain:
cred:RefreshService
termsOfUseterms of use

If specified, the value of the `termsOfUse` property MUST specify one or more terms of use policies under which the creator issued the credential or presentation. If the recipient (a holder or verifier) is not willing to adhere to the specified terms of use, then they do so on their own responsibility and might incur legal liability if they violate the stated Terms of Use. Each `termsOfUse` MUST specify its type, for example, `IssuerPolicy`, and optionally, its instance `id`. The precise contents of each term of use is determined by the specific `TermsOfUse` type definition.

Range:
odrl:Policy
Domain:
cred:VerifiableCredential
verifiableCredentialverifiable credential

The value of the `verifiableCredential` property MUST identify a Verifiable Credential Graph (informally, it indirectly identifies a Verifiable Credential contained in a separate graph).

Range:
cred:VerifiableCredentialGraph
Domain:
cred:VerifiablePresentation
+

The following are property definitions in the cred namespace:

credentialSchemaCredential schema

The value of the `credentialSchema` property MUST be one or more Credential schema instances.

Range:
cred:CredentialSchema
Domain:
cred:VerifiableCredential
credentialStatusCredential status

The value of the `credentialStatus` property MUST be an instance of a Credential status.

Range:
cred:CredentialStatus
Domain:
cred:VerifiableCredential
credentialSubjectCredential subject

An entity about which claims are made.

Domain:
cred:VerifiableCredential
evidenceEvidence

The value of the `evidence` property MUST be one or more Credential evidence instances.

Range:
cred:CredentialEvidence
Domain:
cred:VerifiableCredential
holderHolder

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.
The property's value should be a URL, i.e., not a literal.

Domain:
Union of:
cred:VerifiableCredential
cred:VerifiablePresentation
issuedissue date

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

Range:
xsd:dateTime
Domain:
cred:VerifiableCredential
issuerissuer

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.
The property's value should be a URL, i.e., not a literal.

Domain:
cred:VerifiableCredential
refreshServicerefresh service

The value of the `refreshService` property MUST be one or more Refresh Service instances such that the holder can refresh the credential.

Range:
cred:RefreshService
Domain:
cred:VerifiableCredential
serviceEndpointservice endpoint

The value of the `serviceEndpoint` property MUST be a URL to the service endpoint associated with the subject.
The property's value should be a URL, i.e., not a literal.

Domain:
cred:RefreshService
termsOfUseterms of use

If specified, the value of the `termsOfUse` property MUST specify one or more terms of use policies under which the creator issued the credential or presentation. If the recipient (a holder or verifier) is not willing to adhere to the specified terms of use, then they do so on their own responsibility and might incur legal liability if they violate the stated Terms of Use. Each `termsOfUse` MUST specify its type, for example, `IssuerPolicy`, and optionally, its instance `id`. The precise contents of each term of use is determined by the specific `TermsOfUse` type definition.

Range:
odrl:Policy
Domain:
cred:VerifiableCredential
validFromValid from

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

Range:
xsd:dateTime
Domain:
cred:VerifiableCredential
validUntilValid until

The value of the `validUntil` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential ceases to be valid.

Range:
xsd:dateTime
Domain:
cred:VerifiableCredential
verifiableCredentialverifiable credential

The value of the `verifiableCredential` property MUST identify a Verifiable credential graph (informally, it indirectly identifies a Verifiable credential contained in a separate graph).

Range:
cred:VerifiableCredentialGraph
Domain:
cred:VerifiablePresentation
@@ -157,9 +157,11 @@

Deprecated term definitions

Deprecated classes

-

The following are deprecated class definitions in the cred namespace:

JsonSchemaValidator2018Json Schema Validator 2018 (deprecated)

A type of validator that can be used to syntactically validate JSON documents using the JSON Schema language.

true
Subclass of:
cred:CredentialSchema
ManualRefreshService2018Manual Refresh Service 2018 (deprecated)

A type of Refresh Service that must be interacted with in a manual fashion.

true
Subclass of:
cred:RefreshService
+

The following are deprecated class definitions in the cred namespace:

JsonSchemaValidator2018Json schema validator 2018 (deprecated)

A type of validator that can be used to syntactically validate JSON documents using the JSON Schema language.

true
Subclass of:
cred:CredentialSchema
ManualRefreshService2018Manual refresh service 2018 (deprecated)

A type of Refresh Service that must be interacted with in a manual fashion.

true
Subclass of:
cred:RefreshService
- +
+

Deprecated properties

+

The following are deprecated property definitions in the cred namespace:

expirationDateExpiration date (deprecated)

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`

true
Range:
xsd:dateTime
Domain:
cred:VerifiableCredential
issuanceDateIssuance date (deprecated)

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`.

true
Range:
xsd:dateTime
Domain:
cred:VerifiableCredential
diff --git a/vocab/credentials/v2/vocabulary.jsonld b/vocab/credentials/v2/vocabulary.jsonld index 3128d3404..077d39614 100644 --- a/vocab/credentials/v2/vocabulary.jsonld +++ b/vocab/credentials/v2/vocabulary.jsonld @@ -85,7 +85,7 @@ "en": "RDFS [[RDF-SCHEMA]] vocabulary used by the Verifiable Credentials [[VC-DATA-MODEL]]" }, "rdfs:seeAlso": "https://www.w3.org/TR/vc-data-model-2.0/", - "dc:date": "2022-10-27", + "dc:date": "2022-10-28", "rdfs_classes": [ { "@id": "cred:JsonSchemaValidator2018", @@ -98,7 +98,7 @@ "cred:CredentialSchema" ], "rdfs:label": { - "en": "Json Schema Validator 2018" + "en": "Json schema validator 2018" }, "rdfs:comment": { "en": "A type of validator that can be used to syntactically validate JSON documents using the JSON Schema language." @@ -115,7 +115,7 @@ "cred:RefreshService" ], "rdfs:label": { - "en": "Manual Refresh Service 2018" + "en": "Manual refresh service 2018" }, "rdfs:comment": { "en": "A type of Refresh Service that must be interacted with in a manual fashion." @@ -125,7 +125,7 @@ "@id": "cred:RefreshService", "@type": "rdfs:Class", "rdfs:label": { - "en": "Refresh Service" + "en": "Refresh service" }, "rdfs:comment": { "en": "A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential." @@ -135,7 +135,7 @@ "@id": "cred:CredentialSchema", "@type": "rdfs:Class", "rdfs:label": { - "en": "Credential Schema" + "en": "Credential schema" }, "rdfs:comment": { "en": "A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema." @@ -145,7 +145,7 @@ "@id": "cred:CredentialStatus", "@type": "rdfs:Class", "rdfs:label": { - "en": "Credential Status" + "en": "Credential status" }, "rdfs:comment": { "en": "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)" @@ -155,7 +155,7 @@ "@id": "cred:CredentialEvidence", "@type": "rdfs:Class", "rdfs:label": { - "en": "Credential Evidence" + "en": "Credential evidence" }, "rdfs:comment": { "en": "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." @@ -165,7 +165,7 @@ "@id": "cred:VerifiableCredential", "@type": "rdfs:Class", "rdfs:label": { - "en": "Verifiable Credential" + "en": "Verifiable credential" }, "rdfs:comment": { "en": "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." @@ -175,7 +175,7 @@ "@id": "cred:VerifiableCredentialGraph", "@type": "rdfs:Class", "rdfs:label": { - "en": "Verifiable Credential Graph" + "en": "Verifiable credential graph" }, "rdfs:comment": { "en": "Instances of this class are RDF Graphs, where each of these graphs must include exactly one Verifiable Credential" @@ -185,7 +185,7 @@ "@id": "cred:VerifiablePresentation", "@type": "rdfs:Class", "rdfs:label": { - "en": "Verifiable Presentation" + "en": "Verifiable presentation" }, "rdfs:comment": { "en": "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)." @@ -199,10 +199,10 @@ "rdfs:domain": "cred:VerifiableCredential", "rdfs:range": "cred:CredentialSchema", "rdfs:label": { - "en": "credential schema" + "en": "Credential schema" }, "rdfs:comment": { - "en": "The value of the `credentialSchema` property MUST be one or more Credential Schema instances." + "en": "The value of the `credentialSchema` property MUST be one or more Credential schema instances." } }, { @@ -211,10 +211,10 @@ "rdfs:domain": "cred:VerifiableCredential", "rdfs:range": "cred:CredentialStatus", "rdfs:label": { - "en": "credential status" + "en": "Credential status" }, "rdfs:comment": { - "en": "The value of the `credentialStatus` property MUST be an instance of Credential Status." + "en": "The value of the `credentialStatus` property MUST be an instance of a Credential status." } }, { @@ -222,7 +222,7 @@ "@type": "rdfs:Property", "rdfs:domain": "cred:VerifiableCredential", "rdfs:label": { - "en": "credential subject" + "en": "Credential subject" }, "rdfs:comment": { "en": "An entity about which claims are made." @@ -234,25 +234,27 @@ "rdfs:domain": "cred:VerifiableCredential", "rdfs:range": "cred:CredentialEvidence", "rdfs:label": { - "en": "evidence" + "en": "Evidence" }, "rdfs:comment": { - "en": "The value of the `evidence` property MUST be one or more Credential Evidence instances." + "en": "The value of the `evidence` property MUST be one or more Credential evidence instances." } }, { "@id": "cred:expirationDate", "@type": [ - "rdfs:Property", + "rdf:Property", + "owl:DeprecatedProperty", "owl:DatatypeProperty" ], + "owl:deprecated": true, "rdfs:domain": "cred:VerifiableCredential", "rdfs:range": "xsd:dateTime", "rdfs:label": { - "en": "expiration date" + "en": "Expiration date" }, "rdfs:comment": { - "en": "The value of the `expirationDate` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential ceases to be valid." + "en": "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`" } }, { @@ -269,7 +271,7 @@ }, "rdfs:range": [], "rdfs:label": { - "en": "holder" + "en": "Holder" }, "rdfs:comment": { "en": "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." @@ -278,16 +280,18 @@ { "@id": "cred:issuanceDate", "@type": [ - "rdfs:Property", + "rdf:Property", + "owl:DeprecatedProperty", "owl:DatatypeProperty" ], + "owl:deprecated": true, "rdfs:domain": "cred:VerifiableCredential", "rdfs:range": "xsd:dateTime", "rdfs:label": { - "en": "issuance date" + "en": "Issuance date" }, "rdfs:comment": { - "en": "The value of the `issuanceDate` 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." + "en": "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`." } }, { @@ -302,7 +306,7 @@ "en": "issue date" }, "rdfs:comment": { - "en": "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." + "en": "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 " } }, { @@ -359,6 +363,36 @@ "en": "If specified, the value of the `termsOfUse` property MUST specify one or more terms of use policies under which the creator issued the credential or presentation. If the recipient (a holder or verifier) is not willing to adhere to the specified terms of use, then they do so on their own responsibility and might incur legal liability if they violate the stated Terms of Use. Each `termsOfUse` MUST specify its type, for example, `IssuerPolicy`, and optionally, its instance `id`. The precise contents of each term of use is determined by the specific `TermsOfUse` type definition." } }, + { + "@id": "cred:validFrom", + "@type": [ + "rdfs:Property", + "owl:DatatypeProperty" + ], + "rdfs:domain": "cred:VerifiableCredential", + "rdfs:range": "xsd:dateTime", + "rdfs:label": { + "en": "Valid from" + }, + "rdfs:comment": { + "en": "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 " + } + }, + { + "@id": "cred:validUntil", + "@type": [ + "rdfs:Property", + "owl:DatatypeProperty" + ], + "rdfs:domain": "cred:VerifiableCredential", + "rdfs:range": "xsd:dateTime", + "rdfs:label": { + "en": "Valid until" + }, + "rdfs:comment": { + "en": "The value of the `validUntil` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential ceases to be valid." + } + }, { "@id": "cred:verifiableCredential", "@type": "rdfs:Property", @@ -368,7 +402,7 @@ "en": "verifiable credential" }, "rdfs:comment": { - "en": "The value of the `verifiableCredential` property MUST identify a Verifiable Credential Graph (informally, it indirectly identifies a Verifiable Credential contained in a separate graph)." + "en": "The value of the `verifiableCredential` property MUST identify a Verifiable credential graph (informally, it indirectly identifies a Verifiable credential contained in a separate graph)." } } ] diff --git a/vocab/credentials/v2/vocabulary.ttl b/vocab/credentials/v2/vocabulary.ttl index 5154c23bd..20479340c 100644 --- a/vocab/credentials/v2/vocabulary.ttl +++ b/vocab/credentials/v2/vocabulary.ttl @@ -11,14 +11,14 @@ cred: a owl:Ontology ; dc:title """Verifiable Credentials Vocabulary v2.0"""@en ; dc:description """RDFS [[RDF-SCHEMA]] vocabulary used by the Verifiable Credentials [[VC-DATA-MODEL]]"""@en ; rdfs:seeAlso ; - dc:date "2022-10-27"^^xsd:date ; + dc:date "2022-10-28"^^xsd:date ; . # Class definitions cred:JsonSchemaValidator2018 a rdfs:Class, owl:DeprecatedClass ; owl:deprecated true ; rdfs:subClassOf cred:CredentialSchema ; - rdfs:label "Json Schema Validator 2018" ; + rdfs:label "Json schema validator 2018" ; rdfs:comment """A type of validator that can be used to syntactically validate JSON documents using the JSON Schema language."""@en ; rdfs:isDefinedBy cred: ; . @@ -26,49 +26,49 @@ cred:JsonSchemaValidator2018 a rdfs:Class, owl:DeprecatedClass ; cred:ManualRefreshService2018 a rdfs:Class, owl:DeprecatedClass ; owl:deprecated true ; rdfs:subClassOf cred:RefreshService ; - rdfs:label "Manual Refresh Service 2018" ; + rdfs:label "Manual refresh service 2018" ; rdfs:comment """A type of Refresh Service that must be interacted with in a manual fashion."""@en ; rdfs:isDefinedBy cred: ; . cred:RefreshService a rdfs:Class ; - rdfs:label "Refresh Service" ; + rdfs:label "Refresh service" ; rdfs:comment """A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential."""@en ; rdfs:isDefinedBy cred: ; . cred:CredentialSchema a rdfs:Class ; - rdfs:label "Credential Schema" ; + rdfs:label "Credential schema" ; rdfs:comment """A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema."""@en ; rdfs:isDefinedBy cred: ; . cred:CredentialStatus a rdfs:Class ; - rdfs:label "Credential Status" ; + rdfs:label "Credential status" ; rdfs: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)"""@en ; rdfs:isDefinedBy cred: ; . cred:CredentialEvidence a rdfs:Class ; - rdfs:label "Credential Evidence" ; + rdfs:label "Credential evidence" ; rdfs: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."""@en ; rdfs:isDefinedBy cred: ; . cred:VerifiableCredential a rdfs:Class ; - rdfs:label "Verifiable Credential" ; + rdfs:label "Verifiable credential" ; rdfs: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."""@en ; rdfs:isDefinedBy cred: ; . cred:VerifiableCredentialGraph a rdfs:Class ; - rdfs:label "Verifiable Credential Graph" ; + rdfs:label "Verifiable credential graph" ; rdfs:comment """Instances of this class are RDF Graphs, where each of these graphs must include exactly one Verifiable Credential"""@en ; rdfs:isDefinedBy cred: ; . cred:VerifiablePresentation a rdfs:Class ; - rdfs:label "Verifiable Presentation" ; + rdfs:label "Verifiable presentation" ; rdfs: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)."""@en ; rdfs:isDefinedBy cred: ; . @@ -79,22 +79,22 @@ cred:VerifiablePresentation a rdfs:Class ; cred:credentialSchema a rdfs:Property ; rdfs:domain cred:VerifiableCredential ; rdfs:range cred:CredentialSchema ; - rdfs:label "credential schema" ; - rdfs:comment """The value of the `credentialSchema` property MUST be one or more Credential Schema instances."""@en ; + rdfs:label "Credential schema" ; + rdfs:comment """The value of the `credentialSchema` property MUST be one or more Credential schema instances."""@en ; rdfs:isDefinedBy cred: ; . cred:credentialStatus a rdfs:Property ; rdfs:domain cred:VerifiableCredential ; rdfs:range cred:CredentialStatus ; - rdfs:label "credential status" ; - rdfs:comment """The value of the `credentialStatus` property MUST be an instance of Credential Status."""@en ; + rdfs:label "Credential status" ; + rdfs:comment """The value of the `credentialStatus` property MUST be an instance of a Credential status."""@en ; rdfs:isDefinedBy cred: ; . cred:credentialSubject a rdfs:Property ; rdfs:domain cred:VerifiableCredential ; - rdfs:label "credential subject" ; + rdfs:label "Credential subject" ; rdfs:comment """An entity about which claims are made."""@en ; rdfs:isDefinedBy cred: ; . @@ -102,32 +102,34 @@ cred:credentialSubject a rdfs:Property ; cred:evidence a rdfs:Property ; rdfs:domain cred:VerifiableCredential ; rdfs:range cred:CredentialEvidence ; - rdfs:label "evidence" ; - rdfs:comment """The value of the `evidence` property MUST be one or more Credential Evidence instances."""@en ; + rdfs:label "Evidence" ; + rdfs:comment """The value of the `evidence` property MUST be one or more Credential evidence instances."""@en ; rdfs:isDefinedBy cred: ; . -cred:expirationDate a rdfs:Property, owl:DatatypeProperty ; +cred:expirationDate a rdf:Property, owl:DeprecatedProperty, owl:DatatypeProperty ; + owl:deprecated true ; rdfs:domain cred:VerifiableCredential ; rdfs:range xsd:dateTime ; - rdfs:label "expiration date" ; - rdfs:comment """The value of the `expirationDate` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential ceases to be valid."""@en ; + rdfs:label "Expiration date" ; + rdfs: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`"""@en ; rdfs:isDefinedBy cred: ; . cred:holder a rdfs:Property, owl:ObjectProperty ; rdfs:domain [ owl:unionOf (cred:VerifiableCredential cred:VerifiablePresentation) ] ; rdfs:range ; - rdfs:label "holder" ; + rdfs:label "Holder" ; rdfs: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."""@en ; rdfs:isDefinedBy cred: ; . -cred:issuanceDate a rdfs:Property, owl:DatatypeProperty ; +cred:issuanceDate a rdf:Property, owl:DeprecatedProperty, owl:DatatypeProperty ; + owl:deprecated true ; rdfs:domain cred:VerifiableCredential ; rdfs:range xsd:dateTime ; - rdfs:label "issuance date" ; - rdfs:comment """The value of the `issuanceDate` 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."""@en ; + rdfs:label "Issuance date" ; + rdfs: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`."""@en ; rdfs:isDefinedBy cred: ; . @@ -135,7 +137,7 @@ cred:issued a rdfs:Property, owl:DatatypeProperty ; rdfs:domain cred:VerifiableCredential ; rdfs:range xsd:dateTime ; rdfs:label "issue date" ; - rdfs: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."""@en ; + rdfs: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 """@en ; rdfs:isDefinedBy cred: ; . @@ -171,11 +173,27 @@ cred:termsOfUse a rdfs:Property ; rdfs:isDefinedBy cred: ; . +cred:validFrom a rdfs:Property, owl:DatatypeProperty ; + rdfs:domain cred:VerifiableCredential ; + rdfs:range xsd:dateTime ; + rdfs:label "Valid from" ; + rdfs: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 """@en ; + rdfs:isDefinedBy cred: ; +. + +cred:validUntil a rdfs:Property, owl:DatatypeProperty ; + rdfs:domain cred:VerifiableCredential ; + rdfs:range xsd:dateTime ; + rdfs:label "Valid until" ; + rdfs:comment """The value of the `validUntil` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential ceases to be valid."""@en ; + rdfs:isDefinedBy cred: ; +. + cred:verifiableCredential a rdfs:Property ; rdfs:domain cred:VerifiablePresentation ; rdfs:range cred:VerifiableCredentialGraph ; rdfs:label "verifiable credential" ; - rdfs:comment """The value of the `verifiableCredential` property MUST identify a Verifiable Credential Graph (informally, it indirectly identifies a Verifiable Credential contained in a separate graph)."""@en ; + rdfs:comment """The value of the `verifiableCredential` property MUST identify a Verifiable credential graph (informally, it indirectly identifies a Verifiable credential contained in a separate graph)."""@en ; rdfs:isDefinedBy cred: ; . diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index be8da2452..60bcd6b86 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -18,79 +18,80 @@ ontology: class: - id: JsonSchemaValidator2018 - label: Json Schema Validator 2018 + 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: ManualRefreshService2018 - label: Manual Refresh Service 2018 + 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 + 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: CredentialSchema - label: Credential Schema + label: Credential schema comment: A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema. - id: CredentialStatus - label: Credential Status + 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) - id: CredentialEvidence - label: Credential Evidence + 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: VerifiableCredential - label: Verifiable Credential + 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 + label: Verifiable credential graph comment: Instances of this class are RDF Graphs, where each of these graphs must include exactly one Verifiable Credential - id: VerifiablePresentation - label: Verifiable Presentation + 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 + label: Credential schema domain: cred:VerifiableCredential range: cred:CredentialSchema - comment: The value of the `credentialSchema` property MUST be one or more Credential Schema instances. + comment: The value of the `credentialSchema` property MUST be one or more Credential schema instances. - id: credentialStatus - label: credential status + label: Credential status domain: cred:VerifiableCredential range: cred:CredentialStatus - comment: The value of the `credentialStatus` property MUST be an instance of Credential Status. + comment: The value of the `credentialStatus` property MUST be an instance of a Credential status. - id: credentialSubject - label: credential subject + label: Credential subject domain: cred:VerifiableCredential comment: An entity about which claims are made. - id: evidence - label: evidence + label: Evidence domain: cred:VerifiableCredential range: cred:CredentialEvidence - comment: The value of the `evidence` property MUST be one or more Credential Evidence instances. + comment: The value of the `evidence` property MUST be one or more Credential evidence instances. - id: expirationDate - label: expiration date + label: Expiration date domain: cred:VerifiableCredential range: xsd:dateTime - comment: The value of the `expirationDate` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential ceases to be valid. + 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` - id: holder - label: holder + label: Holder domain: - cred:VerifiableCredential - cred:VerifiablePresentation @@ -99,18 +100,19 @@ property: 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 + label: Issuance date domain: cred:VerifiableCredential range: xsd:dateTime + deprecated: true comment: | - The value of the `issuanceDate` 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. + 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. + 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. + + - id: validUntil + label: Valid until + domain: cred:VerifiableCredential + range: xsd:dateTime + comment: The value of the `validUntil` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential ceases to be valid. + - id: verifiableCredential label: verifiable credential domain: cred:VerifiablePresentation range: cred:VerifiableCredentialGraph - comment: The value of the `verifiableCredential` property MUST identify a Verifiable Credential Graph (informally, it indirectly identifies a Verifiable Credential contained in a separate graph). + comment: The value of the `verifiableCredential` property MUST identify a Verifiable credential graph (informally, it indirectly identifies a Verifiable credential contained in a separate graph).