Bonnes pratiques pour la configuration et l’utilisation d’AEM GraphQL avec des fragments de contenu best-practices-setup-use-aem-graphql-content-fragments

Ces instructions résument les bonnes pratiques recommandées pour installer, configurer et utiliser AEM avec GraphQL et les fragments de contenu.

Prise en main getting-started

Pour vous aider à vous mettre à jour rapidement :

Configuration setup

Pour configurer AEM GraphQL en toute sécurité afin de l’utiliser avec des fragments de contenu et vos applications, vous devez configurer divers composants.

Création d’un point d’entrée GraphQL (sécurité incluse) graphql-endpoint-creation

Le point d’entrée est le chemin utilisé pour accéder à GraphQL pour AEM. Ces points d’entrée doivent être créés et publiés afin d’être accessibles en toute sécurité.

Détails details-graphql-endpoint-creation

Gérer les points d’entrée GraphQL dans AEM

Environnements environments-graphql-endpoint-creation

Les points d’entrée doivent être configurés dans :

Pour :

Mise en cache d’AEM Dispatcher dispatcher-caching

La mise en cache des requêtes persistantes n’est pas activée par défaut dans Dispatcher. L’activation par défaut n’est pas possible, car les clients ou clientes qui utilisent le partage de ressources entre origines multiples (CORS) doivent examiner et éventuellement mettre à jour la configuration de Dispatcher.

Détails details-dispatcher-caching

Requêtes persistantes GraphQL - Activation de la mise en cache dans Dispatcher

Environnements environments-dispatcher-caching

Le Dispatcher est généralement configuré pour :

Configuration CORS cors-setup

Pour accéder au point d’entrée GraphQL, une politique CORS doit être configurée et ajoutée à un projet AEM déployé vers AEM via Cloud Manager. Vous devez pour cela ajouter un fichier de configuration CORS OSGi approprié pour le ou les points d’entrée souhaités.

Détails details-cors-setup

Configuration du partage des ressources cross-origin (CORS)

Environnements environments-cors-setup

La norme CORS est généralement configurée pour :

Authentification authentication

Un des principaux cas d’utilisation de l’API GraphQL Adobe Experience Manager as a Cloud Service (AEM) pour la diffusion de fragments de contenu consiste à accepter les requêtes distantes provenant d’applications ou de services tiers. Ces requêtes à distance peuvent nécessiter un accès authentifié à l’API afin de sécuriser la diffusion de contenu découplé.

Détails details-authentication

Authentification pour les requêtes AEM GraphQL distantes sur les fragments de contenu

Environnements environments-authentication

L’authentification est généralement configurée pour :

Pour :

Autorisations permissions

Avec une mise en œuvre sans interface, plusieurs domaines de sécurité et d’autorisations doivent être pris en compte. Les autorisations et les personnages peuvent être considérés de la même manière pour l’environnement AEM de Création ou de Publication. Chaque environnement contient des personnages différents et a des besoins différents.

Détails details-permissions

Considérations relatives aux autorisations pour le contenu découplé

Environnements environments-permissions

Les autorisations sont généralement configurées pour :

Pour :

Utiliser un réseau de diffusion de contenu (CDN) cdn

Les requêtes GraphQL et leurs réponses JSON peuvent être mises en cache si elles sont ciblées comme requêtes GET lors de l’utilisation d’un réseau CDN. En revanche, les requêtes non mises en cache peuvent être très coûteuses (en ressources) et lentes à traiter, avec des effets potentiellement néfastes supplémentaires sur les ressources de l’origine.

Détails details-cdn

Réseau CDN dans AEM as a Cloud Service

Environnements environments-cdn

Un réseau CDN est généralement configuré pour :

Configuration et création de fragments de contenu cconfigure-create-content-fragments

AEM GraphQL est utilisé pour récupérer des informations à partir de vos fragments de contenu. Ils doivent être configurés, puis une structure et un emplacement définis, avant que vous puissiez créer le contenu.

Détails details-content-fragments

Environnements eenvironments-content-fragments

Les fragments de contenu sont définis, créés, testés, publiés et accessibles sur :

Pour :

Utilisation d’AEM GraphQL use-aem-graphql

Optimisation de vos requêtes GraphQL optimize-graphql-queries

Ces instructions sont fournies pour vous aider à éviter les problèmes de performances liés à vos requêtes GraphQL.

Détails details-optimize-graphql-queries

Optimisation des requêtes GraphQL

Accès à GraphQL à partir de vos applications access-graphql-from-your-apps

AEM Headless CMS offre aux développeurs la liberté de créer et de diffuser des expériences exceptionnelles à l’aide des langages, des frameworks et des outils qu’ils connaissent déjà.

Détails details-your-apps

Environnements environments-your-apps

Les applications sont généralement développées, testées et utilisées sur :

Pour :

Ressources supplémentaires

Pour plus d’informations sur le GraphQL AEM et les fragments de contenu, voir :