AEM as a Cloud Service:解决具有持久查询API和OAuth服务器到服务器的403缺少所需作用域错误

了解在使用OAuth服务器到服务器凭据访问AEM 持久查询API时,如何解决出现403 Forbidden missing required scopes错误的问题。

描述 description

环境

Adobe Experience Manager as a Cloud Service (AEMaaCS)(所有版本)

症状

  • 尝试使用OAuth服务器到服务器凭据访问 持久查询API 端点(如https:// .adobeaemcloud.com/graphql/execute.json/ / )时,出现以下错误 403,消息:“AEM授权失败 — 检查技术帐户的AEM组/ACL权限,路径为: {“type”:“https://api.adobeaemcloud.com/adobe/meta/errors/forbidden”,“title”:“Forbidden”,“status”:403,“detail”:“访问令牌缺少所需的范围。”}"
  • 通过API访问内容片段数据的工作方式与预期相同,但凭据相同。
  • 技术帐户(API凭据)已获得AEM中的所需权限。
  • 此问题特定于 持久查询API 请求,而不是常规API访问。

原因

出现此错误的原因是,通过OAuth服务器到服务器凭据生成的访问令牌不包含访问持久查询API所需的范围。 这可能是由于技术帐户可用范围的限制或API在Adobe Developer Console中的注册方式造成的。

解决方法 resolution

请按照以下步骤解决问题:

  1. 验证API端点和访问令牌用法:

    • 确保您正在访问正确的 持久查询API 终结点(如https://<author-instance>.adobeaemcloud.com/graphql/execute.json/<project>/<query>)。

    • 确认已为正确的技术帐户和环境生成访问令牌。

  2. 在AEM中检查技术帐户权限:

    • 确认已将技术帐户用户添加到具有所需路径访问权限的相应AEM组。

    • 确保将具有正确客户端ID的api.yaml文件部署到环境中。

  3. 在Adobe Developer Console中查看和更新范围配置:

    • 在Adobe Developer Console中,打开您的项目和API集成。

    • 检查是否已选择 持久查询API 的所有所需范围。 如果可用,请确保包含与持久查询相关的范围。

    • 如果缺少任何所需的范围,请编辑集成以添加它们、保存更改并重新下载更新的服务凭据(JSON文件)(如果适用)。

    • 使用更新的凭据重新生成访问令牌,并确保令牌请求包括所有所需的范围。

    • 使用新访问令牌重试API调用。

  4. 如果持久查询所需的范围在Adobe Developer Console中不可用:

    • 对于服务器到服务器API,使用从AEM Developer Console (而不是Adobe Developer Console)生成的JWT凭据。 这些凭据未弃用,可用于此用例。

    • 按照AEM文档生成和使用JWT凭据进行API访问。

  5. 疑难解答提示:

    • 在Developer Console中仔细检查选定的范围,并确保在Admin Console中正确链接了集成。

    • 如果错误仍然存在,请查看API调用、响应和配置步骤。

  6. 如果问题仍未解决,请参阅官方文档或与Adobe支持部门联系,了解有关您的API调用、响应和已执行配置步骤的详细信息。

相关阅读

recommendation-more-help
experience-cloud-kcs-help-kbarticles