Gestion des Webhooks

Créez et configurez des webhooks dans Orchestrator afin d’envoyer des notifications d’événements aux systèmes externes.

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. Select Save. The webhook has been created. You start receiving the corresponding payloads as soon as they are triggered.

Modification d'un Webhook

1. Select the corresponding Edit button. The Edit page is displayed.
2. Apportez les modifications nécessaires à votre Webhook (tous les champs sont modifiables).
3. Select Update. Your changes are saved successfully and the updated Webhooks page is displayed.

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.

Important :

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 à l’utilisateur administrateur système, qui est un nom d’utilisateur général attribué aux actions effectuées par le système.

Suppression d'un Webhook

1. Select the corresponding Delete button. You are prompted to confirm.
2. Select Yes. The webhook is removed and the updated Webhooks page is displayed.