Jak vytvořit Cloudflare API token pro DNS-01
Pro DNS-01 validaci přes Cloudflare (nutná pro wildcard, praktická všude, kde port 80 není dostupný z internetu) potřebuješ scoped API token — ne „Global API Key" (ten má práva na celý účet a nedá se omezit).
Token se nikdy nezadává do wizardu. Wizard ho po tobě nechce, neukládá ho v prohlížeči a nevkládá ho do vygenerovaných skriptů,
READMEani ZIPu. Zadáš ho až při spuštěníissue.sh/issue.ps1na serveru (viz níže). Vygenerované soubory proto můžeš bez obav přeposlat.
Postup
- Přihlas se do Cloudflare dashboardu → API Tokens
- Klikni Create Token → Create Custom Token
- Nastav:
- Token name:
letsencrypt-dns(klidně i s názvem serveru, ať za rok víš, kde token bydlí) - Permissions:
Zone→DNS→EditZone→Zone→Read
- Zone Resources:
Include→Specific zone→ vyber svou doménu (např.example.com)
- Client IP Address Filtering: volitelně omez na veřejnou IP serveru
- TTL: nastav expiraci (např. 1 rok) a token po expiraci obnov (postup níže). Token bez expirace jen pokud rozumíš riziku — uniklý token bez expirace funguje, dokud ho ručně nezrušíš.
- Token name:
- Continue to summary → Create Token
- Zkopíruj token (zobrazí se jen jednou!) a ulož si ho do správce hesel — budeš ho potřebovat při spuštění skriptu na serveru.
Test tokenu
curl -X GET "https://api.cloudflare.com/client/v4/user/tokens/verify" \
-H "Authorization: Bearer TVUJ_TOKEN" \
-H "Content-Type: application/json"
Měl by vrátit "status": "active".
Kde token zadáš a kde pak bydlí
Linux — issue.sh
- Skript se na token zeptá přes
read -s(nezobrazí se na obrazovce, nejde do historie shellu). - Uloží ho jen do
/etc/letsencrypt/secrets/cloudflare.ini— adresář s právy700, soubor600, vlastníkroot. Práva se nastaví dřív, než se do souboru cokoli zapíše. - Při každé obnově ho certbot čte odtud (
--dns-cloudflare-credentials); znovu ho zadávat nemusíš.
sudo ls -la /etc/letsencrypt/secrets/
# drwx------ root root .
# -rw------- root root cloudflare.ini
Windows — issue.ps1
- Skript se zeptá přes
Read-Host -AsSecureStringa token předá win-acme (--cloudflareapitoken). - win-acme si ho pro obnovy uloží zašifrovaně (Windows DPAPI) do konfigurace obnovy (
C:\ProgramData\win-acme\<acme-server>\Renewals\). Rozšifrovat ho jde jen na tomto počítači pod účtem, který ho uložil. - Pokud nechceš token ani jednou předat jako parametr příkazu (historie PowerShellu, logy), použij trezor win-acme:
wacs.exe --vault→ ulož token pod klíčemcloudflarea ve skriptu místo hodnoty použij odkazvault://json/cloudflare. Vygenerovanýissue.ps1tuhle možnost v komentáři popisuje.
Zrušení a obnova tokenu (rotace)
- V dashboardu starý token Roll (vygeneruje novou hodnotu se stejnými právy) nebo Delete a vytvoř nový podle postupu výše.
- Na serveru spusť znovu
issue.sh/issue.ps1— zeptá se na nový token a uloží ho na stejné místo (Linux: přepíšecloudflare.ini; Windows: win-acme aktualizuje uložený renewal). Pokud certifikát ještě nepotřebuje obnovu, certbot ho ponechá; případné nové vystavení nevadí — hooky se postarají o nasazení.- Linux alternativně jen:
sudoedit /etc/letsencrypt/secrets/cloudflare.ini
- Linux alternativně jen:
- Ověř obnovu nanečisto:
sudo certbot renew --dry-run/.\renew-test.ps1(viz řešení problémů).
Kdy rotovat: po expiraci (obnovy začnou padat na Authentication error (10000)), při podezření na únik (token viděl někdo, kdo neměl — ticket, screenshot, sdílená obrazovka), když server opouští tvé ruce.
Bezpečnost — shrnutí
- Token vidíš jen ty (při zadání) a tvůj server. Wizard, vygenerované skripty ani ZIP ho neobsahují.
- Minimální oprávnění: jedna zóna,
DNS:Edit+Zone:Read, expirace, případně IP filtr. - Nikdy ho nedávej do ticketů, e-mailů ani hlášení chyb.
- Kompromitace → okamžitě Delete/Roll v dashboardu, potom rotace na serveru (výše).