当技术帐户需要为同一组织内的特定用户执行 Analyzer API 操作时,请配置 x-on-behalf-user 访问权限。
启用代替访问权限后,中央应用程序可以使用用户拥有的 Analyzer 文档和数据,而无需单独的用户身份验证令牌。
代替访问权限的功能
技术帐户可以代表经批准的用户执行以下操作:
- 访问用户的文档。
- 从用户的文档中检索提取的值。
- 搜索用户的数据。
- 为用户上传文档。
- 提取由用户配置的属性。
访问权限仅适用于技术帐户明确批准的用户。
要求
请求代替访问权限之前:
- 为技术帐户配置 Analyzer API 访问权限。
- 使用技术帐户至少成功进行一次 Analyzer API 调用。
- 确保每个用户都属于与技术帐户相同的组织。
- 收集每个需要代替访问权限的用户的准确电子邮件地址。
如果代表请求针对的是其他组织中的用户,或所提供的电子邮件地址与用户帐户不完全匹配,Adobe 将拒绝该请求。
标识技术帐户
标识生成 OAuth 访问令牌并发出 API 请求的技术帐户。
查找其技术帐户 ID:
- 在 Adobe Developer Console 中打开项目。
- 打开用于 Analyzer 的 OAuth 服务器到服务器凭据。
- 打开用于生成访问令牌的页面。
- 找到技术帐户 ID。
技术帐户 ID 以 @techacct.adobe.com 结尾。
提交允许列表请求之前,请验证该 ID 是否属于您的集成所使用的技术帐户。
标识用户
创建需要技术帐户代表进行操作的用户列表。
对于每个用户:
- 收集该用户的确切 Adobe 帐户电子邮件地址。
- 验证该用户与技术帐户属于同一组织。
只有包含在已批准的允许列表中的用户才能通过代表请求进行访问。
请求代表访问权限
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 标头标识的用户上下文中运行。该用户必须位于技术帐户的已批准允许列表中。