Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update cr to Dec 19 #322

Merged
merged 4 commits into from
Dec 16, 2024
+5,090 −73
Merged

update cr to Dec 19 #322

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
d9b178d
update cr
decentralgabe Dec 13, 2024
7500801
update cr end
decentralgabe Dec 14, 2024
8ce42a6
rename controller doc; fix broken links
decentralgabe Dec 15, 2024
593c145
update cr
decentralgabe Dec 15, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
157 changes: 84 additions & 73 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,22 +13,22 @@
// specification status (e.g., WD, NOTE, etc.). If in doubt use
// ED.
specStatus: "CR",
crEnd: "2024-12-05",
crEnd: "2025-01-19",

// the specification's short name, as in
// http://www.w3.org/TR/short-name/
shortName: "vc-jose-cose",

// if you wish the publication date to be other than today, set
// this
// publishDate: "2024-11-05",
// publishDate: "2024-12-19",

implementationReportURI: "https://w3c.github.io/vc-jose-cose-test-suite/",
// errata: "https://w3c.github.io/vc-data-model/errata.html",

// if there is a previously published draft, uncomment this and
// set its YYYY-MM-DD date and its maturity status
previousPublishDate: "2024-04-25",
previousPublishDate: "2024-11-05",
previousMaturity: "CR",

