Best practice per la configurazione e l’utilizzo di AEM GraphQL con frammenti di contenuto
- Argomenti:
- Headless
Creato per:
- Amministratore
- Sviluppatore
Queste linee guida riepilogano le best practice consigliate per l’impostazione, la configurazione e l’utilizzo di AEM con GraphQL e Frammenti di contenuto.
Guida introduttiva
Per aiutarti a imparare a usare al meglio:
- Cos’è headless?
- Panoramica dei vari ambienti nell'architettura dell'AEM
Configurazione
Per configurare in modo sicuro il GraphQL per l’AEM da utilizzare con i frammenti di contenuto e le app, è necessario configurare vari componenti.
Creazione di endpoint GraphQL (inclusa la sicurezza)
L’endpoint è il percorso utilizzato per accedere a GraphQL per AEM. Questi endpoint devono essere creati e pubblicati in modo da essere accessibili in modo sicuro.
Dettagli
Gestire gli endpoint GraphQL in AEM
Ambienti
Gli endpoint devono essere configurati in:
- Autore
- Anteprima
- Pubblicazione
Per:
- Ambiente di sviluppo
- Test
- Produzione
Memorizzazione in cache di Dispatcher AEM
NOTELa memorizzazione nella cache delle query persistenti non è abilitata per impostazione predefinita in Dispatcher. L’abilitazione predefinita non è possibile perché i clienti che utilizzano CORS (Cross-Origin Resource Sharing) con più origini devono rivedere, e possibilmente aggiornare, la configurazione di Dispatcher.
Dettagli
Query persistenti GraphQL: abilitazione della memorizzazione in cache in Dispatcher
Ambienti
Dispatcher è in genere configurato per:
- Publish: production
Configurazione CORS
NOTEPer accedere all’endpoint GraphQL, è necessario configurare un criterio CORS e aggiungerlo a un progetto AEM distribuito all’AEM tramite Cloud Manager. A questo scopo, aggiungi un file di configurazione OSGi CORS appropriato per gli endpoint desiderati.
Dettagli
Configurazione di Cross-Origin Resource Sharing (CORS)
Ambienti
CORS è in genere configurato per:
- Publish: production
Autenticazione
Un caso d’uso principale per l’API GraphQL di Adobe Experience Manager as a Cloud Service (AEM) per la distribuzione di frammenti di contenuto accetta query remote da applicazioni o servizi di terze parti. Queste query remote possono richiedere l’accesso a API autenticate, per garantire la distribuzione di contenuti headless.
Dettagli
Autenticazione per query GraphQL AEM remote su frammenti di contenuto
Ambienti
L’autenticazione è in genere configurata per:
- Anteprima
- Pubblicazione
Per:
- Ambiente di sviluppo
- Test
- Produzione
Autorizzazioni
Con un’implementazione headless, è necessario affrontare diverse aree di sicurezza e autorizzazioni. Le autorizzazioni e gli utenti tipo possono essere considerati in generale in base all’ambiente AEM Autore o Pubblica. Ogni ambiente contiene utenti tipo diversi e con esigenze diverse.
Dettagli
Considerazioni sulle autorizzazioni per contenuti headless
Ambienti
Le autorizzazioni sono generalmente configurate per:
- Autore
- Anteprima
- Pubblicazione
Per:
- Ambiente di sviluppo
- Test
- Produzione
Utilizzare una rete per la distribuzione dei contenuti (CDN)
Le query GraphQL e le relative risposte JSON possono essere memorizzate nella cache se impostate come GET richieste quando si utilizza una rete CDN. Al contrario, le richieste non memorizzate nella cache possono essere molto (risorse) costose e lente da elaborare, con il potenziale di ulteriori effetti negativi sulle risorse dell’origine.
- Publish: production
Configurare e creare frammenti di contenuto
AEM GraphQL viene utilizzato per recuperare informazioni dai frammenti di contenuto. Prima di poter creare il contenuto, è necessario configurarlo, quindi definire una struttura e una posizione.
Dettagli
Ambienti
I frammenti di contenuto sono definiti, creati, testati, pubblicati e accessibili su:
- Autore
- Anteprima
- Pubblicazione
Per:
- Ambiente di sviluppo
- Test
- Produzione
Utilizzo di AEM GraphQL
Ottimizzare le query GraphQL
Queste linee guida servono a prevenire problemi di prestazioni con le query GraphQL.
Dettagli
NOTEAccedere a GraphQL dalle app
I CMS headless AEM offrono agli sviluppatori la libertà di creare e distribuire esperienze eccezionali utilizzando i linguaggi, i framework e gli strumenti che già conoscono.
Dettagli
Ambienti
Le app vengono generalmente sviluppate, testate e utilizzate per:
- Anteprima
- Pubblicazione
Per:
- Ambiente di sviluppo
- Test
- Produzione
Risorse aggiuntive
Per ulteriori dettagli sul GraphQL dell’AEM e sui frammenti di contenuto, vedi: