Skip to content

[DNS] Add enforce dns-only#29072

Closed
RebeccaTamachiro wants to merge 7 commits intoproductionfrom
rebecca/dns-enforce-dns-only
Closed

[DNS] Add enforce dns-only#29072
RebeccaTamachiro wants to merge 7 commits intoproductionfrom
rebecca/dns-enforce-dns-only

Conversation

@RebeccaTamachiro
Copy link
Copy Markdown
Contributor

Summary

PCX-21243

@github-actions github-actions bot added product:dns Issues or PRs related to DNS size/m labels Mar 18, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 18, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/assets/images/ @cloudflare/pm-changelogs, @cloudflare/pcx-technical-writing
/src/content/docs/dns/ @RebeccaTamachiro, @cloudflare/pcx-technical-writing


## Enable enforce DNS-only

Use the [Update DNS Settings](/api/resources/dns/subresources/settings/subresources/account/methods/edit/) endpoint to enable enforce DNS-only for your account:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Which API permissions / member roles are required for this? I hope it's only SuperAdmins :)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Since this is a new field on the existing endpoint, the permissions remain the same as those required for modifying other DNS settings, specifically, read/write access to DNS Record resources.

Copy link
Copy Markdown
Contributor

@smittal123 smittal123 left a comment

Choose a reason for hiding this comment

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

Added Exceptions sections

- **Account-level**: Affects all zones in the account simultaneously.
- **Non-destructive**: Does not modify your DNS records. Disabling the setting restores normal proxy behavior.
- **API-only**: Available through the API only, not in the Cloudflare dashboard.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Exceptions

Records Not Affected by the Proxy Kill Switch:

  • Spectrum applications – these are already grey-clouded CNAME records pointing to Spectrum endpoints and see no impact
  • Cloudflare for SaaS fallback origin records – default origin for custom hostnames
  • Cloudflare for SaaS eyeball zone records – records pointing to SaaS providers (bypassing won't help if the SaaS provider's target remains proxied)
  • Workers custom domains – orange-clouded A records pointing to 100::
  • R2 custom domains – orange-clouded CNAME records pointing to public.r2.dev
  • Web3 gateways – Ethereum and IPFS DNSlink gateways (CNAMEs to ethereum.cloudflare.com / ipfs.cloudflare.com)
  • Cloudflare Tunnel (Argo Tunnel) records – Records required for tunnel routing (grey-clouding may break tunnel connectivity)

Included:

  • Proxied Load Balancer records – The kill switch applies to LB records

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 25, 2026

CI run failed: build logs

@RebeccaTamachiro
Copy link
Copy Markdown
Contributor Author

Had some issues while trying to address the build fail so moving to #29353

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:dns Issues or PRs related to DNS size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants