在 Acrobat 中为 Analyzer 配置代理访问权限

上次更新時間 2026年10月23日

当技术帐户需要为同一组织内的特定用户执行 Analyzer API 操作时,请配置 x-on-behalf-user 访问权限。

启用代替访问权限后,中央应用程序可以使用用户拥有的 Analyzer 文档和数据,而无需单独的用户身份验证令牌。

代替访问权限的功能

技术帐户可以代表经批准的用户执行以下操作:

  • 访问用户的文档。
  • 从用户的文档中检索提取的值。
  • 搜索用户的数据。
  • 为用户上传文档。
  • 提取由用户配置的属性。

访问权限仅适用于技术帐户明确批准的用户。

要求

请求代替访问权限之前:

  • 为技术帐户配置 Analyzer API 访问权限。
  • 使用技术帐户至少成功进行一次 Analyzer API 调用。
  • 确保每个用户都属于与技术帐户相同的组织。
  • 收集每个需要代替访问权限的用户的准确电子邮件地址。

如果代表请求针对的是其他组织中的用户,或所提供的电子邮件地址与用户帐户不完全匹配,Adobe 将拒绝该请求。

标识技术帐户

标识生成 OAuth 访问令牌并发出 API 请求的技术帐户。

查找其技术帐户 ID:

  1. 在 Adobe Developer Console 中打开项目。
  2. 打开用于 Analyzer 的 OAuth 服务器到服务器凭据。
  3. 打开用于生成访问令牌的页面。
  4. 找到技术帐户 ID。

技术帐户 ID 以 @techacct.adobe.com 结尾。

提交允许列表请求之前,请验证该 ID 是否属于您的集成所使用的技术帐户。

标识用户

创建需要技术帐户代表进行操作的用户列表。

对于每个用户:

  1. 收集该用户的确切 Adobe 帐户电子邮件地址。
  2. 验证该用户与技术帐户属于同一组织。

只有包含在已批准的允许列表中的用户才能通过代表请求进行访问。

请求代表访问权限

Adobe 支持为每个技术帐户管理允许列表。

组织的系统管理员必须提交包含以下内容的支持请求:

  • 以 @techacct.adobe.com 结尾的技术帐户 ID。
  • 要列入允许列表的用户电子邮件地址完整列表。
  • 组织系统管理员的批准确认。

Adobe 审阅请求并为技术帐户配置已批准的用户。

技术帐户必须至少完成一次成功的 Analyzer API 调用,Adobe 才能更新其配置。

代表用户发起 API 请求

Adobe 批准允许列表后,在应代表已批准用户运行的请求中包含 x-on-behalf-user 标头。

将标头值设置为用户已批准的电子邮件地址:

x-on-behalf-user: user@example.com

继续使用技术帐户的 OAuth 服务器到服务器 Bearer 令牌对请求进行身份验证。

请求在由 x-on-behalf-user 标头标识的用户上下文中运行。该用户必须位于技术帐户的已批准允许列表中。