Verbinden Sie Ihr Cloudflare-Konto für Pages, CDN und DNS

Was Ihnen die Verbindung bringt

Durch das Verbinden Ihres Cloudflare-Kontos können wir statische Websites auf Cloudflare Pages in Ihrem Konto veröffentlichen und das DNS sowie den Cache Ihrer Websites darüber bereitstellen. Alles verbleibt in Ihrem eigenen Cloudflare-Dashboard und in Ihrem eigenen Cloudflare-Tarif.

Bevor Sie beginnen

Ein Cloudflare-Konto, zu dem die von Ihnen gewünschten Domains als Zonen hinzugefügt wurden. Der kostenlose Tarif reicht für die Verbindung aus; welche Aktionen Sie für die jeweilige Zone ausführen können, hängt von den Möglichkeiten Ihres Tarifs ab.

1. Schlüssel bei Cloudflare erstellen

Öffnen Sie im Cloudflare-Dashboard Mein Profil → API-Token und wählen Sie Token erstellen, danach Benutzerdefiniertes Token erstellen. Vergeben Sie einen Namen, fügen Sie die unten aufgeführten Berechtigungen hinzu und wählen Sie unter Zonenressourcen die Zonen aus, auf die wir zugreifen dürfen — alle Zonen oder nur die von Ihnen angegebenen. Überprüfen Sie die Angaben und klicken Sie auf Token erstellen. Cloudflare zeigt das Token nur einmal an; kopieren Sie es direkt.

Fügen Sie diese Berechtigungen hinzu:

• Zone → Zone → Lesen
• Zone → DNS → Bearbeiten
• Zone → Cache-Bereinigung → Bereinigen
• Zone → Zoneneinstellungen → Bearbeiten
• Konto → Cloudflare Pages → Bearbeiten — nur erforderlich, wenn wir Websites auf Pages veröffentlichen sollen. Ein Token

ohne diese Berechtigung verbindet sich dennoch und funktioniert für DNS und Cache.

Die ältere Alternative. Anstelle eines Tokens können Sie die Verbindung über Ihren Globalen API-Schlüssel und die E-Mail-Adresse herstellen, mit der Sie sich anmelden (Mein Profil → API-Token → API-Schlüssel → Globaler API-Schlüssel → Anzeigen). Cloudflare rät davon ab: Der globale API-Schlüssel besitzt sämtliche Berechtigungen, über die Ihr Login verfügt, für jede Zone, und kann nicht eingeschränkt werden. Verwenden Sie nach Möglichkeit ein Token.

2. Hier verbinden

Öffnen Sie Integrationen in Ihrem Dashboard und wählen Sie Konto verbinden. Wählen Sie Cloudflare-Konto (Pages, CDN & DNS) als Gruppe und Cloudflare als Konto, tragen Sie das API-Token ein — oder, für die ältere Alternative, den API-Schlüssel und die Konto-E-Mail — und klicken Sie auf Konto verbinden.

Wir testen Ihre Eingabe, bevor irgendetwas gespeichert wird. Ein Schlüssel, der nicht funktioniert, wird niemals gespeichert, und die Rückmeldung gibt an, was daran fehlerhaft war. Ein funktionierender Schlüssel wird verschlüsselt in unserem Tresor für Zugangsdaten aufbewahrt — niemals in unserer Datenbank — und wird nie wieder angezeigt, nicht einmal Ihnen.

Was als Nächstes passiert

• Cloudflare Pages erscheint als Bereitstellungsziel, wenn Sie eine statische Website

erstellen oder verschieben, und wir veröffentlichen das Build in einem Pages-Projekt Ihres Kontos.

• Ihre Zonen können das DNS einer Domain und den Cache einer Website über dieses Konto bereitstellen.
• Wir prüfen, ob das Token Ihre Zonen lesen, DNS bearbeiten, den Cache leeren und Zoneneinstellungen ändern kann.

Die Checkliste neben der Verbindung zeigt an, welche dieser Punkte wir bestätigen konnten.

Wenn Sie CDN und DNS auf verschiedenen Cloudflare-Konten verwalten möchten, verbinden Sie diese stattdessen separat als Cloudflare CDN und Cloudflare DNS — für beide gibt es eine eigene Anleitung.

Falls keine Verbindung zustande kommt

Eine Berechtigung wird als unbestätigt angezeigt. Cloudflare erlaubt es einem Token nicht immer, seine eigenen Berechtigungen aufzulisten, daher werden manche erst bei der ersten Verwendung bestätigt. Schlägt eine Aktion später mit einem Berechtigungsfehler fehl, bearbeiten Sie das Token unter Mein Profil → API-Token und fügen Sie die fehlende Berechtigung hinzu — der Token-Wert ändert sich dadurch nicht, sodass keine erneute Verbindung erforderlich ist.

Eine Zone fehlt. Die Zonenressourcen des Tokens enthalten diese Zone nicht. Bearbeiten Sie das Token, um diese Zone oder alle Zonen einzuschließen.

Es wird gemeldet, dass der Schlüssel abgelehnt wurde. Fast immer liegt dies an einem von drei Gründen: ein mitkopiertes Leerzeichen oder ein Zeilenumbruch, ein abgelaufener Schlüssel oder ein Schlüssel, der widerrufen bzw. neu generiert wurde, nachdem Sie ihn kopiert haben. Erstellen Sie einen neuen Schlüssel und fügen Sie ihn erneut ein.

Die Verbindung gelingt, aber später schlägt etwas fehl. Der Schlüssel authentifiziert sich, verfügt jedoch nicht über eine Berechtigung, die für die Aktion erforderlich ist. Erstellen Sie einen neuen Schlüssel mit den oben aufgeführten Berechtigungen, trennen Sie dann die alte Verbindung und verbinden Sie den neuen Schlüssel.

Verbindung trennen

Öffnen Sie Integrationen, suchen Sie das Konto und klicken Sie auf Trennen. Dadurch wird der gespeicherte Schlüssel sofort gelöscht. Jeder Vorgang, der ihn verwendet hat, stoppt bei der nächsten Aktion, und die Bereiche, die darauf angewiesen waren, weisen darauf hin, anstatt stillschweigend fehlzuschlagen.

Das Trennen der Verbindung macht bereits erfolgte Änderungen nicht rückgängig — Einträge, Bereitstellungen oder Einstellungen, die wir in Ihrem Konto geändert haben, bleiben unverändert bestehen. Falls Sie befürchten, dass der Schlüssel selbst kompromittiert wurde, widerrufen Sie ihn zusätzlich beim Anbieter; durch das Trennen der Verbindung wird nur unsere Kopie entfernt, nicht deren.