Kör din egen universella redigeringstjänst local-ue-service

Lär dig hur du kan köra din egen Universal Editor-tjänst för lokal utveckling eller som en del av din egen infrastruktur.

Ökning overview

Universal Editor-tjänsten är den som binder Universal Editor och serverdelssystemet. Om du vill kunna utveckla lokalt för den universella redigeraren måste du köra en lokal kopia av den universella redigeringstjänsten. Detta beror på:

Användningsexempel use-cases

Din egen kopia av Universal Editor-tjänsten är användbar om du vill:

Båda användningsfallen stöds. I det här dokumentet förklaras hur du kör AEM i HTTPS tillsammans med en lokal kopia av den universella redigeringstjänsten.

Om du vill köra din egen Universal Editor-tjänst som en del av din egen infrastruktur följer du samma steg som det lokala utvecklingsexemplet.

Konfigurera AEM som ska köras på HTTPS aem-https

I en yttre ram som skyddas med HTTPS går det inte att läsa in en osäker HTTP-ram. Tjänsten Universal Editor körs på HTTPS och därför måste AEM eller andra fjärrsidor också köras på HTTPS.

För att göra detta måste du konfigurera AEM för att köra HTTPS. I utvecklingssyfte kan du använda självsignerade certifikat.

Se det här dokumentet om hur du konfigurerar AEM som körs på HTTPS, inklusive ett självsignerat certifikat som du kan använda.

Installera Universal Editor-tjänsten install-ue-service

Den universella redigeringstjänsten är inte en fullständig kopia av den universella redigeraren, utan bara en delmängd av dess funktioner för att säkerställa att samtal från den lokala AEM inte dirigeras över Internet, utan från en definierad slutpunkt som du kontrollerar.

NodeJS version 20 krävs för att köra en lokal kopia av Universal Editor-tjänsten.

Tjänsten Universal Editor är tillgänglig via Software Distribution. Mer information om hur du får åtkomst till programdistributionsdokumentationen finns i dokumentationen för programvarudistribution.

Spara filen universal-editor-service.cjs från programvarudistribution till den lokala utvecklingsmiljön.

Skapa ett certifikat som kör den universella redigeringstjänsten med HTTPS ue-https

Tjänsten Universal Editor kräver också ett certifikat som kan köras på HTTPS i din utvecklingsmiljö.

Kör följande kommando.

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

Kommandot genererar en key.pem- och en certificate.pem-fil. Spara dessa filer i samma sökväg som din universal-editor-service.cjs-fil.

Konfigurera tjänsten Universal Editor setting-up-service

Ett antal miljövariabler måste anges i NodeJS för att den universella redigeringstjänsten ska kunna köras lokalt.

Skapa en .env-fil med följande innehåll på samma sökväg som dina universal-editor-service.cjs-, key.pem- och certificate.pem-filer.

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

Detta är de minimivärden som krävs för lokal utveckling i vårt exempel.

Följande tabell innehåller information om dessa och ytterligare värden.

Kör den universella redigeringstjänsten running-ue

Kör följande kommando för att starta Universal Editor-tjänsten:

$ node ./universal-editor-service.cjs

Följande bör skickas till din terminal:

Universal Editor Service listening on port 8000 as HTTPS Server

Kontrollera att HTTPS-servern inte är en HTTP-server startas av tjänsten.

Använda den lokala universella redigeringstjänsten i stället för den globala tjänsten using-local-ue

Den universella redigeraren vet vilken Universal Editor-tjänst som ska användas för att redigera en sida baserat på hur sidan är instrumenterad. Detta görs via metataggar på sidan som läses in i Universal Editor.

För att en sida ska kunna redigeras med din lokala Universal Editor-tjänst måste följande meta-tagg anges:

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

När den är inställd ska du se alla anrop om innehållsuppdatering gå till https://localhost:8000 i stället för standardtjänsten Universal Editor.

Redigera en sida med den lokala universella redigeringstjänsten editing

Med den universella redigeringstjänsten som körs lokalt och innehållssidan som är instrumenterad för att använda den lokala tjänsten kan du nu starta redigeraren.