使用 CSR 或其他方式在 Adobe Acrobat Sign 中设置 Webhook mTLS - 新版本

警告:

本文包含预发布信息。发布日期、功能和其他信息如有修改,恕不另行通知。

使用相互 TLS 和灵活的私钥管理确保 Webhook 传递安全。

Webhook mTLS(相互 TLS)确保 Adobe Acrobat Sign 和您的端点在 TLS 握手期间彼此验证。管理员可以选择上传自己的私钥和证书,或让 Acrobat Sign 生成并存储私钥。这种灵活性降低了处理私钥的要求,同时保持与现有 Webhook 行为的兼容性。

此功能适用于 Acrobat Sign Solutions Acrobat Sign for Government 帐户。

可以在帐户级别和组级别配置证书。

  • 组级别设置会覆盖帐户级别设置。

Webhook mTLS 的工作原理

Webhook mTLS 使用客户端证书和私钥在连接期间向您的 webhook 端点验证 Acrobat Sign 的身份。

  • Acrobat Sign 在 TLS 握手期间提供证书。
  • 您的端点在接受连接之前验证证书。
  • Webhook 负载、事件和传递行为保持不变。

选择密钥管理方法

您必须选择私钥的创建和管理方式。

上传您自己的私钥和证书

  • 在外部生成私钥和证书。
  • 以 PKCS#12 文件(.p12 或 .pfx)格式上传。
  • 您保持对密钥生成和生命周期的完全控制。

如果您的组织需要外部密钥管理,请使用此方法。

Acrobat Sign 生成私钥

  • Acrobat Sign 生成私钥和证书签名请求 (CSR)。
  • 私钥永远不会离开 Adobe 基础架构。
  • 将 CSR 提交给您的证书颁发机构。
  • 上传已签名的证书(PEM 格式)。

使用此方法可减少私钥暴露并简化密钥处理。

主要区别

功能 上传您自己的密钥 Acrobat Sign 生成密钥
私钥位置: 客户管理并存储在 Acrobat Sign 仅在 Acrobat Sign 内生成和存储
证书格式 PKCS#12 (.p12 / .pfx) PEM (.pem / .crt / .cer)
工作流程 将密钥和证书一起上传 生成 CSR,然后上传已签名的证书
密钥暴露 密钥在上传前在外部处理 密钥从不离开 Adobe 基础架构
安全态势 标准 更强

何时使用每种方法:

  • 如果您的组织需要外部密钥控制,请使用上传方法。
  • 当您希望最大限度地减少私钥处理并提高安全性时,请使用Acrobat Sign 生成的方法。

配置 webhook mTLS

选择密钥管理方法

  1. 前往安全设置 > Webhook mTLS 证书管理

  2. 选择您首选的密钥管理方法:

    • 上传客户端证书
    • 生成 CSR
  3. 保存配置。

    “安全设置”页面中突出显示了“Webhook mTLS 证书管理”选项。

如果您选择上传自己的证书:

  1. 为该证书提供一个密码。

  2. 上传证书 (.p12 或 .pfx)。
    必须包含以下两项:

    • 私钥
    • 证书
  3. 保存配置。

    选择了上传选项的 mTLS 功能。

保存后,证书立即对 webhook 传递生效。

如果您选择让 Acrobat Sign 生成私钥:

  1. 输入证书详细信息:

    • 证书名称(必填)
    • 单位
    • 部门
    • 位置
    • 州/省/直辖市/自治区
    • 国家/地区(两个字母的 ISO 代码)
    • 电子邮件(电子邮件格式)
    • SAN-DNS 名称(可选,每行输入一个)
    • SAN - 电子邮件值(可选,电子邮件格式,每行输入一个)
  2. 选择生成 CSR

  3. 复制生成的 CSR。

    选择了 Acrobat Sign 生成选项的 mTLS 功能。

  4. 将 CSR 提交给您的证书颁发机构并获取已签名的证书。

  5. 保存配置。
    只有在选择 保存 后才会保存 CSR。如果您离开页面,CSR 将丢失。

证书要求

PKCS#12(上传方法)

  • 格式:.p12 或 .pfx
  • 必须包含私钥和证书
  • 需要密码

CSR(Acrobat Sign 生成的方法)

  • 格式:PEM(.pem、.crt、.cer)
  • 必须包含 clientAuth 用法
  • 必须与生成的 CSR 匹配
  • 必须在其有效期内
  • 如有必要,请包含中间证书

需要了解的事项

  • 如果证书过期,webhook 传递将失败,直到上传有效证书。
  • Acrobat Sign 会根据 webhook 重试策略继续重试。
  • 在密钥管理方法之间切换不会删除现有证书。
  • 证书签名请求和私钥仅在选择 保存 后才会保存。离开页面会丢弃它们。
  • 支持组级别配置。
  • 仅当证书主题详细信息更改时才需要新的证书签名请求。

Adobe, Inc.

更快、更轻松地获得帮助

新用户?