Aanbevolen procedures voor het instellen en gebruiken van AEM GraphQL met Content Fragments best-practices-setup-use-aem-graphql-content-fragments

In deze richtlijnen wordt een overzicht gegeven van de aanbevolen aanbevolen procedures voor het instellen, configureren en gebruiken van AEM met GraphQL en Content Fragments.

Aan de slag getting-started

Zo kunt u sneller:

Instellen setup

Als u AEM GraphQL veilig wilt instellen voor gebruik met Content Fragments en uw apps, moet u verschillende componenten configureren.

GraphQL-eindpunt maken (inclusief beveiliging) graphql-endpoint-creation

Het eindpunt is het pad dat wordt gebruikt om toegang te krijgen tot GraphQL voor AEM. Deze eindpunten moeten worden gemaakt en gepubliceerd, zodat ze veilig toegankelijk zijn.

Details details-graphql-endpoint-creation

GraphQL-eindpunten beheren in AEM

Omgevingen environments-graphql-endpoint-creation

De eindpunten moeten worden gevormd in:

Voor:

AEM Dispatcher in cache plaatsen dispatcher-caching

Het in cache plaatsen van doorlopende query's is niet standaard ingeschakeld in de Dispatcher. Standaardactivering is niet mogelijk omdat klanten die gebruikmaken van CORS (Cross-Origin Resource Sharing) met meerdere origines hun Dispatcher-configuratie moeten controleren en mogelijk bijwerken.

Details details-dispatcher-caching

GraphQL Persisted Queries - caching inschakelen in Dispatcher

Omgevingen environments-dispatcher-caching

De Dispatcher is gewoonlijk geconfigureerd voor:

CORS instellen cors-setup

Om tot het eindpunt van GraphQL toegang te hebben, moet een beleid CORS worden gevormd en aan een Project van AEM worden toegevoegd dat aan AEM via Cloud Manager wordt opgesteld. Dit wordt gedaan door een aangewezen OSGi CORS configuratiedossier voor het gewenste eindpunt (s) toe te voegen.

Details details-cors-setup

Configuratie voor het delen van bronnen tussen verschillende bronnen (CORS)

Omgevingen environments-cors-setup

CORS wordt gewoonlijk geconfigureerd voor:

Verificatie authentication

Een van de belangrijkste gebruiksscenario's voor de Adobe Experience Manager as a Cloud Service (AEM) GraphQL API voor het leveren van inhoudsfragmenten is het accepteren van externe query's van toepassingen of services van derden. Deze externe query's vereisen mogelijk geverifieerde API-toegang om de levering van inhoud zonder kop te beveiligen.

Details details-authentication

Verificatie voor externe AEM GraphQL-query's op inhoudsfragmenten

Omgevingen environments-authentication

De authentificatie wordt gewoonlijk gevormd voor:

Voor:

Machtigingen permissions

Met een implementatie zonder kop zijn er verschillende gebieden met beveiliging en machtigingen die moeten worden aangepakt. De toestemmingen en de personen kunnen globaal worden overwogen gebaseerd op het milieu van AEM Auteur of publiceren. Elke omgeving bevat verschillende personen en met verschillende behoeften.

Details details-permissions

Bevoegdheidsoverwegingen voor inhoud zonder kop

Omgevingen environments-permissions

De toestemmingen worden gewoonlijk gevormd voor:

Voor:

Een CDN (Content Delivery Network) gebruiken cdn

GraphQL-query's en hun JSON-antwoorden kunnen in de cache worden geplaatst als ze worden aangewezen als GET -aanvragen bij het gebruik van een CDN. Aanvragen zonder cache kunnen daarentegen zeer (bron)duur zijn en traag verlopen, met mogelijk verdere nadelige gevolgen voor de middelen van de oorsprong.

Details details-cdn

CDN in AEM as a Cloud Service

Omgevingen environments-cdn

Een CDN wordt gewoonlijk gevormd voor:

Inhoudsfragmenten configureren en maken cconfigure-create-content-fragments

AEM GraphQL wordt gebruikt om informatie op te halen uit uw inhoudsfragmenten. Deze moeten worden gevormd, dan wordt een structuur en een plaats bepaald, alvorens u de inhoud kunt tot stand brengen.

Details details-content-fragments

Omgevingen eenvironments-content-fragments

Inhoudsfragmenten worden gedefinieerd, geschreven, getest, gepubliceerd en geopend op:

Voor:

AEM GraphQL gebruiken use-aem-graphql

GraphQL-query's optimaliseren optimize-graphql-queries

Deze richtlijnen zijn bedoeld om prestatieproblemen met uw GraphQL-query's te voorkomen.

Details details-optimize-graphql-queries

GraphQL-query's optimaliseren

GraphQL openen vanuit uw apps access-graphql-from-your-apps

AEM headless CMS geeft ontwikkelaars de vrijheid om uitzonderlijke ervaringen op te bouwen en te leveren met behulp van de talen, frameworks en tools die ze al kennen.

Details details-your-apps

Omgevingen environments-your-apps

Apps worden gewoonlijk ontwikkeld, getest en gebruikt op:

Voor:

Aanvullende bronnen

Raadpleeg de volgende secties voor meer informatie over AEM GraphQL en Content Fragments: