搭配內容片段設定及使用AEM GraphQL的最佳做法 best-practices-setup-use-aem-graphql-content-fragments

這些指引總結了搭配GraphQL和內容片段設定、設定和使用AEM的建議最佳作法。

快速入門 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和內容片段的詳細資訊，請參閱下列內容：