Repository navigation
Add explainer for iframe embedded enforcement - #35
Merged
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
Adds a W3C TAG-style explainer describing an “embedded enforcement” extension to Connection Allowlists, where an embedding document can require an allowlist for framed/nested contexts (mirroring CSP Embedded Enforcement’s opt-in model).
Changes:
- Introduces a new explainer document for iframe/nested-context embedded enforcement.
- Documents the proposed attribute/header handshake (
connectionAllowlist,Sec-Required-Connection-Allowlist,Allow-Connection-Allowlist-From) and inheritance model. - Records alternatives considered and security/privacy considerations for the design.
Comments suppressed due to low confidence (1)
iframe-embedded-enforcement-explainer.md:67
- The goals section refers to
srcdoc:as a scheme, but the correct local-scheme URL forsrcdocdocuments isabout:srcdoc(and you use that form elsewhere in this explainer).
- Let a parent document **require** a connection allowlist of the iframes it embeds, and have that
requirement enforced on the embedded document.
- Let **local-scheme** content (`srcdoc:`, `data:`) participate in Connection Allowlists, which it
cannot do today because it cannot set response headers.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
noamr
reviewed
Jul 25, 2026
Add a W3C TAG style explainer for extending Connection Allowlists with
embedded enforcement for iframes and nested contexts: the connectionAllowlist
attribute, the Sec-Required-Connection-Allowlist and Allow-Connection-Allowlist-From
headers, the opt-in handshake, and inheritance of the requirement down the frame tree.
Brandr0id
force-pushed
the
iframe-inheritance-explainer
branch
from
July 27, 2026 21:39
1113f5c to
5741315
Compare
noamr
approved these changes
Jul 28, 2026
github-actions Bot
added a commit
that referenced
this pull request
Jul 28, 2026
SHA: add05f2 Reason: push, by Brandr0id Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add a W3C TAG style explainer for extending Connection Allowlists with embedded enforcement for iframes and nested contexts. Covers the spec changes in #29