コンテンツフラグメントを使用した 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 アクセスが必要な場合があります。

詳細 details-authentication

コンテンツフラグメントに対するリモート AEM GraphQL クエリの認証

環境 environments-authentication

認証は通常、次の目的で設定されます。

目的：

権限 permissions

ヘッドレス実装では、対処が必要なセキュリティおよび権限の領域がいくつかあります。権限とペルソナは、概ね、オーサー ​または​ パブリッシュ ​の AEM 環境に基づいていると考えることができます。各環境には、様々なペルソナが含まれており、ニーズも異なります。

詳細 details-permissions

ヘッドレスコンテンツの権限に関する考慮事項

環境 environments-permissions

権限は通常、次の目的で設定されます。

目的：

コンテンツ配信ネットワーク（CDN）の使用 cdn

GraphQL クエリとその JSON 応答は、CDN を使用する場合、GET リクエストとしてターゲットすればキャッシュできます。これに対し、キャッシュされていないリクエストは、（リソースが）非常に高コストで処理に時間がかかる場合があり、元のリソースにさらに悪影響を及ぼす可能性があります。

詳細 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 ヘッドレス CMS を使用すると、開発者は、既になじみのある言語、フレームワークおよびツールを使用して、優れたエクスペリエンスを自由に構築し提供できます。

詳細 details-your-apps

環境 environments-your-apps

通常、アプリは以下で開発、テスト、使用されます。

目的：

その他のリソース

AEM GraphQL とコンテンツフラグメントについて詳しくは、次を参照してください。