Connecter Cloudflare Pages

Cloudflare sépare le webhook (la destination) de la notification (ce qui le déclenche) : à la main, il faut créer les deux, dans cet ordre, au niveau du compte. Le bouton Connecter s'en charge, et filtre la notification sur le seul projet Pages concerné. Cette intégration ne sert qu'aux sites déployés sur Cloudflare Pages.

En un clic (recommandé)

1. Ouvrez Projet → Intégrations, carte Déploiement, section Cloudflare Pages.
2. Cliquez sur Connecter Cloudflare. Cloudflare affiche les permissions demandées : lecture des paramètres du compte, lecture de Pages, lecture et écriture des notifications, et offline_access pour pouvoir débrancher des mois plus tard.
3. Au retour, PostShip cherche le projet Pages dont le domaine correspond à l'URL de production du projet. S'il faut choisir : « Quel projet Pages correspond à celui-ci ? », puis Brancher.
4. La carte affiche Débrancher Cloudflare.

PostShip a alors créé dans votre compte une destination webhook (avec un secret qu'il garde) et une règle pages_event_alert filtrée sur le projet Pages choisi. Sans ce filtre, un compte qui héberge quatre sites ferait vérifier celui-ci à chaque déploiement des trois autres. Débrancher supprime la règle et la destination.

Le repli : créer la destination

Dans le tableau de bord Cloudflare, au niveau du compte. Le lien Ouvrir les notifications Cloudflare sur la carte y mène.

1. Ouvrez Notifications → Destinations → Webhooks → Create.
2. Collez L'URL du webhook affichée sur la carte, de la forme https://postship.fr/api/cloudflare/deploy/<id du projet>.
3. Cloudflare génère un secret à la création : copiez-le dans le champ Secret de la carte et cliquez sur Enregistrer.

Le repli : créer la notification

Le webhook seul ne reçoit rien tant qu'aucune notification ne pointe dessus.

1. Ouvrez Notifications → Add.
2. Choisissez Pages, puis l'événement Pages Deployment Success.
3. Comme destination, sélectionnez le webhook créé juste avant.
4. Enregistrez.

Ce que PostShip fait de l'événement

• Cloudflare ne signe pas le corps : le secret de la destination est renvoyé tel quel dans l'en-tête cf-webhook-auth à chaque livraison. PostShip le compare en temps constant ; sinon 401 Invalid signature.
• Le champ alert_type est lu. Une notification qui n'est manifestement pas un déploiement Pages (une alerte de santé, un changement DNS que vous auriez dirigé vers la même destination) est ignorée et répond triggered: false. Ce qui n'est pas reconnu passe : se tromper dans ce sens coûte une vérification de trop, pas une panne silencieuse.
• Le doute vaut production. PostShip ne bascule en preview que sur un signal explicite : environment égal à preview, ou une adresse de déploiement en <label>.<projet>.pages.dev — un label de plus que la production, qui répond sur <projet>.pages.dev.
• Le commit vient de deployment_trigger.metadata.commit_hash quand Cloudflare le donne. Le webhook Cloudflare ne publie pas de Check GitHub.

Une production déclenche tout ce que décrit Connecter votre hébergeur.

Vérifier que ça marche

La carte passe à « Dernier webhook reçu il y a … » dès la première requête acceptée. Si rien n'arrive après un déploiement réussi, c'est presque toujours la notification qui manque : le webhook peut très bien exister sans que rien ne le déclenche.

Limites et plans

Sur Free, le webhook répond 403 Plan does not include this même authentifié. Voir les plans.

Dépannage

Pourquoi une vérification part quand un autre de mes sites Pages déploie ?

La notification créée à la main n'est pas filtrée par projet. Éditez-la dans Cloudflare et limitez-la au projet Pages concerné, ou passez par Connecter Cloudflare, qui pose ce filtre.

Pourquoi « Débrancher » a échoué des mois après ?

Le jeton Cloudflare expire au bout d'une heure environ et se renouvelle grâce à offline_access. Si l'autorisation a été révoquée côté Cloudflare entre-temps, PostShip ne peut plus retirer la règle : supprimez-la vous-même dans Notifications, puis débranchez.

Pourquoi la ligne dans Déplois n'a pas de commit ?

Cloudflare ne documente pas la forme de data pour les déploiements Pages ; le commit n'est lu que s'il est présent sous deployment_trigger.metadata.commit_hash. Sans lui, la ligne reste juste — elle ne porte simplement pas de sha.