Acrobat Sign Webhook 概觀

如上所述，在 Sign 的每個通知請求中都包含標頭「X-AdobeSign-ClientId」，而此標頭的值 (用戶端 ID) 應以如下兩種方式的其中一種，於回應中傳回：

1. HTTP 標頭 X-AdobeSign-ClientId 和作為此用戶端 ID 的值

2. 具有金鑰為 xAdobeSignClientId，且值為同一用戶端 ID 的 JSON 回應內文

必要條件

您需要：

1. 獲授權可建立 Azure 函式應用程式的 Microsoft 帳戶
2. 既有的 Azure 函式應用程式，您可以使用 https://docs.microsoft.com/zh-tw/azure/azure-functions/functions-create-first-azure-function 來建立
3. Javascript 的基本知識，以便能以您選擇的任何語言理解並編寫程式碼

建立做為 Acrobat Sign Webhook 的 Azure 函式觸發程式的步驟

建立 Javascript HTTP 觸發函式：

1. 用您的 Microsoft 帳戶登入 https://portal.azure.com/

2. 開啟在「函式應用程式」標籤下顯示的 Azure 函式應用程式。

這會開啟 Azure 函式應用程式清單：

3. 選擇要在其中建立新函式的應用程式

4. 按一下「建立 (+)」按鈕以建立新的 Azure 函式

5. 選取 Webhook + API 作為情境，選取 Javascript 作為語言

6. 按一下「建立此函式」

如此即建立有能力處理傳入 API 請求的新函式。

新增邏輯以註冊 Acrobat Sign Webhook

在成功註冊 Webhook 之前，Acrobat Sign 會驗證註冊請求中提供的 Webhook URL 是否確實有意接收通知。為此，當 Acrobat Sign 接收到新的 Webhook 註冊請求時，首先會對 Webhook URL 發出驗證請求。此驗證請求是使用自訂 HTTP 標頭 X-AdobeSign-ClientId 發送到 Webhook URL 的 HTTPS GET 請求。此標頭中的值，應設定為請求建立/註冊 Webhook 的應用程式之用戶端 ID。為了成功註冊 Webhook，Webhook URL 必須以 2XX 回應代碼回應此驗證請求，「而且」還必須以下列兩種方法的其中一種傳回相同的用戶端 ID 值：

您有兩種選項可遵循：

選項 1：在 X-AdobeSign-ClientId 中傳遞用戶端 ID 作為回應標頭

在回應標頭中傳遞 X-AdobeSign-ClientId。這就是於請求中傳遞，且必須在回應中傳回的同一個標頭。

以下列程式碼取代 Index.js 檔案：

module.exports = function (context, req) {

    var clientId = req.headers['x-adobesign-clientid'];

    // Validate that the incoming ClientID is genuine

    if (clientId === '123XXX456') {

        context.res = {

            // status: 200, /* Defaults to 200 */ // any 2XX response is acceptable

            body: "Notification Accepted",

            headers : {

                'x-adobesign-clientid' : req.headers['x-adobesign-clientid']

            }

        };

    }

    else {

        context.res = {

            status: 400,

            body: "Opps!! Illegitimate Call identified"

        };

    }

    context.done();

};

透過模擬請求來測試行為：

1. 按一下右上角的「測試」按鈕

2. 模擬假請求

雖然上面未顯示回應標頭，但您可透過 postman/DHC 或任何其他服務，對其進行模擬以觀察。

選項 2：使用 xAdobeSignClientId 金鑰在回應內文中傳遞用戶端 ID

在 JSON 回應內文中，其中含有 xAdobeSignClientId 金鑰，且其值與在請求標頭中傳送的用戶端 ID 相同。

以下列程式碼取代 Index.js 檔案：

module.exports = function (context, req) {

    var clientId = req.headers['x-adobesign-clientid'];

    // Validate that the incoming ClientID is genuine

    if (clientId === '123XXX456') {

        context.res = {

            // status: 200, /* Defaults to 200 */ // any 2XX response is acceptable

            body: {

                'xAdobeSignClientId' : clientId

            },

            headers : {

                'Content-Type' : 'application/json'

            }

        };

    }

    else {

        context.res = {

            status: 400,

            body: "Opps!! Illegitimate Call identified"

        };

    }

    context.done();

};

透過模擬請求來測試行為

1. 按一下右上角的「測試」按鈕

2. 模擬假請求

另請注意，當 Webhook URL 接收 POST 通知時，用戶端 ID 的行為應相同。 

準備使用

驗證過該行為後，Webhook URL 將按照 Acrobat Sign 標準運作。您可以根據您的需求，進一步更新自訂邏輯。

