如何使用從 Azure AD 建立的 Webhook URL,使用 OAuth 程序產生的存取權杖從 REST 應用程式建立 Webhook? | Adobe Sign

上次更新時間 2021年4月27日

目標

如何使用從 Azure AD 建立的 webhook URL,透過 OAuth 程序產生的存取權杖,從 REST 應用程式建立 webhook?

環境

Adobe Sign REST API V6

步驟

若要直接從 Adobe Sign UI 建立 Webhook,請先使用以下步驟透過 Azure AD 函數應用程式建立 Webhook URL:

透過 Microsoft 帳戶 https://portal.azure.com/ 登入。

AzureAD 帳戶下註冊 Function Apps

前往 AzureAD 並前往 Function Apps > 按一下 + 圖示 以建立函數。

選取 Webhook+API,語言選擇 JavaScript,然後按一下 建立函數

以下列程式碼片段取代 Index.js 檔案:

按一下右上角的 測試 按鈕並提供以下標頭:

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

按一下 儲存 執行

收到 200 OK 回應與以下標頭後,按一下 取得函數 URL

複製 URL 並前往 Adobe Sign UI > Webhooks > 按一下 + 圖示進行建立。

輸入下列資訊: 

  • 名稱:建議使用其他管理員可以輕鬆理解的直覺名稱。
  • 範圍:webhook 捕捉的涵蓋範圍有多廣。介面中有「帳戶」與「群組」。
    API 支援「帳戶」、「群組」、「使用者」與「資源」範圍。
  • 只能為每個 Webhook 定義一個範圍
  • URL:Adobe Sign 推送 JSON 承載的目標 URL。
  • Events:造成 Adobe Sign 建置 JSON 並將其推播至 URL 的觸發程序。
    每個事件都會建立與觸發事件相關的不同裝載
    一個 Webhook 可包含多個事件。
  • 通知參數:通知參數識別事件 JSON 承載的部分,讓您能夠僅選取重要的事件部分。

在完整設定 webhook 之後,按一下儲存,新的 webhook 便會立即開始對觸發事件做出反應。