Skip to content

Commit 6e7afcc

Browse files
authored
Document URL allowlist behavior for API access
1 parent 85f82c0 commit 6e7afcc

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

specs/SensitivityLabel.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -243,6 +243,26 @@ interface ICoreWebView2Profile9 : IUnknown {
243243
[propget] HRESULT PageInteractionRestrictionManagerAllowlist(
244244
[out, retval] ICoreWebView2StringCollection** value);
245245
246+
/// Controls which URLs are allowed to access the PageInteractionRestrictionManager API.
247+
///
248+
/// This property manages an allowlist of URLs that determines which web pages
249+
/// can use the PageInteractionRestrictionManager API. Only URLs that match
250+
/// entries in this allowlist (either exact matches or wildcard patterns) will
251+
/// have access to the PageInteractionRestrictionManager functionality.
252+
///
253+
/// The allowlist accepts both exact URL strings and wildcard patterns.
254+
/// For wildcard patterns, `*` matches zero or more characters.
255+
///
256+
/// URL matching occurs after the URI has been normalized, any URI fragment
257+
/// has been removed, and non-ASCII hostnames have been converted to punycode.
258+
///
259+
/// | URL Filter | Page URL | Access Granted | Notes |
260+
/// | ---- | ---- | ---- | ---- |
261+
/// | `https://example.com` | `https://example.com/page` | No | Exact match required |
262+
/// | `https://example.com` | `https://example.com` | No | The URI is normalized before filter matching so the actual URI used for comparison is https://example.com/ |
263+
/// | `https://example.com/*` | `https://example.com/page` | Yes | Wildcard matches any path |
264+
/// | `*://example.com/*` | `https://example.com/page` | Yes | Wildcard matches any scheme |
265+
/// | `*` | `https://any-site.com` | Yes | Wildcard matches all URLs |
246266
/// Sets the `PageInteractionRestrictionManagerAllowlist` property.
247267
[propput] HRESULT PageInteractionRestrictionManagerAllowlist(
248268
[in] ICoreWebView2StringCollection* value);

0 commit comments

Comments
 (0)