Skip to content

[Workers] Add Cloudflare Access configuration docs - #32618

Merged
dinasaur404 merged 18 commits into
productionfrom
chythra/workers-access-dev-docs-v2
Aug 14, 2026
Merged

[Workers] Add Cloudflare Access configuration docs#32618
dinasaur404 merged 18 commits into
productionfrom
chythra/workers-access-dev-docs-v2

Conversation

@chythram05

Copy link
Copy Markdown
Collaborator

Summary

Adds a new Cloudflare Access configuration page for Workers at /workers/configuration/cloudflare-access/. This page documents how to protect Workers behind Cloudflare Access, covering:

  • Protect all Workers — account-level Access for all current and future Workers
  • Protect one Worker — Worker-level Access with dashboard and API instructions
  • Protect a specific hostname, Custom Domain, or path
  • Read authenticated user identity with ctx.access
  • Testing ctx.access locally — simulating Access identities during wrangler dev
  • Make a Worker public when account-level Access is enabled
  • Access hierarchy — how multiple Access rules interact

Also updates screenshots to reflect the latest dashboard UI and adds cross-links from related Workers docs pages (workers.dev, previews, custom domains, migrate-from-pages).

Screenshots

Documentation checklist

  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

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

Pattern Owners
/src/assets/images/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners, @cloudflare/wrangler, @MattieTK, @vy-ton, @cloudflare/workers-runtime-1
/src/content/docs/cloudflare-one/access-controls/ @kennyj42, @asamborski, @cloudflare/cf1-reviewers, @elithrar, @cloudflare/product-owners, @hoan-pom
/src/content/docs/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @korinne, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners, @cloudflare/wrangler, @MattieTK, @cloudflare/dev-plat-leads, @vy-ton, @cloudflare/workers-runtime-1
/src/content/docs/workers/static-assets @irvinebroque, @GregBrimble, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners, @MattieTK, @vy-ton

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Preview URL: https://f59d5d48.preview.developers.cloudflare.com
Preview Branch URL: https://chythra-workers-access-dev-docs-v2.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/workers/configuration/cloudflare-access/ https://chythra-workers-access-dev-docs-v2.preview.developers.cloudflare.com/workers/configuration/cloudflare-access/
https://developers.cloudflare.com/workers/configuration/routing/custom-domains/ https://chythra-workers-access-dev-docs-v2.preview.developers.cloudflare.com/workers/configuration/routing/custom-domains/
https://developers.cloudflare.com/workers/configuration/routing/workers-dev/ https://chythra-workers-access-dev-docs-v2.preview.developers.cloudflare.com/workers/configuration/routing/workers-dev/
https://developers.cloudflare.com/workers/versions-and-deployments/preview-urls/ https://chythra-workers-access-dev-docs-v2.preview.developers.cloudflare.com/workers/versions-and-deployments/preview-urls/
https://developers.cloudflare.com/workers/local-development/ https://chythra-workers-access-dev-docs-v2.preview.developers.cloudflare.com/workers/local-development/
https://developers.cloudflare.com/cloudflare-one/access-controls/applications/choose-application-type/ https://chythra-workers-access-dev-docs-v2.preview.developers.cloudflare.com/cloudflare-one/access-controls/applications/choose-application-type/
https://developers.cloudflare.com/workers/examples/basic-auth/ https://chythra-workers-access-dev-docs-v2.preview.developers.cloudflare.com/workers/examples/basic-auth/
https://developers.cloudflare.com/workers/runtime-apis/cache/ https://chythra-workers-access-dev-docs-v2.preview.developers.cloudflare.com/workers/runtime-apis/cache/
https://developers.cloudflare.com/workers/static-assets/migration-guides/migrate-from-pages/ https://chythra-workers-access-dev-docs-v2.preview.developers.cloudflare.com/workers/static-assets/migration-guides/migrate-from-pages/

@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Review

✅ No issues found in commit f59d5d4.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

No code review issues found.

Conventions

No convention issues found.

Style Guide Review

No style-guide issues found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.
/rebase Rebases the PR branch against production. On conflict, attempts to resolve automatically using AI. Stops with an explanation if confidence is not high enough.

@chythram05
chythram05 force-pushed the chythra/workers-access-dev-docs-v2 branch from ef9f262 to 45e2ae4 Compare August 12, 2026 20:52
@dinasaur404
dinasaur404 requested a review from hoan-pom as a code owner August 14, 2026 12:17
@WalshyDev

Copy link
Copy Markdown
Member

/rebase

@cloudflare-docs-bot
cloudflare-docs-bot Bot force-pushed the chythra/workers-access-dev-docs-v2 branch from 720d3b2 to 1f2ab7d Compare August 14, 2026 12:18

@MattieTK MattieTK left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Nothing blocking, all nits.


| I want to protect... | Section | API destination type |
| ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------ |
| Preview deployments for **all Workers** | [Protect all Workers](#protect-all-workers) | `all_preview_workers` |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This is a pretty verbose table for what are effectively three options across production/preview/other. We can fix it later.

Comment thread src/content/docs/workers/configuration/cloudflare-access.mdx Outdated
Comment thread src/content/docs/workers/configuration/cloudflare-access.mdx Outdated
dinasaur404 and others added 2 commits August 14, 2026 08:35
Co-authored-by: Matt ‘TK’ Taylor <matttaylor@cloudflare.com>
Co-authored-by: Matt ‘TK’ Taylor <matttaylor@cloudflare.com>
@dinasaur404
dinasaur404 enabled auto-merge (squash) August 14, 2026 12:44
@dinasaur404
dinasaur404 merged commit d86573f into production Aug 14, 2026
13 checks passed
@dinasaur404
dinasaur404 deleted the chythra/workers-access-dev-docs-v2 branch August 14, 2026 12:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.