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

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.
ATTENTION

L’éditeur de fragment de contenu peut permettre à un fragment de contenu d’une configuration Sites de référencer un fragment de contenu d’une autre configuration Sites (à l’aide de stratégies).

Dans ce cas, tout le contenu ne peut pas être récupéré à l’aide d’un point d’entrée spécifique à la configuration Sites.

L’auteur du contenu doit contrôler ce scénario ; par exemple, il peut être utile de placer des modèles de fragment de contenu partagés sous la configuration de sites globaux.

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

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.

ATTENTION

Si l’utilisation des modèles de contenu du fragment n’a pas été activée, l’option Créer n’est pas disponible.

Pour activer le point d’entrée correspondant :

  1. Accédez à Outils, Général, puis sélectionnez GraphQL.

  2. Sélectionnez Créer.

  3. 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.
    REMARQUE

    L’avertissement suivant s’affiche dans la boîte de dialogue :

    • Les points d’entrée GraphQL peuvent présenter des problèmes de sécurité et de performance des données s’ils ne sont pas gérés de manière adaptée. Veillez à définir les autorisations appropriées après la création d’un point d’entrée.

  4. Confirmez avec Créer.

  5. 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.

    ATTENTION

    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

Sélectionnez le nouveau point d’entrée et Publier pour le rendre entièrement disponible dans tous les environnements.

ATTENTION

Le point d’entrée est accessible à tous.

Cela peut entraîner un problème de sécurité sur les instances de publication, car les requêtes GraphQL peuvent imposer une charge importante au serveur.

Vous devez configurer des listes de contrôle d’accès pour le point d’entrée en fonction de votre cas d’utilisation

Sur cette page