Skip to content

docs(protect-edge): tarball download + auto-inject mode - #57

Merged
forgetso merged 1 commit into
mainfrom
docs/protect-edge-tarball-and-inject
Aug 21, 2026
Merged

docs(protect-edge): tarball download + auto-inject mode#57
forgetso merged 1 commit into
mainfrom
docs/protect-edge-tarball-and-inject

Conversation

@forgetso

Copy link
Copy Markdown
Member

Summary

Companion to https://github.com/prosopo/Protect/pull/515 which adds:

  • SITE_KEY wrangler var → worker auto-injects the client bundle via HTMLRewriter
  • npm run pack → produces Prosopo-Cloudflare-<version>.tgz published at packages.prosopo.io/cloud/

This PR documents both:

  1. New "Deployment modes" section near the top — explains auto-inject (recommended, DataDome-style) vs manual snippet.
  2. "What you get" rewrites — swaps the customer-specific zip handoff for the public tarball URL.
  3. Part 2 restructured — 2a auto-inject, 2b manual snippet, 2c form-submit gating (unchanged), 2d verify (unchanged).
  4. CSP note on the auto-inject path — customers with a CSP need https://js.protect.prosopo.io in script-src and https://protect.<domain> in connect-src.

CLIENT_JWT + PROTECT_URL are called out as required in both modes so no one drops CLIENT_JWT thinking auto-inject replaces it.

Test plan

  • mdx renders without syntax errors.
  • Local npm run dev in packages/docs to spot-check the rendered page (blocker: docs branch merge order — this PR renumbers 2b→2c and 2c→2d, so any cross-links pointing at those anchors need updating).
  • Translations sweep for fr/de/es/it/pt-br after English lands.

🤖 Generated with Claude Code

@netlify

netlify Bot commented Aug 21, 2026

Copy link
Copy Markdown

Deploy Preview for peaceful-pothos-9e62ce ready!

Name Link
🔨 Latest commit d2625c5
🔍 Latest deploy log https://app.netlify.com/projects/peaceful-pothos-9e62ce/deploys/6a88d0ceffd4a90008e3566a
😎 Deploy Preview https://deploy-preview-57--peaceful-pothos-9e62ce.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Companion to prosopo/Protect#515. Documents the two deployment paths
customers can pick from:

1. Auto-inject (recommended, DataDome-style): set SITE_KEY in
   wrangler.toml → worker HTMLRewrites every allowed HTML response
   and appends the bundle <script> tags into <head>. Customer never
   touches HTML.

2. Manual snippet: leave SITE_KEY out, paste the two-tag block into
   your header/footer template yourself. Same shape as today.

Also swaps the "What you get" section from the old customer-specific
zip handoff to the public tarball URL
(packages.prosopo.io/cloud/Prosopo-Cloudflare-latest.tgz).

Part 2 renumbered — new 2a for auto-inject, 2b for manual snippet,
2c for form-submit gating (unchanged), 2d for verify (unchanged).
Adds a CSP note for the auto-inject path.

CLIENT_JWT + PROTECT_URL are called out as required in both modes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@forgetso
forgetso force-pushed the docs/protect-edge-tarball-and-inject branch from adf8015 to d2625c5 Compare August 21, 2026 22:27
@forgetso
forgetso merged commit 5182290 into main Aug 21, 2026
4 checks passed
@forgetso
forgetso deleted the docs/protect-edge-tarball-and-inject branch August 21, 2026 22:28
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