Webhooks

Un webhook envoie une requête POST à l’une de vos adresses lorsqu’un événement concerne les paquets que vous choisissez : pour lancer un déploiement, ouvrir une pull request ou publier un message dans un canal de discussion.

Avant de commencer

Vous avez besoin d’une adresse https:// qui accepte les requêtes POST, ou de l’URL de webhook entrant d’un canal Slack ou Discord. Les webhooks d’une équipe se trouvent dans l’organisation : votre organisation → Webhooks, avec les mêmes pages.

Ajouter un webhook

1. Ouvrez Paramètres → Webhooks, puis Ajouter un webhook.
2. Saisissez l’URL de destination (1).
3. Choisissez le Format (2) : JSON (signé) pour votre propre serveur, Slack ou Discord pour un canal.
4. Cochez les Événements (3) : Nouvelles versions, Avis de sécurité, Paquets retirés.
5. Choisissez les Paquets (4) : les paquets que vous suivez, les paquets que vous indiquez par leur nom Composer, ou tous les paquets (un envoi par build du dépôt).
6. Sélectionnez Ajouter le webhook (5).

Pour les webhooks JSON, la page affiche ensuite une seule fois le secret de signature : copiez-le sur votre serveur.

Vérifier un envoi JSON

Chaque envoi JSON porte l’en-tête X-MeteorGPL-Signature: sha256=<HMAC-SHA256 of the body with your secret>. Calculez le même HMAC sur le corps brut et comparez-les avant de faire confiance au contenu. Le corps indique l’événement et, pour chaque paquet, son nom Composer, son titre, son type, les nouvelles versions, un lien et la commande d’installation.

Vos webhooks

Chaque webhook affiche son adresse et son format avec son état : Actif, En pause ou Désactivé après des échecs (1) ; puis ses événements et ses paquets (2).

• Envoyer un test (3) envoie immédiatement un envoi ping.
• Mettre en pause et Activer arrêtent et reprennent les envois ; Retirer supprime le webhook.
• Envois récents (4) affiche chaque envoi avec son résultat, le statut HTTP renvoyé par votre serveur et le nombre de tentatives ; Renvoyer en répète un.

Un envoi qui échoue est retenté plus tard : six tentatives au total, réparties sur environ 15 heures. Après 20 échecs consécutifs, le webhook est désactivé et vous en êtes informé ; corrigez le point de terminaison et sélectionnez Activer.