设置和将AEM GraphQL与内容片段一起使用的最佳实践 best-practices-setup-use-aem-graphql-content-fragments

这些准则汇总了将AEM与GraphQL和内容片段设置、配置和使用的推荐最佳实践。

快速入门 getting-started

为了帮助您快速掌握：

设置 setup

要安全设置AEM GraphQL以与内容片段和您的应用程序一起使用，您需要配置各种组件。

GraphQL端点创建（包括安全性） graphql-endpoint-creation

端点是 AEM 用于访问 GraphQL 的路径。需要创建和发布这些端点，以便可以安全地访问它们。

详细信息 details-graphql-endpoint-creation

在 AEM 中管理 GraphQL 端点

环境 environments-graphql-endpoint-creation

端点需要配置于：

对于：

AEM Dispatcher缓存 dispatcher-caching

默认情况下，Dispatcher 中未启用持久化查询的缓存。无法实施默认启用，因为对多个源使用 CORS（跨源资源共享）的客户需要检查并（可能需要）更新其 Dispatcher 配置。

详细信息 details-dispatcher-caching

GraphQL 持久化查询 - 在 Dispatcher 中启用缓存

环境 environments-dispatcher-caching

Dispatcher通常配置为执行以下操作：

CORS设置 cors-setup

要访问GraphQL端点，必须配置CORS策略并添加到通过Cloud Manager部署到AEM的AEM项目。 此操作可通过为所需端点添加相应的OSGi CORS配置文件来完成。

详细信息 details-cors-setup

跨源资源共享 (CORS) 配置

环境 environments-cors-setup

CORS通常配置为用于：

身份验证 authentication

用于内容片段投放的Adobe Experience Manager as a Cloud Service (AEM) GraphQL API的主要用例是接受来自第三方应用程序或服务的远程查询。 这些远程查询可能需要经过身份验证的 API 访问，以保护 Headless 内容投放。

详细信息 details-authentication

对内容片段的远程 AEM GraphQL 查询的身份验证

环境 environments-authentication

身份验证通常配置为执行以下操作：

对于：

权限 permissions

使用 Headless 实施，需要解决多个不同的安全和权限领域。根据 AEM 环境​ 创作 ​或​ 发布，可以广泛地考虑权限和角色。每个环境包含不同的角色并有不同的需求。

详细信息 details-permissions

Headless 内容的权限注意事项

环境 environments-permissions

权限通常配置为用于：

对于：

使用内容交付网络(CDN) cdn

使用CDN时，如果定位为GET请求，则可以缓存GraphQL查询及其JSON响应。 相比之下，未缓存的请求可能非常（资源）昂贵且处理缓慢，有可能对源头资源造成进一步的有害影响。

详细信息 details-cdn

AEM as a Cloud Service 中的 CDN

环境 environments-cdn

CDN通常配置为执行以下操作：

配置和创建内容片段 cconfigure-create-content-fragments

AEM GraphQL用于从您的内容片段中检索信息。 需要配置这些内容，然后定义结构和位置，然后才能创建内容。

详细信息 details-content-fragments

环境 eenvironments-content-fragments

在以下位置定义、创作、测试、发布和访问内容片段：

对于：

使用AEM GraphQL use-aem-graphql

优化GraphQL查询 optimize-graphql-queries

提供这些准则是为了帮助防止GraphQL查询出现性能问题。

详细信息 details-optimize-graphql-queries

优化 GraphQL 查询

从您的应用程序访问GraphQL access-graphql-from-your-apps

AEM Headless CMS使开发人员能够自由地使用他们已熟悉的语言、框架和工具构建和提供卓越的体验。

详细信息 details-your-apps

环境 environments-your-apps

应用程序通常在以下环境中开发、测试和使用：

对于：

其他资源

有关AEM GraphQL和内容片段的更多详细信息，请参阅以下内容：