Gérer les points d’entrée GraphQL dans AEM graphql-aem-endpoint
Le point d’entrée est le chemin utilisé pour accéder à GraphQL pour AEM. Avec ce chemin, vous (ou votre application) pouvez :
- accéder au schéma GraphQL ;
- envoyer vos requêtes GraphQL ;
- recevoir les réponses (à vos requêtes GraphQL).
Dans AEM, il existe deux types de points d’entrée :
-
Global
- Disponible pour tous les sites.
- Ce point d’entrée peut utiliser tous les modèles de fragment de contenu de toutes les configurations Sites (définis dans l’explorateur de configurations).
- S’il existe des modèles de fragment de contenu à partager entre les configurations Sites, ils doivent être créés sous les configurations Sites globales.
-
Configurations Sites :
- Correspond à une configuration Sites, comme défini dans l’explorateur de configurations.
- Spécifique à un site/projet spécifique.
- Un point d’entrée spécifique à la configuration Sites utilisera les modèles de fragment de contenu de cette configuration Sites spécifique, ainsi que ceux de la configuration Sites globale.
Le chemin d’accès au référentiel du point d’entrée global GraphQL pour AEM est :
/content/cq:graphql/global/endpoint
Pour lequel votre application peut utiliser le chemin d’accès suivant dans l’URL de la requête :
/content/_cq_graphql/global/endpoint.json
Pour activer le point d’entrée de GraphQL pour AEM, vous devez procéder comme suit :
Activation de votre point d’entrée GraphQL enabling-graphql-endpoint
Pour activer un point d’entrée GraphQL, vous devez d’abord disposer d’une configuration appropriée. Voir Fragments de contenu – Explorateur de configurations.
Pour activer le point d’entrée correspondant :
-
Accédez à Outils, Ressources, puis sélectionnez GraphQL.
-
Sélectionnez Créer.
-
La boîte de dialogue Créer un point d’entrée GraphQL s’ouvre. Vous pouvez spécifier ici les éléments suivants :
- Nom : nom du point d’entrée ; vous pouvez saisir du texte.
- Utiliser le schéma GraphQL fourni par : utilisez la liste déroulante pour sélectionner le site/projet requis.
note note NOTE L’avertissement suivant s’affiche dans la boîte de dialogue : - Les points d’entrée GraphQL peuvent introduire des problèmes de sécurité et de performances des données s’ils ne sont pas gérés avec précaution. Veillez à définir les autorisations appropriées après la création d’un point d’entrée.
-
Confirmez avec Créer.
-
La boîte de dialogue Étapes suivantes fournit un lien direct vers la console de sécurité afin que vous puissiez vous assurer que le nouveau point d’entrée dispose des autorisations appropriées.
note caution CAUTION Le point d’entrée est accessible à tous. Cela peut entraîner un problème de sécurité, en particulier pour les instances de publication, car les requêtes GraphQL peuvent imposer une charge importante au serveur. Vous pouvez configurer des listes de contrôle d’accès pour le point d’entrée en fonction de votre cas d’utilisation.
Publication de votre point d’entrée GraphQL publishing-graphql-endpoint
Sélectionnez le nouveau point d’entrée et Publier pour le rendre entièrement disponible dans tous les environnements.