Skip to content

docs: make CF Access optional, clarify security model#6

Open
madtank wants to merge 1 commit intomainfrom
docs/update-security-and-cf-access
Open

docs: make CF Access optional, clarify security model#6
madtank wants to merge 1 commit intomainfrom
docs/update-security-and-cf-access

Conversation

@madtank
Copy link
Member

@madtank madtank commented Feb 4, 2026

Summary

  • Makes Cloudflare Access clearly optional — only needed for the admin UI at /_admin/
  • Adds prominent warning: enabling CF Access on the entire domain blocks aX webhook delivery
  • Documents the actual security model: gateway token + HMAC + device pairing are the primary layers
  • Adds webhook troubleshooting tip for aX Platform
  • Marks CF_ACCESS_TEAM_DOMAIN and CF_ACCESS_AUD as optional in the secrets table

Context

CF Access was listed as a required setup step, but enabling it on the entire workers.dev domain blocks all external requests including aX Platform webhooks to /ax/dispatch. The worker is already secured by the gateway token (Control UI), HMAC verification (webhooks), and device pairing.

Test plan

  • README renders correctly on GitHub
  • Security section accurately reflects the auth layers

🤖 Generated with Claude Code

- CF Access is now clearly optional (only needed for admin UI)
- Added warning about CF Access blocking aX webhooks if enabled on entire domain
- Reordered authentication layers: gateway token and HMAC are primary security
- Added HMAC webhook verification to security docs
- Added aX webhook troubleshooting tip
- Updated secrets reference: CF_ACCESS_* marked as optional

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@cloudflare-workers-and-pages
Copy link

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
ax-moltworker 05d8986 Feb 04 2026, 07:45 PM

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.

1 participant