Gestion des Webhooks

Création d'un Webhook

Pour créer un webhook, choisissez l’une des options suivantes :

• Dans la barre d’outils d’Orchestrator, sélectionnez l’icône Plus, puis sélectionnez Webhook.
• À partir de la page du locataire, sélectionnez Webhooks, puis sélectionnez Ajouter un webhook (Add webhook).

Ensuite, sur la page Ajouter un webhook (Add Webhook), continuez avec la configuration suivante :

1. Dans le champ obligatoire Nom (Name), saisissez un nom pour votre webhook. Une chaîne de 128 caractères au maximum est autorisée.
   Remarque : assurez-vous que le nom est unique, car deux webhooks actifs ne peuvent pas partager le même nom au niveau du locataire. Un nom spécifique est publié lorsque le webhook correspondant est supprimé.
2. Dans le champ Description, saisissez une description de votre webhook. Une chaîne de 256 caractères au maximum est autorisée.
3. Dans le champ URL (URL), indiquez une URL personnalisée vers laquelle envoyer des informations depuis Orchestrator.
4. Cochez la case Désactiver la vérification de SSL (Disable SSL Verification) si vous ne voulez pas que la communication du Webhook soit sécurisée. Notez que nous ne recommandons pas cette solution.
5. Décochez la case Activé (Enabled) si vous voulez désactiver le Webhook que vous créez.
6. (Facultatif) Ajoutez une clé secrète personnalisée, pouvant contenir jusqu'à 100 caractères, si vous souhaitez que l'authentification du webhook soit plus sécurisée.
7. Sélectionnez l'option Envoyer tous les événements (Send All Events) ou Sélectionner les événements individuels (Select Individual Events). La première option permet d'envoyer tous les événements Orchestrator disponibles à l'URL spécifiée, tandis que la dernière permet d'indiquer des événements individuels.
8. Cliquez sur Enregistrer (Save). Le Webhook a été créé. Vous commencez à recevoir la charge utile correspondante dès qu'ils sont déclenchés.

Modification d'un Webhook

1. Cliquez sur le bouton Modifier (Edit) correspondant. La page Modifier (Edit) s'affiche.
2. Apportez les modifications nécessaires à votre Webhook (tous les champs sont modifiables).
3. Cliquez sur Mettre à jour (Update). Vos modifications sont correctement enregistrées et la page Webhooks (Webhooks) mise à jour s'affiche.

Activation ou désactivation d'un Webhook

Pour activer ou désactiver un Webhook, cliquez sur la bascule dans la colonne Activé (Enabled). Lorsqu'un Webhook est activé, la bascule est bleue.

Attention : les webhooks qui échouent dans plus de 50 % de cas par jour pendant 7 jours consécutifs sont automatiquement désactivés. Lorsque cela se produit, vous en êtes informé et une entrée est enregistrée dans la fenêtre d'audit. L'entrée d'audit est attribuée à User System Administrator, qui est un nom d'utilisateur pour tous les actions effectuées par le système.

Suppression d'un Webhook

1. Cliquez sur le bouton Supprimer (Delete) correspondant. Vous êtes invité à confirmer.
2. Cliquez sur Oui (Yes). Le Webhook est supprimé et la page Webhooks (Webhooks) mise à jour s'affiche.