Gestire gli endpoint GraphQL in AEM graphql-aem-endpoint
L’endpoint è il percorso utilizzato per accedere a GraphQL per AEM. Utilizzando questo percorso (o la tua app) puoi:
- accedere allo schema GraphQL;
- inviare le query GraphQL;
- ricevere le risposte (alle query GraphQL).
Esistono due tipi di endpoint in AEM:
-
Globale
- Disponibile per tutti i siti.
- Questo endpoint può utilizzare tutti i modelli per frammenti di contenuto di tutte le configurazioni di Sites (definite nella sezione Browser configurazioni).
- Se esistono modelli per frammenti di contenuto che devono essere condivisi tra le configurazioni di Sites, questi devono essere creati nelle configurazioni globali di Sites.
-
Configurazioni di Sites:
- Corrisponde a una configurazione Sites, come definita nella sezione Browser configurazioni.
- Sono specifiche per un determinato sito o progetto.
- Un endpoint specifico per la configurazione di Sites utilizzerà i modelli di frammento di contenuto di quella specifica configurazione di Sites insieme a quelli della configurazione globale di Sites.
Il percorso dell’archivio di GraphQL per l’endpoint globale di AEM è:
/content/cq:graphql/global/endpoint
Per cui l’app può utilizzare il seguente percorso nell’URL della richiesta:
/content/_cq_graphql/global/endpoint.json
Per abilitare un endpoint per GraphQL per AEM è necessario:
Abilitazione dell’endpoint GraphQL enabling-graphql-endpoint
Per abilitare un endpoint GraphQL è innanzitutto necessario disporre di una configurazione appropriata. Vedi la sezione Frammenti di contenuto - Browser configurazioni.
Per abilitare l’endpoint corrispondente:
-
Passa a Strumenti, Generale, quindi seleziona GraphQL.
-
Seleziona Crea.
-
Viene visualizzata la finestra di dialogo Crea nuovo endpoint GraphQL. Qui potrai definire:
- Nome: nome dell’endpoint; puoi immettere qualsiasi testo.
- Utilizza lo schema GraphQL fornito da: utilizza l'elenco a discesa per selezionare il sito o il progetto richiesto.
note note NOTE Nella finestra di dialogo viene visualizzato la seguente avvertenza: - Se non vengono gestiti con attenzione, gli endpoint GraphQL possono causare problemi di prestazioni e sicurezza dei dati. Dopo aver creato un endpoint, verifica di aver impostato le autorizzazioni appropriate.
-
Conferma con Crea.
-
La finestra di dialogo Passaggi successivi fornirà un collegamento diretto alla console Sicurezza per verificare che l'endpoint creato disponga delle autorizzazioni appropriate.
note caution CAUTION L’endpoint è accessibile a tutti. Questo può creare problemi di sicurezza, soprattutto per le istanze di pubblicazione, in quanto le query GraphQL possono imporre un carico pesante sul server. Puoi impostare sull’endpoint eventuali ACL appropriate al tuo caso d’uso.
Pubblicazione dell’endpoint GraphQL publishing-graphql-endpoint
Seleziona il nuovo endpoint e scegli Pubblica per renderlo completamente disponibile in tutti gli ambienti.