Skip to content

Commit 20a2ae5

Browse files
committed
Fix grammar related to content integrity and JSON-LD Base Context.
1 parent 0b0ed46 commit 20a2ae5

File tree

1 file changed

+22
-19
lines changed

1 file changed

+22
-19
lines changed

index.html

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -4813,38 +4813,41 @@ <h2>Contexts, Types, and Credential Schemas</h2>
48134813
<section class="informative">
48144814
<h3>Base Context</h3>
48154815
<p>
4816-
The base context, located at
4817-
<code>https://www.w3.org/ns/credentials/v2</code> with a SHA-256 digest of
4816+
The base context, located at <code>https://www.w3.org/ns/credentials/v2</code>
4817+
with a SHA-256 digest of
48184818
<strong><code>944167aaabd904ea9e35c98fd7e8794eb6dd42ae4666b036b171e87fc34cc7cc</code></strong>,
48194819
can be used to implement a local cached copy. It is possible to confirm the
48204820
SHA-256 digest by running the following command from a modern Unix command
4821-
interface line: `curl -s https://www.w3.org/ns/credentials/v2 | sha256sum`.
4821+
interface line: `curl -s https://www.w3.org/ns/credentials/v2 | sha256sum`. It
4822+
is strongly advised that all JSON-LD Contexts used in an application utilize a
4823+
similar mechanism to ensure end-to-end security.
48224824
</p>
48234825
<p>
48244826
This section serves as a reminder of the importance of ensuring that, when
48254827
verifying <a>verifiable credentials</a> and <a>verifiable presentations</a>, the
48264828
<a>verifier</a> has information that is consistent with what the <a>issuer</a>
4827-
had when securing the <a>credential</a> or <a>presentation</a>. This information
4828-
might include at least: 1) contents of the credential itself; 2) any content
4829-
included by reference in the credential; 3) any content transitively included by
4830-
reference.
4829+
or <a>holder</a> had when securing the <a>credential</a> or <a>presentation</a>.
4830+
This information might include at least: 1) contents of the credential itself;
4831+
2) any content linked to via a URL in the credential; 3) any content linked to
4832+
via a URL, which then links to more content via a URL (and so on).
48314833
</p>
48324834
<p>
48334835
Mechanisms used to secure <a>credentials</a> and <a>presentations</a>, such
4834-
as digital signatures, address securing the contents of the credential itself
4835-
(item #1 in the previous paragraph). The SHA-256 digest of the Base Context in
4836-
this section addresses securing the context information (item #2 in the
4837-
previous paragraph).
4836+
[[VC-JWT]] and [[VC-DATA-INTEGRITY]], address securing the contents of the
4837+
credential itself (item #1 in the previous paragraph). The SHA-256 digest of
4838+
JSON-LD Contexts, as well as locally cached copies, address item #2 in the
4839+
previous paragraph.
48384840
</p>
48394841
<p>
4840-
However, it does not cryptographically protect other content referenced such as
4841-
other JSON-LD Contexts or files referenced via URLs. It is considered a best
4842-
practice to ensure that the same sorts of protections are provided for other
4843-
JSON-LD Contexts and URLs through the use of permanently cached files or
4844-
cryptographic hashes for linked information that is critical to a specific use
4845-
case. See the Content Integrity section of the Verifiable Credential
4846-
Implementation Guide to verify that content it either fetches remotely or caches
4847-
locally is consistent with what the <a>issuer</a> intended.
4842+
However, other data that is referenced from within a credential, such as
4843+
resources that are linked to via URLs, are not cryptographically protected by
4844+
default. It is considered a best practice to ensure that the same sorts of
4845+
protections are provided for any URL that is critical to the security of the
4846+
credential through the use of permanently cached files or cryptographic hashes.
4847+
See the <a href="https://w3c.github.io/vc-imp-guide/#content-integrity">Content
4848+
Integrity</a> section of the Verifiable Credential Implementation Guide to
4849+
verify that content it either fetches remotely or caches locally is consistent
4850+
with what the <a>issuer</a> or <a>holder</a> intended.
48484851
</p>
48494852
<p>
48504853
For convenience, the base context for the Verifiable Credential Data Model v2.0

0 commit comments

Comments
 (0)