Table of Contents

Configurer SESAR

Indiquer à SESAR où envoyer chaque dépôt, et avec quelles clés.

Réglages de SESAR

Réglage de SESAR Rôle Dans le webhook
WebHook Adresse HTTPS du webhook Voir Choisir l'adresse
WebHookKey Clé de chiffrement, en Base64 WebHookEncryptionKey du fichier de secrets
WebHookIv Vecteur d'initialisation, en Base64 WebHookEncryptionIV du fichier de secrets
WebHook_Headers En-têtes HTTP facultatifs, ajoutés à chaque requête Non lus par le webhook. Un proxy inverse peut s'en servir : voir Sécuriser le déploiement
PrivateAESKey Clé des fichiers que SESAR chiffre sur disque Requise par le connecteur SharePoint seulement

SESAR n'appelle le webhook que si WebHook, WebHookKey et WebHookIv sont tous trois renseignés. La clé et l'IV doivent être recopiés à l'identique de part et d'autre.

Choisir l'adresse

Pour Adresse
Un gestionnaire, cas recommandé https://<serveur>/api/webhook/handler/{id}
Un connecteur intégré https://<serveur>/api/webhook/{id}
Le connecteur par défaut (DefaultConnectorId) https://<serveur>/api/webhook
Le gestionnaire par défaut (Connector:generic:DefaultHandlerId) https://<serveur>/api/webhook/generic

Les routes qui appellent plusieurs connecteurs ou gestionnaires à la fois (/api/webhook/multi, /api/webhook/handler/multi) répondent toujours 200, même en cas d'échec : SESAR ne renverrait donc jamais un dépôt mal traité. Préférez une adresse par connecteur ou gestionnaire.

Ce que fait SESAR à chaque dépôt

  • Il envoie un POST en JSON, avec l'agent utilisateur SESAR, et attend la réponse 60 secondes au plus.
  • Seule une réponse 200 vaut confirmation. Toute autre réponse, ou l'absence de réponse, fait renvoyer le dépôt plus tard.
  • Il valide le certificat du webhook selon les règles de Windows : utilisez un certificat émis par une autorité à laquelle la machine de SESAR fait confiance.

Conséquences pour votre gestionnaire :

  • Terminez en moins de 60 secondes. Au-delà, SESAR considère l'envoi comme échoué et le renverra, alors que votre traitement a peut-être abouti.
  • Acceptez les doublons. Un même dépôt peut arriver plusieurs fois : identifiez-le, par exemple par son identifiant de suivi (GetTrackingId), et ne le traitez qu'une fois.
  • Distinguez les erreurs passagères des erreurs permanentes. Une erreur permanente renvoyée en échec sera renvoyée sans fin : journalisez-la et corrigez la cause.