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:
-
Gå till Verktyg, Assets 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 du har angett rätt behörigheter när du har skapat en slutpunkt.
-
Bekräfta med Skapa.
-
Dialogrutan Nästa steg kommer att innehålla en direktlänk till säkerhetskonsolen så att du kan kontrollera att den nyskapade 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.