GraphQL-eindpunten beheren in AEM graphql-aem-endpoint

Het eindpunt is het pad dat wordt gebruikt om toegang te krijgen tot GraphQL voor AEM. Met dit pad kunt u (of uw app) het volgende doen:

  • toegang tot het GraphQL-schema;
  • je GraphQL query's sturen,
  • de antwoorden ontvangen (op je GraphQL-vragen).

Er zijn twee soorten eindpunten in AEM:

  • Algemeen

    • Beschikbaar voor gebruik door alle sites.
    • Dit eindpunt kan alle Modellen van het Fragment van de Inhoud van alle configuraties van Plaatsen gebruiken (die in Configuratiebrowser).
    • Als er om het even welke Modellen van het Fragment van de Inhoud zijn die onder de configuraties van Plaatsen zouden moeten worden gedeeld, dan zouden deze onder de globale configuraties van Plaatsen moeten worden gecreeerd.
  • Siteconfiguraties:

    • Komt overeen met een configuratie Sites, zoals gedefinieerd in het dialoogvenster Configuratiebrowser.
    • Specifiek voor een opgegeven site/project.
    • Een configuratie-specifiek eindpunt van Plaatsen zal de Modellen van het Fragment van de Inhoud van die specifieke configuratie van Plaatsen samen met die van de globale configuratie van Plaatsen gebruiken.
CAUTION
Met de Inhoudsfragmenteditor kan een inhoudsfragment van een siteconfiguratie verwijzen naar een inhoudsfragment van een andere siteconfiguratie (via beleid).
In zulk een geval, is niet alle inhoud terugwinnbaar gebruikend een de configuratie van Plaatsen specifiek eindpunt.
De inhoudauteur zou dit scenario moeten controleren; bijvoorbeeld, kan het nuttig zijn om het plaatsen van gedeelde Modellen van het Fragment van de Inhoud onder de Globale configuratie van Plaatsen te overwegen.

Het pad naar de gegevensopslagruimte van de GraphQL voor AEM globale eindpunt is:

/content/cq:graphql/global/endpoint

Voor welke toepassing uw toepassing het volgende pad in de aanvraag-URL kan gebruiken:

/content/_cq_graphql/global/endpoint.json

Om een eindpunt voor GraphQL voor AEM toe te laten moet u:

GraphQL Endpoint inschakelen enabling-graphql-endpoint

Om een Eindpunt van GraphQL toe te laten moet u eerst een aangewezen configuratie hebben. Zie Inhoudsfragmenten - Configuratiebrowser.

CAUTION
Als de gebruik van inhoudsfragmentmodellen is niet ingeschakeldde Maken deze optie is niet beschikbaar.

Om het overeenkomstige eindpunt toe te laten:

  1. Navigeren naar Gereedschappen, Algemeen selecteert u vervolgens GraphQL.

  2. Selecteren Maken.

  3. De Nieuw GraphQL-eindpunt maken wordt geopend. Hier kunt u opgeven:

    • Naam: naam van het eindpunt; u kunt elke tekst invoeren.
    • GraphQL-schema gebruiken dat wordt geleverd door: gebruik de vervolgkeuzelijst om de gewenste site of het vereiste project te selecteren.
    note note
    NOTE
    De volgende waarschuwing wordt weergegeven in het dialoogvenster:
    • GraphQL-eindpunten kunnen problemen met gegevensbeveiliging en -prestaties veroorzaken als deze niet zorgvuldig worden beheerd. Zorg ervoor dat de aangewezen toestemmingen na het creĆ«ren van een eindpunt worden geplaatst.
  4. Bevestigen met Maken.

  5. De Volgende stappen de dialoog zal een directe verbinding aan de console van de Veiligheid verstrekken zodat u kunt ervoor zorgen dat het gecreeerde eindpunt geschikte toestemmingen heeft.

    note caution
    CAUTION
    Het eindpunt is toegankelijk voor iedereen. Dit kan - vooral bij publicatieinstanties - een veiligheidszorg veroorzaken, aangezien de vragen van GraphQL een zware lading op de server kunnen opleggen.
    U kunt opstelling ACLs, aangewezen aan uw gebruiksgeval, op het eindpunt.

GraphQL Endpoint publiceren publishing-graphql-endpoint

Selecteer het nieuwe eindpunt en Publiceren om het volledig beschikbaar te maken in alle milieu's.

CAUTION
Het eindpunt is toegankelijk voor iedereen.
Bij het publiceren van instanties kan dit een veiligheidszorg veroorzaken, aangezien de vragen van GraphQL een zware lading op de server kunnen opleggen.
Instellen ACLs aangewezen aan uw gebruiksgeval op het eindpunt.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab