oauth2-setup — gate OAuth / Cloudflare Pages
Read and follow references/oauth2-setup/protocol.md (protocol SSOT).
Qué logra
Protege sitios estáticos privados (handbook, academy, storybook, docs) con un gate
server-side que pide login. Incluye el deploy a Cloudflare Pages vía
wrangler y las dos vías de autenticación de Cloudflare.
Resumen
Modelo de autorización: correo verificado en dominio (ej.
@chimeranext.dev) o membresía en teams de la org (ej.developers,founders).Deploy a Cloudflare Pages:
# Vía 1 (MUST): OAuth interactivo npx wrangler login # Vía 2 (fallback, no-interactivo): API Token export CLOUDFLARE_API_TOKEN=<token> # Deploy npx wrangler pages deploy . --project-name=<nombre-proyecto>Credenciales: OAuth interactivo guarda en
~/.config/.wrangler/config/default.toml(odefault.enc+ keyring). El API Token es solo para CI/headless.
Lecciones clave
- Vercel Hobby no despliega repos de organizaciones GitHub (requiere Pro); Cloudflare Pages sí — y conecta con Cloudflare Access.
- Cloudflare ≠ key-chain de Heimdall (
~/.agents/.heimdall.env) — scopes separados.
Lanzar el comando
Usá /oauth2-setup para ejecutar esta guía con el founder/cliente.