Comment créer un webhook depuis l’application REST avec un jeton d’accès généré grâce au processus OAuth à l’aide de l’URL webhook créée à partir d’Azure AD ? | Adobe Sign

Dernière mise à jour le 27 avr. 2021

Objectif

Comment créer un webhook à partir d'une application REST avec un jeton d'accès généré par le processus OAuth en utilisant l'URL de webhook créée depuis Azure AD ?

Environnement

API REST Adobe Sign V6

Étapes

Pour créer un webhook directement à partir de l’interface utilisateur Adobe Sign, commencez par créer une URL webhook via les applications de fonction Azure AD en procédant comme suit :

Connectez-vous via le compte Microsoft https://portal.azure.com/.

Enregistre les Function Apps sous le compte AzureAD.

Accédez à AzureAD et allez à Function Apps > Cliquez sur l'icône + pour Functions.

Sélectionnez Webhook+API avec JavaScript comme langage de programmation et cliquez sur Créer une fonction.

Remplacez le fichier Index.js par le fragment de code suivant :

Cliquez sur le bouton Test dans le coin droit et fournissez l'en-tête suivant :

X-AdobeSign-ClientId as ***********************

Cliquez sur Enregistrer et Exécuter.

Une fois que vous recevez une réponse 200 OK avec l'en-tête suivant, cliquez sur Get function URL

Copiez l'URL et allez dans l'interface utilisateur Adobe Sign > Webhooks > Cliquez sur l'icône + pour créer.

Entrez les informations suivantes : 

  • Nom : Un nom intuitif que d'autres administrateurs peuvent facilement comprendre est suggéré.
  • Portée : Quelle est l'étendue du filet que capture le webhook. Le compte et le groupe sont disponibles dans l’interface.
    L’API prend en charge les portées Compte, Groupe, Utilisateur et Ressource.
  • Une seule portée par webhook peut être définie.
  • URL : L'URL cible vers laquelle Adobe Sign envoie le payload JSON.
  • Événements : Le déclencheur qui amène Adobe Sign à créer le JSON et à l'envoyer vers l'URL.
    Chaque événement génère une payload différente en rapport avec l’événement de déclenchement.
    Plusieurs événements peuvent être inclus dans un webhook.
  • Paramètres de notification : Les paramètres de notification identifient les sections du payload JSON d'événement, vous permettant de sélectionner uniquement les sections de l'événement qui sont importantes.

Une fois le webhook entièrement défini, cliquez sur Enregistrer, et le nouveau webhook commence à réagir aux événements déclencheurs immédiatement.