Skip to content

Add explainer for iframe embedded enforcement - #35

Merged
Brandr0id merged 1 commit into
mainfrom
iframe-inheritance-explainer
Jul 28, 2026
Merged

Brandr0id merged 1 commit into
mainfrom
iframe-inheritance-explainer

Conversation

@Brandr0id

Copy link
Copy Markdown
Collaborator

Add a W3C TAG style explainer for extending Connection Allowlists with embedded enforcement for iframes and nested contexts. Covers the spec changes in #29

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 for srcdoc documents is about: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.

    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
Brandr0id force-pushed the iframe-inheritance-explainer branch from 1113f5c to 5741315 Compare July 27, 2026 21:39
@Brandr0id
Brandr0id merged commit add05f2 into main Jul 28, 2026
2 checks passed
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants