在 AEM 中管理 GraphQL 端点 graphql-aem-endpoint

端点是 AEM 用于访问 GraphQL 的路径。您(或您的应用程序)可以使用此路径来:

  • 访问 GraphQL 架构,
  • 发送 GraphQL 查询,
  • 接收(对您 GraphQL 查询的)响应。

AEM 中有两种类型的端点:

  • 全局

    • 可供所有站点使用。
    • 此端点可以使用所有 Sites 配置的所有内容片段模型(在配置浏览器中定义)。
    • 如果有任何应该在 Sites 配置中共享的内容片段模型,则这些内容应该在全局 Sites 配置下创建。
  • Sites 配置:

    • 对应于 Sites 配置,如配置浏览器中的定义。
    • 特定于指定站点/项目。
    • Sites 配置特定的端点将来自特定 Sites 配置与来自全局 Sites 配置的内容片段模型结合使用。
CAUTION
内容片段编辑器可以允许一个 Sites 配置的内容片段引用另一个 Sites 配置(通过策略)的内容片段。
在这种情况下,并非所有内容都可以使用特定于 Sites 配置的端点进行检索。
内容作者应控制这种情境;例如,在考虑将共享内容片段模型放在全局 Sites 配置下时,它会很有用。

AEM 全局端点的 GraphQL 的存储库路径为:

/content/cq:graphql/global/endpoint

对于此项,您的应用程序可以在请求 URL 中使用以下路径:

/content/_cq_graphql/global/endpoint.json

要为 AEM 的 GraphQL 启用端点,您需要:

启用 GraphQL 端点 enabling-graphql-endpoint

要启用 GraphQL 端点,您首先需要具有合适的配置。请参阅内容片段 – 配置浏览器

CAUTION
如果未启用内容片段模型,则​ 创建 ​选项将不可用。

要启用对应的端点,请执行以下操作:

  1. 导航到​ 工具通用,然后选择 GraphQL

  2. 选择​ 创建

  3. 创建新 GraphQL 端点 ​对话框会打开。在其中可以指定:

    • 名称:端点的名称,您可以输入任意文本。
    • 使用 ​提供的 GraphQL 架构:使用下拉菜单选择所需的站点/项目。
    note note
    NOTE
    对话框中显示以下警告:
    • 如果管理不当,GraphQL 端点可能会引入数据安全和性能问题。确保在创建端点后设置适当的权限。
  4. 选择​ 创建 ​来确认。

  5. 后续步骤 ​对话框将提供直接指向安全控制台的链接,这样您可以确保新创建的端点具有合适的权限。

    note caution
    CAUTION
    端点可供所有人访问。这会带来安全问题,特别是在发布实例上,因为 GraphQL 查询会对服务器施加大量负载。
    您可在端点上设置适合您的用例的 ACL。

发布 GraphQL 端点 publishing-graphql-endpoint

选择新端点和​ 发布 ​以使其在所有环境中完全可用。

CAUTION
端点可供所有人访问。
在发布实例上,这会带来安全问题,因为 GraphQL 查询会对服务器施加大量负载。
在端点上设置适合您的用例](https://experienceleague.adobe.com/docs/experience-manager-cloud-service/headless/security/permissions.html?lang=zh-Hans)的 [ ACL。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab