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

Jump to bottom

Add usage guidance related to the id property. #1114

Merged
merged 3 commits into from May 13, 2023
Merged

Add usage guidance related to the id property. #1114

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
a860b90
Add usage guidance related to the `id` property.
msporny May 6, 2023
7be16ee
Fine tune language in `id` property section.
msporny May 13, 2023
4af336e
Use fragment identifier `id`s in HTTP URL example.
msporny May 13, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
22 changes: 13 additions & 9 deletions index.html
View file
Open in desktop
Expand Up @@ -1166,14 +1166,17 @@ <h3>Contexts</h3>
<h3>Identifiers</h3>

<p>
When expressing statements about a specific thing, such as a person, product,
or organization, it is often useful to use some kind of identifier so that
others can express statements about the same thing. This specification defines
the optional <code>id</code> <a>property</a> for such identifiers. The
<code>id</code> <a>property</a> is intended to unambiguously refer to an object,
such as a person, product, or organization. Using the <code>id</code>
<a>property</a> allows for the expression of statements about specific things in
the <a>verifiable credential</a>.
When expressing statements about a specific thing, such as a person, product, or
organization, it can be useful to use a globally unique identifier for that thing.
Globally unique identifiers enable others to express statements
about the same thing. This specification defines the optional <code>id</code>
<a>property</a> for such identifiers. The <code>id</code> <a>property</a>
allows for the expression of statements about specific things in the
<a>verifiable credential</a> and is set by an <a>issuer</a> when expressing
objects in a <a>verifiable credential</a> or a <a>holder</a> when expressing
objects in a <a>verifiable presentation</a>. Example <code>id</code> values
include UUIDs (`urn:uuid:0c07c1ce-57cb-41af-bef2-1b932b986873`), HTTP URLs
(`https://id.example/things#123`), and DIDs (`did:example:1234abcd`).
</p>

<p>
Expand Down Expand Up @@ -1202,7 +1205,8 @@ <h3>Identifiers</h3>
scenarios. There are also other types of correlation mechanisms documented in
Section <a href="#privacy-considerations"></a> that create privacy concerns.
Where privacy is a strong consideration, the <code>id</code> <a>property</a>
MAY be omitted.
MAY be omitted. Some use cases do not require, or explicitly require omitting, the <code>id</code>
<a>property</a>.
</p>

<dl>
Expand Down