diff --git a/index.html b/index.html
index 86baf70..c116e13 100644
--- a/index.html
+++ b/index.html
@@ -47,7 +47,12 @@
href: 'https://w3c.github.io/device-posture/polyfill/demo.html'
}]
}],
- xref: "web-platform",
+ xref: {
+ profile: "web-platform",
+ specs: [
+ "permissions-policy"
+ ]
+ },
logos: [
{
src: "./images/daswg-logo.svg",
@@ -533,6 +538,41 @@
+
+
+ Policy control
+
+
+ The Device Posture API defines a [=policy-controlled feature=]
+ identified by the token "device-posture".
+ Its [=policy-controlled feature/default allowlist=] is `'self'`.
+
+
+
+ The [=policy-controlled feature/default allowlist=] of `'self'` allows usage in
+ same-origin nested frames but prevents third-party content from using
+ the feature.
+
+
+ Third-party usage can be selectively enabled by adding
+ `allow="device-posture"` attribute to the frame container element:
+
+
+ <iframe src="https://third-party.com" allow="device-posture"/></iframe>
+
+
+ Alternatively, the Device Posture API can be disabled completely by
+ specifying the permissions policy in a HTTP response header:
+
+
+ Permissions-Policy: {"device-posture": []}
+
+
+ See [[[PERMISSIONS-POLICY]]] for more details.
+
+
+
Security and Privacy considerations