Acrobat Sign Webhook 概述

如上所述，签名的每个通知请求中包括标头 'X-AdobeSign-ClientId'，此标头的值（客户端 ID）应通过以下两种方式之一在响应中回显：

1. HTTP 标头 X-AdobeSign-ClientId 且值为此客户端 ID

2. JSON 响应正文，键为 xAdobeSignClientId，值为相同的客户端 ID

先决条件

您将需要：

1. 具有许可证的 Microsoft 帐户，用于创建 Azure Function 应用程序
2. 现有 Azure Functions 应用程序，您可以使用 https://docs.microsoft.com/zh-cn/azure/azure-functions/functions-create-first-azure-function 创建一个
3. Javascript 基本知识，以便您理解代码，并使用自选的任何语言编写代码

创建 Azure Functions 触发器（用作 Acrobat Sign Webhook）的步骤

要创建 Javascript HTTP 触发器函数，请执行以下操作：

1. 通过您的 Microsoft 帐户登录 https://portal.azure.com/

2. 打开显示在“函数应用”选项卡下方的 Azure Functions 应用程序。

这将打开 Azure Functions 应用程序列表：

3. 选择您想要在其中创建此新函数的应用程序

4. 单击“创建”(+) 按钮以创建新 Azure 函数

5. 选择 Webhook + API 作为场景，选择 Javascript 作为语言

6. 单击创建此函数

将创建具有处理传入 API 请求功能的新函数。

添加逻辑以注册 Acrobat Sign Webhook

在成功注册 Webhook 之前，Acrobat Sign 会验证注册请求中提供的 Webhook URL 是否真正旨在接收通知。出于此目的，当通过 Acrobat Sign 接收新 Webhook 注册请求时，它将首先向 Webhook URL 发出验证请求。此验证请求是发送至 Webhook URL 的 HTTPS GET 请求（具有自定义 HTTP 标头 X-AdobeSign-ClientId）。此标头中的值将设置为请求创建/注册 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'];

    //验证传入客户端 ID 是否属实

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

        context.res = {

            // 状态：200，/* 默认为 200 */ // 可接受任何 2XX 响应

            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'];

    //验证传入客户端 ID 是否属实

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

        context.res = {

            // 状态：200，/* 默认为 200 */ // 可接受任何 2XX 响应

            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 通知时，clientID 预期出现相同行为。 

准备使用

当您验证行为后，Webhook URL 将按照 Acrobat Sign 标准工作。您可以根据您的需求进一步更新自定义逻辑。

获取函数 URL

• 单击获取函数 URL

复制 URL 并将其用于在 Acrobat Sign 中创建 webhook。

创建 AWS Lambda 函数

要创建 AWS Lambda，请登录您的 AWS 管理控制台，然后从服务列表中选择 AWS Lambda 服务。

• 单击使用“从头开始创作”创建 Lambda 函数选项
• 在“配置函数”页面中，输入函数名称 "lambdaWebhooks"，然后选择 Node.js 4.3 作为运行时
  
• 对于角色，请选择一个现有角色或从模板创建一个新角色。
  • 如果您选择了从模板创建新角色，请输入角色名称（例如，role-lamda），然后从策略模板列表中选择简单微服务权限。
• 单击创建函数按钮

• 在新 AWS lamda 函数页面上，选择编辑代码内联作为代码输入类型，继续将 index.handler 用作处理程序。
• 添加逻辑以注册 Acrobat Sign Webhook

  在成功注册 Webhook 之前，Acrobat Sign 会验证注册请求中提供的 Webhook URL 是否真正旨在接收通知。出于此目的，当通过 Acrobat Sign 接收新 Webhook 注册请求时，它将首先向 Webhook URL 发出验证请求。此验证请求是发送至 Webhook URL 的 HTTPS GET 请求（具有自定义 HTTP 标头 X-AdobeSign-ClientId）。此标头中的值将设置为请求创建/注册 Webhook 的应用程序的客户端 ID。为成功注册 Webhook，Webhook URL 必须通过 2XX 响应代码响应此验证请求，而且，它还必须通过以下两种方式之一发回相同的客户端 ID 值。 Also note the same behavior for clientID is expected when the Webhook URL receives POST notifications. 

  遵循以下两种情况之一：

  情况 1：在作为响应标头的 X-AdobeSign-ClientId 中传递客户端 ID

  •  在响应标头中传递 X-AdobeSign-ClientId。它是在请求中传递的同一标头，并且必须在响应中回显。
    
    代码片段
    在 index.js 文件中，将自动生成的代码片段替换为以下代码：

情况 2：使用键 xAdobeSignClientId 在响应正文中传递客户端 ID

在 JSON 响应正文中，键为 xAdobeSignClientId，且其值为在请求标头中发送的同一客户端 ID。

代码片段

将 Index.js 文件替换为以下项：

• 保存函数。Lambda 函数已创建，我们几乎已准备就绪，可在实时 Webhook 中进行使用。

配置 AWS API 网关

为了使此 Lambda 可通过 HTTP 方法公开访问，我们需要使用我们的函数（上面已创建）作为 API 后端来配置 AWS API 网关。

在 AWS 管理控制台中，从 AWS 服务选择 API 网关，然后单击创建 API 按钮

• 在创建新 API 页面中，选择新 API，然后输入 webhooks 作为 API 名称。
• 单击创建 API 按钮
• 选择操作下拉列表，然后选择创建资源选项
• 单击配置为代理资源选项，然后在资源名称中输入验证，在资源路径中输入 {proxy+}
• 将启用 API 网关 CORS 选项保持为取消选中，然后单击创建资源按钮
• 将 Lambda 函数代理保持选择为集成类型，且在 Lambda 区域下拉列表中选择您已在其中创建 Lambda 函数的区域（可能与您正在创建 API 网关的区域相同）。
• 在 Lambda 函数中输入验证，然后单击保存按钮
• 在为 Lambda 函数添加权限弹出窗口中，单击确定

如果上述所有步骤均执行成功，您将看到如下显示：

部署 API

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

• 在操作下拉列表中，选择部署 API
• 在部署阶段中选择[新阶段]，然后在阶段名称中输入生产（或您想要识别此阶段的任何内容）
• 单击部署按钮

API 现在可供使用，且您可以在蓝框中找到调用 URL，如下所示：

记下此 URL，因为您后续要输入它作为实时 Webhook URL。

准备使用

完成。 Use this above url with "/{nodeJSfunctionName}" appended as webhook url in POST /webhooks API request.  当您验证行为后，Webhook URL 将按照 Acrobat Sign 标准工作。
您可以根据您的需求进一步更新/添加自定义逻辑。