取得函式 URL

• 按一下「取得函式 URL」

複製 URL，並使用它在 Acrobat Sign 中建立 Webhook。

建立 AWS Lambda 函式

如要建立 AWS Lambda 函式，請登入 AWS 管理主控台，並從服務清單中選取 AWS Lambda 服務。

• 按一下「使用「從頭編寫」」建立 Lambda 函式」選項
• 在「設定函式」頁面中，輸入函式名稱「lambdaWebhook」，並選取 Node.js 4.3 作為執行階段
  
• 將「角色」選為現有角色，或從範本建立新角色
  • 如果您選擇「從範本建立新角色」，請輸入角色名稱 (例如 role-lamda)，並從「原則範本」清單選取「簡單微服務權限」
• 按一下「建立函式」按鈕

• 在新的 AWS lamda 函式頁面上，選取「以內嵌方式編輯程式碼」作為「程式碼輸入類型」，將 index.handler 保留為「處理常式」。
• 新增邏輯以註冊 Acrobat Sign Webhook

  在成功註冊 Webhook 之前，Acrobat Sign 會驗證註冊請求中提供的 Webhook URL 是否確實有意接收通知。為此，當 Acrobat Sign 接收到新的 Webhook 註冊請求時，首先會對 Webhook URL 發出驗證請求。此驗證請求是使用自訂 HTTP 標頭 X-AdobeSign-ClientId 發送到 Webhook URL 的 HTTPS GET 請求。此標頭中的值，應設定為請求建立/註冊 Webhook 的應用程式之用戶端 ID。為了成功註冊 Webhook，Webhook URL 必須以 2XX 回應代碼回應此驗證請求，「而且」還必須以下列兩種方法的其中一種傳回相同的用戶端 ID 值： 另請注意，當Webhook URL接收POST通知時，客戶端ID的行為應相同。 

  按以下兩種情況的其中一種操作：

  情況 1：在 X-AdobeSign-ClientId 中傳遞用戶端 ID 作為回應標頭

  •  在回應標頭中傳遞 X-AdobeSign-ClientId。這就是於請求中傳遞，且必須在回應中傳回的同一個標頭。
    
    程式碼片段
    在 index.js 檔案中，將自動生成的程式碼片段替換為以下程式碼：

情況 2：使用 xAdobeSignClientId 金鑰，在回應內文中傳遞用戶端 ID

在 JSON 回應內文中，其中含有 xAdobeSignClientId 金鑰，且其值與在請求標頭中傳送的用戶端 ID 相同。

程式碼片段

以下列程式碼取代 Index.js 檔案：

• 儲存函式。Lambda 函式已建立，我們即將準備好將其用於即時 Webhook。

設定 AWS API 閘道

如要讓此 Lambda 可透過 HTTP 方法公開存取，我們需要使用我們建立其上的函式設定 AWS API 閘道，作為 API 的後端。

在 AWS 管理主控台中，從「AWS 服務」選取「API 閘道」，然後按一下「建立 API」按鈕

• 在「建立新 API」頁面選取「新 API」，並輸入「Webhook」作為「API 名稱」。
• 按一下「建立 API」按鈕
• 選取「動作」下拉式清單，然後選取「建立資源」選項
• 勾選「設定為代理資源」項目，然後輸入 validate 作為「資源名稱」，並在「資源路徑」輸入 {proxy+}
• 讓「啟用 API 閘道 CORS」選項保持未勾選狀態，然後按一下「建立資源」按鈕
• 保持選取「Lambda 函式代理」作為「整合類型」，並在「Lambda 區域」下拉式清單中選取您建立 Lambda 函式的區域 (可能是您建立 API 閘道的同一區域)。
• 輸入 validate 作為 Lambda 函式，然後按一下「儲存」按鈕
• 在「為 Lambda 函式新增權限」快顯視窗中選取「確定」

如果成功執行了上述所有步驟，您將看到以下內容：

部署 API

下一步驟是部署此 API，使其可以使用。

• 在「動作」下拉式清單選取「部署 API」
• 於「部署階段」選取「[新階段]」，然後將 prod (或任何您想用來識別此階段的文字) 輸入至「階段名稱」
• 按一下「部署」按鈕

API 現在已可使用，您可在藍色方塊中找到叫用 URL，如下所示：

請記下此 URL，因為您需要將其輸入為即時 Webhook URL。

準備使用

完成了！ 將上述URL與「/{nodeJSfunctionName}」一起作為webhook API請求POST中的webhook URL附加。  驗證過該行為後，Webhook URL 將按照
Acrobat Sign 標準運作。您可以根據需求進一步更新/新增自訂邏輯。