Hantera GraphQL-slutpunkter i AEM graphql-aem-endpoint

Slutpunkten är den sökväg som används för att komma åt GraphQL för AEM. Med den här sökvägen kan du (eller din app):

  • tillgång till GraphQL schema,
  • skicka dina GraphQL-frågor
  • ta emot svaren (på dina GraphQL-frågor).

Det finns två typer av slutpunkter i AEM:

  • Global

    • Tillgängligt för alla webbplatser.
    • Den här slutpunkten kan använda alla modeller för innehållsfragment från alla platskonfigurationer (definieras i Konfigurationsläsaren).
    • Om det finns några modeller för innehållsfragment som ska delas mellan platskonfigurationer, ska dessa skapas under de globala platskonfigurationerna.
  • Platskonfigurationer:

    • Motsvarar en platskonfiguration, enligt definitionen i Konfigurationsläsaren.
    • Specifikt för en angiven plats/ett angivet projekt.
    • En platskonfigurationsspecifik slutpunkt använder innehållsfragmentmodellerna från den specifika platskonfigurationen tillsammans med de från den globala platskonfigurationen.
CAUTION
Innehållsfragmentsredigeraren kan tillåta att ett innehållsfragment av en platskonfiguration refererar till ett innehållsfragment av en annan platskonfiguration (via principer).
I så fall går det inte att hämta allt innehåll med en platskonfigurationsspecifik slutpunkt.
Innehållsförfattaren bör styra det här scenariot. Det kan till exempel vara bra att överväga att placera delade modeller för innehållsfragment under konfigurationen för globala webbplatser.

Databassökvägen för den globala slutpunkten för GraphQL AEM är:

/content/cq:graphql/global/endpoint

För vilken ditt program kan använda följande sökväg i URL:en för begäran:

/content/_cq_graphql/global/endpoint.json

Om du vill aktivera en slutpunkt för GraphQL för AEM måste du:

Aktivera din GraphQL-slutpunkt enabling-graphql-endpoint

Om du vill aktivera en GraphQL-slutpunkt måste du först ha en lämplig konfiguration. Se Innehållsfragment - Konfigurationsläsaren.

CAUTION
Om användningen av innehållsfragmentmodeller inte har aktiverats är alternativet Skapa inte tillgängligt.

Så här aktiverar du motsvarande slutpunkt:

  1. Navigera till Verktyg, Allmänt och välj sedan GraphQL.

  2. Välj Skapa.

  3. Dialogrutan Skapa ny GraphQL-slutpunkt öppnas. Här kan du ange:

    • Namn: slutpunktens namn. Du kan ange valfri text.
    • Använd GraphQL-schema från: använd listrutan för att välja önskad plats/önskat projekt.
    note note
    NOTE
    Följande varning visas i dialogrutan:
    • GraphQL-slutpunkter kan medföra problem med datasäkerhet och prestanda om de inte hanteras med omsorg. Kontrollera att rätt behörigheter har angetts efter att en slutpunkt har skapats.
  4. Bekräfta med Skapa.

  5. Dialogrutan Nästa steg innehåller en direktlänk till säkerhetskonsolen så att du kan kontrollera att den skapade slutpunkten har rätt behörigheter.

    note caution
    CAUTION
    Slutpunkten är tillgänglig för alla. Detta kan - särskilt när det gäller publiceringsinstanser - utgöra ett säkerhetsproblem, eftersom GraphQL-frågor kan belasta servern mycket.
    Du kan ställa in åtkomstkontrollistor, som passar ditt användningsfall, på slutpunkten.

Publicera din GraphQL-slutpunkt publishing-graphql-endpoint

Markera den nya slutpunkten och Publish för att göra den helt tillgänglig i alla miljöer.

CAUTION
Slutpunkten är tillgänglig för alla.
På publiceringsinstanser kan detta utgöra ett säkerhetsproblem, eftersom GraphQL-frågor kan medföra en stor belastning på servern.
Ställ in ACL:er som passar ditt användningsfall på slutpunkten.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab