DocumentaciónAide

Renouveler ou désactiver le webhook

Générez une nouvelle URL et un nouveau secret si le secret a été perdu ou exposé, ou désactivez le webhook pour ne plus recevoir d'événements.

Sur cette page

Renouveler le webhook remplace son URL et son secret par de nouveaux : les anciens cessent immédiatement de fonctionner. Le désactiver fait que l'URL n'accepte plus d'événements, sans supprimer l'intégration ni ses événements.

Avant de commencer

  • Vous devez avoir le rôle Administrateur. Avec un autre rôle, ces boutons n'apparaissent pas sur la carte.

  • Coordonnez-vous avec l'administrateur du système externe : après le renouvellement, il devra le configurer avec les nouvelles données.

Renouveler le webhook

Faites-le si vous avez perdu le secret, si vous pensez que quelqu'un d'autre le connaît ou dans le cadre de votre renouvellement périodique des clés.

  1. Ouvrez Paramètres → Intégrations.

  2. Sur la carte de l'intégration, cliquez sur Renouveler.

  3. Confirmez dans Renouveler le webhook de « … » ? avec Oui, renouveler. L'avis rappelle que le système externe ne pourra plus envoyer d'événements tant que vous ne l'aurez pas configuré avec les nouvelles données.

  4. La fenêtre Webhook activé s'ouvre avec la nouvelle URL et le nouveau secret. Copiez-les et configurez votre système, comme dans Activer le webhook et envoyer des événements.

  5. Cliquez sur Je l'ai copié, fermer puis, dans Avez-vous copié le secret ?, confirmez avec Oui, fermer.

Entre le renouvellement et la reconfiguration du système externe, ses événements sont rejetés et ne sont pas enregistrés. Préparez la modification dans l'autre système avant de renouveler.

Désactiver le webhook

Faites-le lorsque vous n'utilisez plus le système ou que vous voulez couper immédiatement l'envoi d'événements.

  1. Sur la carte de l'intégration, cliquez sur le bouton Désactiver le webhook (à côté de Renouveler).

  2. Confirmez dans Désactiver le webhook de « … » ? avec Oui, désactiver. L'avis rappelle que vous pourrez le réactiver plus tard, avec un nouveau secret.

Le message Webhook désactivé. s'affiche et le champ Webhook de la carte indique Désactivé.

Le réactiver

Cliquez sur Webhook sur la carte. Une nouvelle URL et un nouveau secret sont générés immédiatement et la fenêtre Webhook activé s'ouvre : l'ancienne URL et l'ancien secret ne sont pas récupérables.

Si vous voulez seulement cesser de recevoir des événements pendant un temps en conservant la même URL et le même secret, modifiez l'intégration et passez son État à En pause. Voir Modifier, mettre en pause ou supprimer une intégration.

Ensuite

Les événements déjà reçus sont conservés dans Événements reçus. Tant que le webhook est désactivé, les envois du système externe sont rejetés.

Voir aussi

Rechercher dans SofIA Gouvernance

Saisissez au moins 2 caractères pour rechercher dans SofIA Gouvernance.

↑↓ naviguer · Enter ouvrir · Esc fermer