docs(sops): exact Cloudflare token creation steps (Zone scope, not Account)

The terse 'Zone->DNS->Edit + Zone->Read' sent the operator to the Account
permission scope. Spell out switching the scope dropdown to Zone + the exact
two Zone-scoped rows + Specific-zone resource.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
This commit is contained in:
jakman85andClaude Opus 4.8 committed 2026-08-16 22:41:02 -05:00
1 parent c0df86c87d
commit 4f3be7ef79
1 file changed
+14 -2
+14 -2
View File
@@ -58,8 +58,20 @@ kubectl kustomize platform/<component> >/dev/null && git add -A && git commit
| `oauth2-proxy-credentials` | `oauth2-proxy` | `client-id`, `client-secret`, `cookie-secret` ⚠️verify chart keys | oauth2-proxy forward-auth | 6 | `oauth2-proxy-credentials.yaml.example` |
| `pia-credentials` | *(Phase-3 VPN ns, TBA)* | `username`, `password` | Gluetun VPN egress (protocol ≠ TCP) — **not wired yet** | 3 | `pia-credentials.yaml.example` |
**Cloudflare token scope:** one API token with **Zone → DNS → Edit** + **Zone → Read** on the
`keithjackson.dev` zone serves both cert-manager (DNS-01) and ExternalDNS. Same value in both namespace copies.
**Cloudflare token — exact creation steps** (My Profile → API Tokens → Create Token → **Custom token**):
one token serves both cert-manager (DNS-01 `_acme-challenge` TXT) and ExternalDNS (A/CNAME), same value
in both namespace copies. In each Permissions row, the left dropdown defaults to **Account** — switch it
to **Zone** (Account-scope groups like "Account DNS Settings"/"DNS Firewall"/"Registrar Domains" are the
wrong scope and not needed). Set:
| Scope | Group | Access |
|---|---|---|
| Zone | DNS | Edit |
| Zone | Zone | Read |
- **Zone Resources:** Include → Specific zone → `keithjackson.dev`.
- Leave Client-IP/TTL filtering blank → Continue to summary → Create Token → copy the value into the
`api-token` field of **both** `cloudflare-api-token` secret copies.
---