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.

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

updated introduction to focus on verification of proofs #102

Closed
wants to merge 8 commits into from
35 changes: 27 additions & 8 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -296,9 +296,9 @@
<body>
<section id='abstract'>
<p>
A [=controller document=] is a set of data that specifies one or more
relationships between a [=controller=] and a set of data, such as a set of
public cryptographic keys.
A [=controller document=] contains cryptographic material and service
endpoints for the purposes of verifying proofs from, and interacting
with, the [=controller=] of an identifier.
jandrieu marked this conversation as resolved.
Show resolved Hide resolved
</p>
</section>

Expand All @@ -309,11 +309,30 @@
<section class="informative">
<h2>Introduction</h2>
<p>
A [=controller document=] is a set of data that specifies one or more
relationships between a [=controller=] and a set of data, such as a set of
public cryptographic keys. The [=controller document=] contains [=verification
relationships=] that explicitly permit the use of certain [=verification
methods=] for specific purposes.
A [=controller document=] contains cryptographic material and service
endpoints for the purposes of verifying proofs from, and interacting
with, the [=controller=] of an identifier.
</p>
<p>
jandrieu marked this conversation as resolved.
Show resolved Hide resolved
[=Controller documents=] enable the verification of proofs created
by the controller of an identifier. They provide [=verification methods=]
that express public cryptographic material, such as public keys, for
verifying proofs created by the controller of the
jandrieu marked this conversation as resolved.
Show resolved Hide resolved
identifier for specific purposes, such as
authentication, attestation, encryption, and capability invocation
jandrieu marked this conversation as resolved.
Show resolved Hide resolved
and delegation.
</p>
<p>
Controller Documents also provide [services] related to the identifier,
jandrieu marked this conversation as resolved.
Show resolved Hide resolved
for example to request additional information for verification.
</p>
<p>
In other words, the
controller document contains the necessary information for proving
cryptographically that specific actions were taken by the
controller of an identifier, including material for
jandrieu marked this conversation as resolved.
Show resolved Hide resolved
cryptographic proofs and service endpoints for additional
communications.
</p>
<p>
It is expected that other specifications, such as [[[?DID-CORE]]], will profile
Expand Down