Skip to content

Commit c67ab03

Browse files
Add digital-credentials-get Permission Policy (#132)
1 parent 69a62f2 commit c67ab03

File tree

2 files changed

+29
-0
lines changed

2 files changed

+29
-0
lines changed

explainer.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,14 @@ Here is an example of how the  the API might be used in practice:
5656
```
5757
You can read a more detailed and technical description of the API in the [specification draft](https://wicg.github.io/digital-identities/).
5858

59+
### Using the API from another origin
60+
61+
The specification allows usage of the API from a remote/third-party origin via the "digital-credentials-get" Permissions Policy. This is useful for scenarios where a website wants to request digital credentials from a wallet provider that is hosted on a different origin. The Permissions Policy can be set on an iframe that embeds the website that wants to use the API. Here is an example of how the Permissions Policy can be set on an iframe:
62+
63+
```HTML
64+
<iframe allow="digital-credentials-get"></iframe>
65+
```
66+
5967
## Horizontal reviews
6068

6169
* [Security and privacy TAG Questionnaire](horizontal-reviews/security-privacy.md)

index.html

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -309,6 +309,27 @@ <h3>
309309
<dfn class="export" data-dfn-for="DigitalCredential">[[\discovery]]</dfn>
310310
whose value is "remote".
311311
</p>
312+
<section class="informative">
313+
<h3>
314+
User consent
315+
</h3>
316+
<p>
317+
The <cite>Digital Credential API</cite> is a [=powerful feature=] that
318+
requires [=express permission=] from an end-user. This requirement is
319+
normatively enforced when calling {{CredentialsContainer}}'s
320+
{{CredentialsContainer/get()}} method.
321+
</p>
322+
</section>
323+
<section id="permissions-policy" data-cite="permissions-policy">
324+
<h2>
325+
Permissions Policy integration
326+
</h2>
327+
<p>
328+
This specification defines a [=policy-controlled feature=] identified
329+
by the string <dfn class="permission">"digital-credentials-get"</dfn>.
330+
Its [=policy-controlled feature/default allowlist=] is [=allowlist/'self'=].
331+
</p>
332+
</section>
312333
<h2 id="protocol-registry">
313334
Registry of protocols for requesting digital credential
314335
</h2>

0 commit comments

Comments
 (0)