Tutorials

Cloudflare Key-Authentifizierung einrichten: Der ultimative Guide [2025 Easy Guide]

Melden

Hier ist ein aktueller und leicht verständlicher Guide für das Jahr 2025, wie du die Key-Authentifizierung (API-Tokens) bei Cloudflare einrichtest.

Die Authentifizierung über Keys (Schlüssel) ist der sicherste Weg, um deine Cloudflare-Einstellungen mit Drittanbieter-Apps (wie WordPress-Plugins, Certbot oder eigenen Skripten) zu verbinden. Im Jahr 2025 nutzen wir dafür primär API-Tokens, da sie sicherer sind als der alte "Global API Key".

Warum API-Tokens statt Global API Key?

  • Sicherheit: Ein Token hat nur Zugriff auf das, was du explizit erlaubst (Least Privilege Prinzip).
  • Kontrolle: Du kannst Tokens jederzeit einzeln löschen, ohne dein gesamtes Passwort ändern zu müssen.
  • Ablaufdatum: Du kannst Tokens zeitlich begrenzen.

Schritt 1: Zugriff auf das API-Dashboard

  1. Melde dich in deinem Cloudflare Dashboard an.
  2. Klicke oben rechts auf das Benutzer-Icon (Männchen-Symbol).
  3. Wähle im Menü den Punkt "My Profile" (Mein Profil).
  4. Klicke in der linken Seitenleiste auf "API Tokens".

Schritt 2: Einen neuen API-Token erstellen

  1. Klicke auf den blauen Button "Create Token".
  2. Du hast nun zwei Möglichkeiten:
    • Templates (Empfohlen): Cloudflare bietet Vorlagen für häufige Aufgaben (z. B. "Edit Zone DNS" für SSL-Zertifikate).
    • Custom Token: Erstelle einen eigenen Schlüssel von Grund auf.
  3. Wähle für dieses Tutorial eine Vorlage, z. B. "Edit Zone DNS", wenn du den Key für DNS-Aktualisierungen benötigst.

Schritt 3: Berechtigungen und Scoping konfigurieren

Hier legst du fest, was der Key darf:

  1. Token Name: Gib ihm einen Namen (z. B. "WordPress-Cache-Plugin" oder "Synology-DNS").
  2. Permissions: Hier ist durch das Template meist schon alles richtig eingestellt (z. B. Zone -> DNS -> Edit).
  3. Zone Resources: Wähle unter "Include" -> "Specific zone" deine Domain aus. So verhinderst du, dass der Key Zugriff auf alle deine Domains hat.
  4. Client IP Address Filtering (Optional aber Sicher): Gib hier deine Server-IP ein, damit nur Anfragen von diesem Server akzeptiert werden.
  5. TTL (Ablaufdatum): Du kannst festlegen, wie lange der Key gültig sein soll.

Schritt 4: Token generieren und sicher speichern

  1. Klicke auf "Continue to summary" und dann auf "Create Token".
  2. WICHTIG: Dein API-Token wird jetzt angezeigt. Cloudflare zeigt dir diesen Key nur ein einziges Mal.
  3. Kopiere den Token und speichere ihn in einem Passwort-Manager.
  4. Nutze den Button "Test API Token", um mit einem curl-Befehl im Terminal zu prüfen, ob der Key funktioniert.

Alternative: Der Global API Key (Nicht empfohlen)

Falls eine alte App unbedingt den "Global API Key" verlangt:

  1. Gehe zurück zur Seite API Tokens.
  2. Suche unten den Bereich "Global API Key".
  3. Klicke auf "View", gib dein Passwort ein und löse das Captcha.
  4. Achtung: Dieser Key ist wie ein Generalschlüssel zu deinem Haus. Teile ihn niemals öffentlich!

Anwendung: So nutzt du den Key

Wenn du den Key z. B. in einem Linux-Terminal testen willst, sieht der Befehl so aus:

curl -X GET "https://api.cloudflare.com/client/v4/user/tokens/verify" \
     -H "Authorization: Bearer DEIN_NEUER_TOKEN" \
     -H "Content-Type:application/json"

Wenn du ein "status": "active" zurückbekommst, war die Einrichtung erfolgreich!

3 Profi-Tipps für 2025:

  1. Ein Token pro App: Erstelle für jede Anwendung (z. B. eine für die Firewall, eine für DNS) einen eigenen Token.
  2. Regelmäßiges Audit: Schau alle 6 Monate in deine API-Liste und lösche Tokens, die du nicht mehr aktiv nutzt.
  3. 2FA aktivieren: Da API-Keys mächtig sind, sollte dein Cloudflare-Account zwingend mit 2-Faktor-Authentifizierung (WebAuthn oder Authenticator App) gesichert sein.

Fertig! Du hast nun erfolgreich eine sichere Key-Authentifizierung für dein Cloudflare-Konto eingerichtet.

0