Skip to content

Commit

Permalink
Use digestMultibase with base64-url-nopad encoding for integrity.
Browse files Browse the repository at this point in the history
  • Loading branch information
msporny committed Jun 1, 2024
1 parent 03ce39d commit 0014b6d
Showing 1 changed file with 13 additions and 21 deletions.
34 changes: 13 additions & 21 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -3241,28 +3241,22 @@ <h2>Integrity of Related Resources</h2>
</td>
</tr>
<tr>
<td>`digestSRI`</td>
<td>`digestMultibase`</td>
<td>
One or more cryptographic digests, as defined by the `hash-expression` ABNF
grammar defined in the [[[SRI]]] specification,
<a data-cite="SRI#the-integrity-attribute">Section 3.5: The `integrity`
attribute</a>.
One or more cryptographic digests, as defined by the `digestMultibase`
property in the [[[VC-DATA-INTEGRITY]]]
specification, <a data-cite="VC-DATA-INTEGRITY#resource-integrity">
Section 2.6: Resource Integrity</a>. The Multibase encoding MUST use the
base64-url-nopad (`u`) option.
</td>
</tr>
</tbody>
</table>
Each object associated with `relatedResource` MUST contain at least a
`digestSRI` value.
`digestMultibase` value.
</dd>
</dl>

<p class="issue atrisk" data-number="1489">
The Working Group is currently attempting to determine whether cryptographic hash
expression formats can be unified across all of the VCWG core specifications.
Candidates for this mechanism include `digestSRI` and `digestMultibase`. There
are arguments for and against unification that the WG is currently debating.
</p>

<p>
If a `mediaType` is listed, implementations that retrieve the resource
identified by the `id` property using [[[?RFC9110]]] SHOULD:
Expand All @@ -3279,8 +3273,8 @@ <h2>Integrity of Related Resources</h2>

<p>
Any object in the [=verifiable credential=] that contains an `id`
property MAY be annotated with integrity information by adding the
`digestSRI` and `mediaType` properties.
property MAY be annotated with integrity information by adding
`digestMultibase` and, optionally, the `mediaType` property.
</p>

<p>
Expand Down Expand Up @@ -3319,15 +3313,13 @@ <h2>Integrity of Related Resources</h2>
</p>

<pre class="example nohighlight"
title="Usage of the relatedResource and digestSRI property">
title="Usage of the relatedResource and digestMultibase property">
"relatedResource": [{
"id": "https://www.w3.org/ns/credentials/v2",
"digestSRI":
"sha384-lHKDHh0msc6pRx8PhDOMkNtSI8bOfsp4giNbUrw71nXXLf13nTqNJoRp3Nx+ArVK",
"digestMultibase": "uEres1usWcWCmW7uolIW2uA0CjQ8iRV14eGaZStJL73Vz",
},{
"id": "https://www.w3.org/ns/credentials/examples/v2",
"digestSRI":
"sha384-zNNbQTWCSUSi0bbz7dbua+RcENv7C6FvlmYJ1Y+I727HsPOHdzwELMYO9Mz68M26",
"digestMultibase": "uElc5P7xp1u-5ubXcnLa5iAsJRDYKv-Lq9FnJ5YzyJ518",
}]
</pre>

Expand Down Expand Up @@ -3718,7 +3710,7 @@ <h3>Evidence</h3>
"name": "Talk-aloud video of double espresso preparation",
"description": "This is a talk-aloud video of Alice demonstrating preparation of a double espresso drink.",
<span class='comment'>// digest hash of the mp4 video file</span>
"digestSRI": "sha384-zNNbQTWCSUSi0bbz7dbua...OHdzwELMYO9Mz68M26"
"digestMultibase": "uEkrjQf4CMji1ROmEixJsv3qeeDP8Zd0SkClxtCU_GiB0"
}
]
}
Expand Down

0 comments on commit 0014b6d

Please sign in to comment.