Wie werden Webhooks von der REST-Anwendung mit Zugriffstoken erstellt, die über den OAuth-Prozess mithilfe der Webhook-URL von Azure AD generiert wurden? | Adobe Sign

Zuletzt aktualisiert am 27. April 2021

Ziel

Wie erstellt man einen Webhook von einer REST-Anwendung mit einem Zugriffstoken, das vom OAuth-Prozess generiert wurde, unter Verwendung einer Webhook-URL, die von Azure AD erstellt wurde?

Umgebung

Adobe Sign REST API V6

Schritte

Um Webhooks direkt von der Adobe Sign-Benutzeroberfläche aus zu erstellen, erstelle zunächst eine Webhook-URL über Funktionen-Apps von Azure AD, indem du die folgenden Schritte ausführst:

Melde dich über dein Microsoft-Konto bei https://portal.azure.com/ an.

Registriere Function Apps unter dem AzureAD-Konto.

Gehe zu AzureAD und gehe zu Function Apps > Klicke auf das + Symbol für Functions.

Wähle Webhook+API mit JavaScript als Sprache aus und klicke auf Function erstellen.

Ersetze die Index.js-Datei durch folgenden Code:

Klicke auf den Test Button in der rechten Ecke und gib den folgenden Header ein:

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

Klicke auf Speichern und Ausführen.

Sobald du eine 200 OK Antwort mit dem folgenden Header erhältst, klicke auf Function-URL abrufen

Kopiere die URL und gehe zur Adobe Sign Benutzeroberfläche > Webhooks > Klicke auf das + Symbol zum Erstellen.

Gib folgende Informationen ein: 

  • Name: Ein intuitiver Name, den andere Administratoren leicht verstehen können, wird empfohlen.
  • Umfang: Wie weit das Netz des Webhooks reicht.Konto und Gruppe sind auf der Oberfläche verfügbar.
    Die API unterstützt die Bereiche „Konto“, „Gruppe“, „Benutzer“ und „Ressourcen“.
  • Pro Webhook kann nur ein Bereich definiert werden.
  • URL: Die Ziel-URL, an die Adobe Sign die JSON-Nutzlast sendet.
  • Events: Der Auslöser, der Adobe Sign dazu veranlasst, das JSON zu erstellen und an die URL zu senden.
    Jedes Ereignis erstellt eine andere Payload, die für das Auslöserereignis relevant ist
    In einem Webhook können mehrere Ereignisse enthalten sein.
  • Benachrichtigungsparameter: Die Benachrichtigungsparameter identifizieren die Abschnitte der Event-JSON-Nutzlast und ermöglichen es dir, nur die Abschnitte des Events auszuwählen, die wichtig sind.

Sobald der Webhook vollständig definiert ist, klicke auf Speichern, und der neue Webhook reagiert sofort auf Auslöserereignisse.