🔐 Let's Encrypt Wizard
English ← Zpět do průvodce

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ů, README ani ZIPu. Zadáš ho až při spuštění issue.sh / issue.ps1 na serveru (viz níže). Vygenerované soubory proto můžeš bez obav přeposlat.

Postup

  1. Přihlas se do Cloudflare dashboardu → API Tokens
  2. Klikni Create Token → Create Custom Token
  3. Nastav:
    • Token name: letsencrypt-dns (klidně i s názvem serveru, ať za rok víš, kde token bydlí)
    • Permissions:
      • Zone → DNS → Edit
      • Zone → 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šíš.
  4. Continue to summary → Create Token
  5. 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

sudo ls -la /etc/letsencrypt/secrets/
# drwx------ root root .
# -rw------- root root cloudflare.ini

Windows — issue.ps1

Zrušení a obnova tokenu (rotace)

  1. V dashboardu starý token Roll (vygeneruje novou hodnotu se stejnými právy) nebo Delete a vytvoř nový podle postupu výše.
  2. Na serveru spusť znovu issue.sh / issue.ps1 — zeptá se na nový token a uloží ho na stejné místo (Linux: přepíše cloudflare.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
  3. 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í