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 Browser van de Configuratieworden bepaald).
    • 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 van Plaatsen, zoals die in Browser van de Configuratiewordt bepaald.
    • 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 de Fragmenten van de Inhoud - Browser van de Configuratie.

CAUTION
Als het gebruik van de modellen van het inhoudsfragment nietis toegelaten, creeer optie zal niet beschikbaar zijn.

Om het overeenkomstige eindpunt toe te laten:

  1. Navigeer aan Hulpmiddelen, Algemeen, dan uitgezocht GraphQL.

  2. Selecteer creeer.

  3. creeer nieuwe de dialoog van het Eindpunt van GraphQL opent. Hier kunt u opgeven:

    • Naam: naam van het eindpunt; u kunt om het even welke tekst ingaan.
    • schema van GraphQL van het Gebruik door wordt verstrekt: gebruik de drop-down lijst om de vereiste plaats/het project te selecteren dat.
    note note
    NOTE
    De volgende waarschuwing wordt weergegeven in het dialoogvenster:
    • de eindpunten van GraphQL kunnen gegevensveiligheid en prestatieskwesties introduceren als niet zorgvuldig beheerd. Zorg ervoor dat de aangewezen toestemmingen na het creĆ«ren van een eindpunt worden geplaatst.
  4. Bevestig met creeer.

  5. De Volgende stappen dialoog zal een directe verbinding aan de console van de Veiligheid verstrekken zodat u kunt verzekeren 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 Publish 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.
Opstelling ACLs aangewezen aan uw gebruiksgevalop het eindpunt.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab