À propos des webhooks globaux
Vous pouvez utiliser des webhooks globaux pour notifier un serveur web externe quand des événements se produisent dans votre entreprise. Vous pouvez configurer le serveur pour qu’il reçoive la charge utile du webhook, puis exécute une application ou un code qui supervise, traite ou applique des règles pour la gestion des utilisateurs et des organisations pour votre entreprise. Pour plus d’informations, consultez « Documentation sur les webhooks ».
Par exemple, vous pouvez configurer GitHub.com pour qu’il envoie un webhook quand quelqu’un crée, supprime ou modifie un référentiel ou une organisation au sein de votre entreprise. Vous pouvez configurer le serveur pour qu’il effectue automatiquement une tâche après avoir reçu le webhook.
Ajout d’un webhook global
-
Dans le coin supérieur droit de GitHub.com, cliquez sur votre photo de profil, puis sur Vos entreprises.
-
Dans la liste des entreprises, cliquez sur l’entreprise que vous souhaitez afficher. 1. Dans la barre latérale du compte d’entreprise, cliquez sur Paramètres. 1. Sous « Paramètres », cliquez sur Hooks.
-
Cliquez sur Ajouter un webhook.
-
Dans le champ « URL de la charge utile », tapez l’URL où vous souhaitez recevoir les charges utiles.
-
Si vous le souhaitez, sélectionnez le menu déroulant Type de contenu et cliquez sur un format de données dans lequel recevoir la charge utile du webhook.
-
Si vous le souhaitez, dans le champ Secret, tapez une chaîne à utiliser comme clé
secret
. -
Si votre URL de charge utile est une URL HTTPS et que vous ne voulez pas que GitHub Enterprise Server vérifie les certificats SSL à la remise de charges utiles, sous « Vérification SSL », sélectionnez Désactiver. Lisez les informations relatives à la vérification SSL, puis cliquez sur Désactiver, je comprends que mes webhooks ne sont peut-être pas sécurisés.
Avertissement : La vérification SSL garantit que les charges utiles de webhooks sont remises de manière sécurisée. Nous vous déconseillons de désactiver la vérification SSL.
-
Sous « À quels événements souhaitez-vous déclencher ce webhook ? », sélectionnez si vous souhaitez que ce webhook se déclenche pour chaque événement ou pour les événements sélectionnés.
- Pour un déclenchement pour chaque événement, sélectionnez Tout m’envoyer.
- Pour choisir des événements spécifiques, sélectionnez Sélectionner des événements individuels.
-
Si vous choisissez de sélectionner des événements individuels, sélectionnez les événements qui déclencheront le webhook.
-
Pour rendre le webhook actif immédiatement après l’ajout de la configuration, sélectionnez Actif.
-
Cliquez sur Ajouter un webhook.
Modification d’un webhook global
-
Dans le coin supérieur droit de GitHub.com, cliquez sur votre photo de profil, puis sur Vos entreprises.
-
Dans la liste des entreprises, cliquez sur l’entreprise que vous souhaitez afficher. 1. Dans la barre latérale du compte d’entreprise, cliquez sur Paramètres. 1. Sous « Paramètres », cliquez sur Hooks.
-
En regard du webhook que vous souhaitez modifier, cliquez sur Modifier.
-
Mettez à jour les paramètres du webhook.
-
Cliquez sur Mettre à jour le webhook.
Suppression d’un webhook global
-
Dans le coin supérieur droit de GitHub.com, cliquez sur votre photo de profil, puis sur Vos entreprises.
-
Dans la liste des entreprises, cliquez sur l’entreprise que vous souhaitez afficher. 1. Dans la barre latérale du compte d’entreprise, cliquez sur Paramètres. 1. Sous « Paramètres », cliquez sur Hooks.
-
En regard du webhook que vous souhaitez supprimer, cliquez sur Supprimer.
-
Lisez les informations sur la suppression d’un webhook, puis cliquez sur Oui, supprimer le webhook.
Visualisation des remises et réponses récentes
Vous pouvez consulter les détails des livraisons de webhooks qui se sont produites au cours des 30 derniers jours. Pour plus d’informations, consultez « Affichage des livraisons de webhook ».