Esecuzione del proprio servizio Universal Editor local-ue-service

Scopri come eseguire il servizio Universal Editor per lo sviluppo locale o come parte dell’infrastruttura.

Panoramica overview

Il servizio Universal Editor è ciò che lega Universal Editor e il sistema di back-end. Per poter sviluppare in locale per Universal Editor, è necessario eseguire una copia locale del servizio. Ciò è dovuto al fatto che:

Casi d’uso use-cases

Una copia personalizzata del servizio Universal Editor è utile per:

Sono supportati entrambi i casi di utilizzo. Questo documento spiega come eseguire AEM in HTTPS insieme a una copia locale del servizio Universal Editor.

Per eseguire il servizio Universal Editor come parte dell'infrastruttura, è necessario seguire gli stessi passaggi dell'esempio di sviluppo locale.

Configurare AEM per l’esecuzione su HTTPS aem-https

All’interno di un frame esterno protetto con HTTPS, non è possibile caricare un frame HTTP non sicuro. Il servizio Universal Editor viene eseguito su HTTPS, pertanto anche su HTTPS deve essere eseguito AEM o qualsiasi altra pagina remota.

A questo scopo, devi configurare l’AEM per l’esecuzione su HTTPS. A scopo di sviluppo, puoi utilizzare un certificato autofirmato.

Consulta questo documento su come configurare l'AEM in esecuzione su HTTPS, incluso un certificato autofirmato che puoi utilizzare.

Installare il servizio Universal Editor install-ue-service

Universal Editor Service non è un'intera copia di Universal Editor, ma solo un sottoinsieme delle sue funzioni per garantire che le chiamate dall'ambiente AEM locale non vengano instradate su Internet, ma da un endpoint definito controllato.

Per eseguire una copia locale del servizio Editor universale è necessario NodeJS versione 20.

Il servizio Universal Editor è disponibile tramite Software Distribution. Per informazioni dettagliate su come accedervi, consultare la documentazione sulla distribuzione software.

Salvare il file universal-editor-service.cjs da Distribuzione software nell'ambiente di sviluppo locale.

Creare un certificato per eseguire il servizio Universal Editor con HTTPS ue-https

Il servizio Editor universale richiede inoltre un certificato per l'esecuzione su HTTPS nell'ambiente di sviluppo.

Esegui il comando seguente.

$ openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem

Il comando genera un file key.pem e un file certificate.pem. Salvare questi file nello stesso percorso del file universal-editor-service.cjs.

Configurazione del servizio Universal Editor setting-up-service

È necessario impostare alcune variabili di ambiente in NodeJS per eseguire il servizio Universal Editor in locale.

Nello stesso percorso dei file universal-editor-service.cjs, key.pem e certificate.pem, creare un file .env con il contenuto seguente.

UES_PORT=8000
UES_PRIVATE_KEY=./key.pem
UES_CERT=./certificate.pem
UES_TLS_REJECT_UNAUTHORIZED=false
UES_CORS_PRIVATE_NETWORK=true

Nel nostro esempio, questi sono i valori minimi richiesti per lo sviluppo locale.

La tabella seguente descrive questi e altri valori aggiuntivi disponibili.

Esecuzione del servizio Editor universale running-ue

Per avviare il servizio Universal Editor, eseguire il comando seguente:

$ node ./universal-editor-service.cjs

Dovrebbe trasmettere quanto segue al terminale:

Universal Editor Service listening on port 8000 as HTTPS Server

Verificare che il servizio avvii il server HTTPS e non il server HTTP.

Utilizzo del servizio Editor universale locale anziché del servizio globale using-local-ue

Universal Editor conosce il servizio Universal Editor da utilizzare per modificare una pagina in base alla strumentazione. Questa operazione viene eseguita tramite i metatag nella pagina caricata nell’editor universale.

Per modificare una pagina con il servizio Universal Editor locale, è necessario impostare il seguente tag meta:

<meta name="urn:adobe:aue:config:service" content="https://localhost:8000">

Una volta impostato, ogni chiamata di aggiornamento del contenuto dovrebbe passare a https://localhost:8000 anziché al servizio Universal Editor predefinito.

Modifica di una pagina con il servizio Local Universal Editor editing

Con il servizio Universal Editor Service in esecuzione localmente e la pagina di contenuto dotata di strumenti per l'utilizzo del servizio locale, ora è possibile avviare l'editor.