http permissions policy directive
Permissions-Policy: local-network directive
Limited availability
The HTTP Permissions-Policy header local-network directive controls whether the current document is allowed to make network requests to local addresses.
A local address is only accessible on the local network; its target will differ on different networks. For example, 192.168.0.1.
Specifically, where a defined policy blocks use of this feature, requests to local addresses will always fail.
See Local Network Access for more details.
Syntax
Permissions-Policy: local-network=<allowlist>;
<allowlist>- : A list of origins for which permission is granted to use the feature. See
Permissions-Policy> Syntax for more details.
- : A list of origins for which permission is granted to use the feature. See
Default policy
The default allowlist for local-network is self. The top-level browsing context and same-origin iframes are allowed access to the local-network feature by default.
Examples
Basic usage
SecureCorp Inc. wants to disallow local-network within all cross-origin iframes except those whose origin is https://example.com. It can do so by delivering the following HTTP response header to define a Permissions Policy:
Permissions-Policy: local-network=(self "https://example.com")
SecureCorp Inc. must also include an <allow> attribute on each <iframe> element where local-network is to be allowed:
<iframe src="https://example.com/lna" allow="local-network"></iframe>
[!NOTE] Specifying the
Permissions-Policyheader in this manner disallowslocal-networkfor other origins, even if they are allowed by the<iframe>allowattribute.
Using the default policy
If an allowlist for local-network is not defined by a Permissions-Policy response header, user agents will apply the default allowlist self. In this mode, local-network is automatically allowed in the top-level browsing context and same-origin iframes, but not in cross-origin iframes.
To allow local-network in a cross-origin iframe, include an <allow> attribute on the <iframe> element:
<iframe src="https://other.com/lna" allow="local-network"></iframe>