在 AEM 中管理 GraphQL 端点 graphql-aem-endpoint
端点是 AEM 用于访问 GraphQL 的路径。您(或您的应用程序)可以使用此路径来:
- 访问 GraphQL 架构,
- 发送 GraphQL 查询,
- 接收(对您 GraphQL 查询的)响应。
AEM 中有两种类型的端点:
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
如果未启用内容片段模型,则 创建 选项将不可用。
要启用对应的端点,请执行以下操作:
-
导航到 工具、通用,然后选择 GraphQL。
-
选择 创建。
-
创建新 GraphQL 端点 对话框会打开。在其中可以指定:
- 名称:端点的名称,您可以输入任意文本。
- 使用 提供的 GraphQL 架构:使用下拉菜单选择所需的站点/项目。
note note NOTE 对话框中显示以下警告: - 如果管理不当,GraphQL 端点可能会引入数据安全和性能问题。确保在创建端点后设置适当的权限。
-
选择 创建 来确认。
-
后续步骤 对话框将提供直接指向安全控制台的链接,这样您可以确保新创建的端点具有合适的权限。
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