Verwalten von GraphQL-Endpunkten in AEM graphql-aem-endpoint
Der Endpunkt ist der Pfad, der für den Zugriff auf GraphQL für AEM verwendet wird. Mit diesem Pfad können Sie (oder Ihr Programm):
- auf das GraphQL-Schema zugreifen,
- Ihre GraphQL-Abfragen senden,
- Antworten (auf Ihre GraphQL-Abfragen) empfangen.
Es gibt zwei Arten von Endpunkten in AEMٔ:
-
Global
- Verfügbar zur Verwendung durch alle Websites.
- Dieser Endpunkt kann alle Inhaltsfragmentmodelle aus allen Sites-Konfigurationen verwenden (definiert im Konfigurations-Browser).
- Wenn es Inhaltsfragmentmodelle gibt, die unter Sites-Konfigurationen freigegeben werden sollen, sollten diese unter den globalen Sites-Konfigurationen erstellt werden.
-
Sites-Konfigurationen:
- Entspricht einer Sites-Konfiguration, wie im Konfigurations-Browser definiert.
- Spezifisch für eine bestimmte Website / ein bestimmtes Projekt.
- Ein für die Sites-Konfiguration spezifischer Endpunkt verwendet die Inhaltsfragmentmodelle aus dieser spezifischen Sites-Konfiguration zusammen mit denen aus der globalen Sites-Konfiguration.
Der Repository-Pfad des GraphQL für den globalen Endpunkt in AEM lautet:
/content/cq:graphql/global/endpoint
Ihr Programm kann den folgenden Pfad in der Anfrage-URL verwenden:
/content/_cq_graphql/global/endpoint.json
Um den GraphQL-Endpunkt für AEM zu aktivieren, gehen Sie folgendermaßen vor:
Aktivieren des GraphQL-Endpunkts enabling-graphql-endpoint
Um einen GraphQL-Endpunkt zu aktivieren, benötigen Sie zunächst eine entsprechende Konfiguration. Siehe Inhaltsfragmente – Konfigurations-Browser.
So aktivieren Sie den entsprechenden Endpunkt:
-
Gehen Sie zu Tools, Assets und wählen Sie GraphQL aus.
-
Wählen Sie Erstellen aus.
-
Das Dialogfeld Neuen GraphQL-Endpunkt erstellen wird geöffnet. Hier können Sie Folgendes angeben:
- Name: Name des Endpunkts; Sie können einen beliebigen Text eingeben.
- GraphQL-Schema verwenden, das bereitgestellt wurde von: Verwenden Sie das Dropdown-Menü, um die gewünschte Website / das gewünschte Projekt auszuwählen.
note note NOTE Die folgende Warnung wird im Dialogfeld angezeigt: - GraphQL-Endpunkte können Probleme mit der Datensicherheit und Leistung verursachen, wenn sie nicht sorgfältig verwaltet werden. Bitte stellen Sie sicher, dass Sie nach dem Erstellen eines Endpunkts die entsprechenden Berechtigungen festlegen.
-
Bestätigen Sie mit Erstellen.
-
Das Dialogfeld Nächste Schritte stellt einen direkten Link zur Sicherheitskonsole bereit, sodass Sie sicherstellen können, dass der neu erstellte Endpunkt über geeignete Berechtigungen verfügt.
note caution CAUTION Der Endpunkt ist für jeden zugänglich. Dies kann – insbesondere bei Veröffentlichungsinstanzen – Sicherheitsbedenken aufwerfen, da GraphQL-Abfragen eine hohe Server-Belastung verursachen können. Sie können am Endpunkt geeignete ACLs für Ihr Programm einrichten.
Veröffentlichen des GraphQL-Endpunkts publishing-graphql-endpoint
Wählen Sie den neuen Endpunkt und Veröffentlichen aus, um ihn in allen Umgebungen vollständig verfügbar zu machen.