Connectez votre compte Cloudflare pour Pages, CDN et DNS

Ce que cette connexion vous apporte

Connecter votre compte Cloudflare nous permet de publier des sites statiques sur Cloudflare Pages au sein de votre compte, et de gérer le DNS ainsi que le cache de vos sites depuis celui-ci. Tout reste hébergé sur votre propre tableau de bord Cloudflare et sur votre propre forfait Cloudflare.

Avant de commencer

Un compte Cloudflare, avec les domaines que vous souhaitez utiliser ajoutés en tant que zones. Le forfait gratuit suffit pour la connexion ; les actions possibles sur chaque zone dépendent de ce que permet votre forfait.

1. Créer la clé sur Cloudflare

Dans le tableau de bord Cloudflare, ouvrez My Profile → API Tokens et choisissez Create Token, puis Create Custom Token. Donnez-lui un nom, ajoutez les autorisations ci-dessous et, sous Zone Resources, choisissez les zones auxquelles vous souhaitez que nous ayons accès — toutes les zones, ou uniquement celles que vous spécifiez. Vérifiez la configuration et appuyez sur Create Token. Cloudflare n’affiche le jeton qu’une seule fois ; copiez-le à ce moment-là.

Ajoutez ces autorisations :

• Zone → Zone → Read
• Zone → DNS → Edit
• Zone → Cache Purge → Purge
• Zone → Zone Settings → Edit
• Account → Cloudflare Pages → Edit — uniquement si vous souhaitez que nous publiions des sites sur Pages. Un jeton sans cette autorisation se connecte tout de même et fonctionne pour le DNS et le cache.

L’ancienne alternative. Au lieu d’un jeton, vous pouvez vous connecter avec votre Global API Key et l’adresse e-mail avec laquelle vous vous connectez (My Profile → API Tokens → API Keys → Global API Key → View). Cloudflare déconseille cette méthode : la Global API Key dispose de toutes les autorisations associées à vos identifiants, sur chaque zone, et ne peut pas être restreinte. Utilisez un jeton si possible.

2. Connecter le compte ici

Ouvrez Intégrations dans votre tableau de bord et choisissez Connecter un compte. Sélectionnez Compte Cloudflare (Pages, CDN et DNS) comme groupe et Cloudflare comme compte, renseignez Jeton API — ou, pour l’ancienne méthode, Clé API et E-mail du compte, puis appuyez sur Connecter le compte.

Nous testons ce que vous collez avant tout enregistrement. Une clé qui ne fonctionne pas n’est jamais conservée, et la réponse indique l’origine du problème. Une clé fonctionnelle est conservée sous forme chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et ne s’affiche plus jamais, pas même pour vous.

Ce qui se passe ensuite

• Cloudflare Pages apparaît comme cible de déploiement lorsque vous créez ou déplacez un site statique, et nous publions le build vers un projet Pages sur votre compte.
• Vos zones peuvent gérer le DNS d’un domaine et le cache d’un site depuis ce compte.
• Nous vérifions que le jeton peut lire vos zones, modifier le DNS, purger le cache et modifier les paramètres de zone. La liste de vérification située à côté de la connexion indique les éléments que nous avons pu confirmer.

Si vous souhaitez conserver le CDN et le DNS sur des comptes Cloudflare différents, connectez-les séparément en tant que Cloudflare CDN et Cloudflare DNS — chacun dispose de son propre guide.

Si la connexion ne s’établit pas

Une autorisation apparaît comme non confirmée. Cloudflare ne permet pas toujours à un jeton d’énumérer ses propres autorisations, de sorte que certaines ne sont confirmées que lors de leur première utilisation. Si une action échoue ultérieurement en raison d’une erreur d’autorisation, modifiez le jeton dans My Profile → API Tokens et ajoutez l’autorisation manquante — la valeur du jeton ne changeant pas, aucune reconnexion n’est nécessaire.

Une zone est manquante. La section Zone Resources du jeton ne l’inclut pas. Modifiez le jeton pour inclure cette zone, ou l’ensemble des zones.

Le message indique que la clé a été rejetée. Il s’agit presque toujours de l’une de ces trois raisons : un espace ou un saut de ligne copié avec la clé, une clé expirée, ou une clé révoquée ou régénérée après sa copie. Créez-en une nouvelle et collez-la à nouveau.

La connexion réussit, mais une action ultérieure échoue. La clé s’authentifie correctement mais ne dispose pas d’une autorisation nécessaire à l’action. Créez une nouvelle clé dotée des autorisations énumérées ci-dessus, puis déconnectez l’ancienne liaison et connectez la nouvelle clé.

Déconnexion

Ouvrez Intégrations, trouvez le compte et appuyez sur Déconnecter. Cela supprime immédiatement la clé enregistrée. Tout élément qui l’utilisait s’arrête lors de sa prochaine action, et les écrans qui en dépendaient vous en informent au lieu d’échouer silencieusement.

La déconnexion n’annule pas ce qui a déjà été effectué — les enregistrements, déploiements ou paramètres que nous avons modifiés sur votre compte restent inchangés. Si vous pensez que la clé elle-même a pu être compromise, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la leur.