Skip to content

Commit

Permalink
Clarify proof section (#1106)
Browse files Browse the repository at this point in the history
Co-authored-by: Dave Longley <dlongley@digitalbazaar.com>
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
  • Loading branch information
3 people committed May 4, 2023
1 parent 2019010 commit a119a5d
Showing 1 changed file with 21 additions and 14 deletions.
35 changes: 21 additions & 14 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1705,29 +1705,36 @@ <h3>Validity Period</h3>
</section>

<section>
<h3>Proofs (Signatures)</h3>
<h3>Securing Verifiable Credentials</h3>

<p>
At least one proof mechanism, and the details necessary to evaluate that proof,
MUST be expressed for a <a>credential</a> or <a>presentation</a> to be a
At least one securing mechanism, and the details necessary to evaluate it, MUST
be expressed for a <a>credential</a> or <a>presentation</a> to be a
<a>verifiable credential</a> or <a>verifiable presentation</a>; that is, to be
<a>verifiable</a>.
</p>

<p>
This specification identifies two classes of proof mechanisms: external proofs
and embedded proofs. An <dfn class="lint-ignore">external proof</dfn> is one
that wraps an expression of this data model, such as a JSON Web Token, which is
elaborated on in the Securing Verifiable Credentials using JSON Web Tokens
[[?VC-JWT]] specification. An <dfn>embedded proof</dfn> is a mechanism where
the proof is included in the data, such as a Data Integrity Proof, which is
elaborated upon in Verifiable Credential Data Integrity [[VC-DATA-INTEGRITY]].
This specification recognizes two classes of securing mechanisms: those that use
external proofs and those that use embedded proofs. An
<dfn class="lint-ignore">external proof</dfn> is one that wraps an expression of
this data model, such as via a JSON Web Token, which is elaborated on in the
<em>Securing Verifiable Credentials using JSON Web Tokens</em> [[VC-JWT]] specification.
An <dfn>embedded proof</dfn> is a mechanism where the proof is included in the
data model, such as a Data Integrity Proof, which is elaborated on in <em>Verifiable
Credential Data Integrity</em> [[VC-DATA-INTEGRITY]].
</p>

<p>
When embedding a proof, the <code>proof</code> <a>property</a> MUST be used.
It should be noted that these two classes of securing mechanisms are not
mutually exclusive.
</p>
<p>
Methods of securing <a>credentials</a> or <a>presentations</a> that embed a
proof in the data model MUST use the <code>proof</code> <a>property</a>.
</p>
<p>
Methods of securing <a>credentials</a> or <a>presentations</a> that use an
external proof MAY use the <code>proof</code> <a>property</a>.
</p>

<dl>
<dt><var>proof</var></dt>
<dd>
Expand Down

0 comments on commit a119a5d

Please sign in to comment.