// extend the bibliography entries localBiblio: vcwg.localBiblio,
Expand Down Expand Up @@ -60,8 +60,7 @@
{
name: "Gabe Cohen",
url: "https://github.com/decentralgabe",
company: "Block",
companyURL: "https://www.tbd.website",
company: "Invited Expert",
w3cid: 116851
}
],
Expand All @@ -82,7 +81,7 @@
value: "Verifiable Credentials Data Model v2.0",
href: "https://www.w3.org/TR/vc-data-model-2.0/"
}, {
value: "Controller Documents 1.0",
value: "Controlled Identifier Document 1.0",
href: "https://www.w3.org/TR/controller-document/"
}]
}],
Expand Down Expand Up @@ -372,7 +371,7 @@ <h3 id="terminology">Terminology</h3>
cryptographically-verifiable digital credentials, as defined by the W3C
Verifiable Credentials specification [[VC-DATA-MODEL-2.0]].
</dd>
<dt><dfn>controller document</dfn></dt>
<dt><dfn>controlled identifier document</dfn></dt>
<dd>
A document that contains public cryptographic material as defined in
the [[[CONTROLLER-DOCUMENT]]] specification.
Expand Down Expand Up @@ -459,29 +458,33 @@ <h2 id="securing-with-jose">Securing JSON-LD Verifiable Credentials
"https://www.w3.org/ns/credentials/v2",
"https://www.w3.org/ns/credentials/examples/v2"
],
"id": "http://university.example/credentials/1872",
"type": [
"VerifiableCredential",
"ExampleAlumniCredential"
],
"issuer": "https://university.example/issuers/565049",
"id": "http://university.example/credentials/3732",
"type": ["VerifiableCredential", "ExampleDegreeCredential", "ExamplePersonCredential"],
"issuer": "https://university.example/issuers/14",
"validFrom": "2010-01-01T19:23:24Z",
"credentialSchema": {
"id": "https://example.org/examples/degree.json",
"type": "JsonSchema"
},
"credentialSubject": {
"id": "did:example:123",
"id": "did:example:ebfeb1f712ebc6f1c276e12ec21",
"degree": {
"type": "BachelorDegree",
"type": "ExampleBachelorDegree",
"name": "Bachelor of Science and Arts"
},
"alumniOf": {
"name": "Example University"
}
}
},
"credentialSchema": [{
"id": "https://example.org/examples/degree.json",
"type": "JsonSchema"
},
{
"id": "https://example.org/examples/alumni.json",
"type": "JsonSchema"
}]
}
</pre>
<p>
See <a
data-cite="VC-DATA-MODEL-2.0#example-a-simple-example-of-the-contents-of-a-verifiable-credential"></a>
data-cite="VC-DATA-MODEL-2.0#example-using-the-credentialschema-property-to-perform-json-schema-validation"></a>
for more details regarding this example.
</p>
</section>
Expand Down Expand Up @@ -713,28 +716,32 @@ <h2 id="securing-with-sd-jwt">Securing JSON-LD Verifiable Credentials with SD-JW
"https://www.w3.org/ns/credentials/v2",
"https://www.w3.org/ns/credentials/examples/v2"
],
"id": "http://university.example/credentials/1872",
"type": [
"VerifiableCredential",
"ExampleAlumniCredential"
],
"issuer": "https://university.example/issuers/565049",
"id": "http://university.example/credentials/3732",
"type": ["VerifiableCredential", "ExampleDegreeCredential", "ExamplePersonCredential"],
"issuer": "https://university.example/issuers/14",
"validFrom": "2010-01-01T19:23:24Z",
"credentialSchema": {
"id": "https://example.org/examples/degree.json",
"type": "JsonSchema"
},
"credentialSubject": {
"id": "did:example:123",
"id": "did:example:ebfeb1f712ebc6f1c276e12ec21",
"degree": {
"type": "BachelorDegree",
"type": "ExampleBachelorDegree",
"name": "Bachelor of Science and Arts"
},
"alumniOf": {
"name": "Example University"
}
}
},
"credentialSchema": [{
"id": "https://example.org/examples/degree.json",
"type": "JsonSchema"
},
{
"id": "https://example.org/examples/alumni.json",
"type": "JsonSchema"
}]
}
</pre>
<p>
See <a data-cite="VC-DATA-MODEL-2.0#example-a-simple-example-of-the-contents-of-a-verifiable-credential"></a>
See <a data-cite="VC-DATA-MODEL-2.0#example-using-the-credentialschema-property-to-perform-json-schema-validation"></a>
for more details regarding this example.
</p>
</section>
Expand Down Expand Up @@ -894,28 +901,32 @@ <h2 id="securing-vcs-with-cose">Securing JSON-LD
"https://www.w3.org/ns/credentials/v2",
"https://www.w3.org/ns/credentials/examples/v2"
],
"id": "http://university.example/credentials/1872",
"type": [
"VerifiableCredential",
"ExampleAlumniCredential"
],
"issuer": "https://university.example/issuers/565049",
"id": "http://university.example/credentials/3732",
"type": ["VerifiableCredential", "ExampleDegreeCredential", "ExamplePersonCredential"],
"issuer": "https://university.example/issuers/14",
"validFrom": "2010-01-01T19:23:24Z",
"credentialSchema": {
"id": "https://example.org/examples/degree.json",
"type": "JsonSchema"
},
"credentialSubject": {
"id": "did:example:123",
"id": "did:example:ebfeb1f712ebc6f1c276e12ec21",
"degree": {
"type": "BachelorDegree",
"type": "ExampleBachelorDegree",
"name": "Bachelor of Science and Arts"
},
"alumniOf": {
"name": "Example University"
}
}
},
"credentialSchema": [{
"id": "https://example.org/examples/degree.json",
"type": "JsonSchema"
},
{
"id": "https://example.org/examples/alumni.json",
"type": "JsonSchema"
}]
}
</pre>
<p>
See <a data-cite="VC-DATA-MODEL-2.0#example-a-simple-example-of-the-contents-of-a-verifiable-credential"></a>
See <a data-cite="VC-DATA-MODEL-2.0#example-using-the-credentialschema-property-to-perform-json-schema-validation"></a>
for more details regarding this example.
</p>
</section>
Expand Down Expand Up @@ -1167,9 +1178,9 @@ <h3 id="jwt-issuer">JWT Issuer</h3>
</section>
</section>
<section>
<h3 id="using-controller-documents">Using Controller Documents</h3>
<h3 id="using-controlled-identifier-documents">Using Controlled Identifier Documents</h3>
<p>
When using [=controller documents=] with this specification,
When using [=controlled identifier documents=] with this specification,
the following requirements apply.
</p>
<p>
Expand All @@ -1182,14 +1193,14 @@ <h3 id="using-controller-documents">Using Controller Documents</h3>
This key material is retrieved based on hints in the JOSE or COSE message
envelopes, such as <code>kid</code> or <code>iss</code>.
At the time of writing, there is no standard way to retrieve a
public key in JWK format from a DID URL or [=controller document=].
public key in JWK format from a DID URL or [=controlled identifier documents=].
</p>
<!-- REGULAR URLS via "issuer" and "holder" -->
<p>
When <a href="#iss">iss</a> is absent, and the
<a data-cite="VC-DATA-MODEL-2.0#dfn-issuers">issuer</a> is identified
as a [[URL]], the <a href="#kid">kid</a> MUST be an absolute [[URL]]
to a verification method listed in a [=controller document=] or
to a verification method listed in a [=controlled identifier documents=] or
a <a data-cite="DID-CORE#dfn-did-documents">DID Document</a>.
</p>
<p>
Expand All @@ -1199,15 +1210,15 @@ <h3 id="using-controller-documents">Using Controller Documents</h3>
For example:
<code>https://vendor.example/issuers/42/keys/urn:ietf:params:oauth:jwk-thumbprint:sha-256:NzbLsXh8uDCcd-6MNwXF4W_7noWXFZAfHkxZsRGC9Xs</code>
</p>
<pre class="example" title="An issuer identified by a controller document identifier">
<pre class="example" title="An issuer identified by a controlled identifier document identifier">
{
"issuer": {
"id": "https://university.example/issuers/565049"
}
// ...
}
</pre>
<pre class="example" title="A kid as a controller document verification method identifier">
<pre class="example" title="A kid as a controlled identifier document verification method identifier">
{
"alg": "ES384",
"kid": "https://university.example/issuers/565049#key-123
Expand All @@ -1217,17 +1228,17 @@ <h3 id="using-controller-documents">Using Controller Documents</h3>
When the <a data-cite="VC-DATA-MODEL-2.0#dfn-holders">holder</a> is
identified as a [[URL]], and <a href="#iss">iss</a> is absent, the
<a href="#kid">kid</a> MUST be an absolute [[URL]] to a
verification method listed in a [=controller document=].
verification method listed in a [=controlled identifier document=].
</p>
<pre class="example" title="A holder identified by a controller document identifier">
<pre class="example" title="A holder identified by a controlled identifier document identifier">
{
"holder": {
"id": "https://university.example/issuers/565049"
}
// ...
}
</pre>
<pre class="example" title="A kid as a controller document verification method identifier">
<pre class="example" title="A kid as a controlled identifier document verification method identifier">
{
"alg": "ES384",
"kid": "https://university.example/issuers/565049#key-123
Expand Down Expand Up @@ -1537,7 +1548,7 @@ <h2 id="vc-json-jwt"><code>application/vc+jwt</code></h2>
</tr>
<tr>
<td>Published specification:</td>
<td><a href="https://w3.org/TR/vc-jose-cose">https://w3.org/TR/vc-jose-cose</a></td>
<td><a href="https://www.w3.org/TR/vc-jose-cose">https://www.w3.org/TR/vc-jose-cose</a></td>
</tr>
<tr>
<td>Applications that will use this media:</td>
Expand Down Expand Up @@ -1634,7 +1645,7 @@ <h2 id="vp-json-jwt"><code>application/vp+jwt</code></h2>
</tr>
<tr>
<td>Published specification:</td>
<td><a href="https://w3.org/TR/vc-jose-cose">https://w3.org/TR/vc-jose-cose</a></td>
<td><a href="https://www.w3.org/TR/vc-jose-cose">https://www.w3.org/TR/vc-jose-cose</a></td>
</tr>
<tr>
<td>Applications that will use this media:</td>
Expand Down Expand Up @@ -1731,7 +1742,7 @@ <h2 id="vc-json-sd-jwt"><code>application/vc+sd-jwt</code></h2>
</tr>
<tr>
<td>Published specification:</td>
<td><a href="https://w3.org/TR/vc-jose-cose">https://w3.org/TR/vc-jose-cose</a></td>
<td><a href="https://www.w3.org/TR/vc-jose-cose">https://www.w3.org/TR/vc-jose-cose</a></td>
</tr>
<tr>
<td>Applications that will use this media:</td>
Expand Down Expand Up @@ -1830,7 +1841,7 @@ <h2 id="vp-json-sd-jwt"><code>application/vp+sd-jwt</code></h2>
</tr>
<tr>
<td>Published specification:</td>
<td><a href="https://w3.org/TR/vc-jose-cose">https://w3.org/TR/vc-jose-cose</a></td>
<td><a href="https://www.w3.org/TR/vc-jose-cose">https://www.w3.org/TR/vc-jose-cose</a></td>
</tr>
<tr>
<td>Applications that will use this media:</td>
Expand Down Expand Up @@ -1925,7 +1936,7 @@ <h2 id="vc-json-cose"><code>application/vc+cose</code></h2>
</tr>
<tr>
<td>Published specification:</td>
<td><a href="https://w3.org/TR/vc-jose-cose">https://w3.org/TR/vc-jose-cose</a></td>
<td><a href="https://www.w3.org/TR/vc-jose-cose">https://www.w3.org/TR/vc-jose-cose</a></td>
</tr>
<tr>
<td>Applications that will use this media:</td>
Expand Down Expand Up @@ -2020,7 +2031,7 @@ <h2 id="vp-json-cose"><code>application/vp+cose</code></h2>
</tr>
<tr>
<td>Published specification:</td>
<td><a href="https://w3.org/TR/vc-jose-cose">https://w3.org/TR/vc-jose-cose</a></td>
<td><a href="https://www.w3.org/TR/vc-jose-cose">https://www.w3.org/TR/vc-jose-cose</a></td>
</tr>
<tr>
<td>Applications that will use this media:</td>
Expand Down Expand Up @@ -2200,12 +2211,12 @@ <h2 id="accessibility">Accessibility</h2>
<h3 id="examples">Examples</h3>
<section>
<h2 id="controllers">Controllers</h2>
<pre class="example" title="A minimal controller document">
<pre class="example" title="A minimal controlled identifier document">
{
"id": "https://vendor.example",
}
</pre>
<pre class="example" title="A controller document with verification method">
<pre class="example" title="A controlled identifier document with verification method">
{
"id": "https://university.example/issuers/565049",
"verificationMethod": [{
Expand All @@ -2222,7 +2233,7 @@ <h2 id="controllers">Controllers</h2>
}]
}
</pre>
<pre class="example" title="A controller document with verification relationships">
<pre class="example" title="A controlled identifier document with verification relationships">
{
"id": "https://university.example/issuers/565049",
"verificationMethod": [{
Expand All @@ -2241,14 +2252,14 @@ <h2 id="controllers">Controllers</h2>
"assertionMethod": ["https://university.example/issuers/565049#key-123"]
}
</pre>
<pre class="example" title="A verifiable credential controller document">
<pre class="example" title="A verifiable credential controlled identifier document">
{
"@context": [
"https://www.w3.org/ns/did/v1",
"https://w3id.org/security/jwk/v1",
{
"@vocab": "https://vendor.example#"
}
"https://www.w3.org/ns/did/v1",
"https://w3id.org/security/jwk/v1",
{
"@vocab": "https://vendor.example#"
}
],
"id": "did:web:vendor.example",
"alsoKnownAs": ["https://vendor.example",
Expand Down
Loading