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.
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.
Så här aktiverar du motsvarande slutpunkt:
-
Navigera till Verktyg, Allmänt och välj sedan GraphQL.
-
Välj Skapa.
-
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.
-
Bekräfta med Skapa.
-
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.