Uw eigen Universal Editor-service uitvoeren local-ue-service

Leer hoe u uw eigen Universal Editor-service kunt uitvoeren voor lokale ontwikkeling of als onderdeel van uw eigen infrastructuur.

Overzicht overview

De Universal Editor-service bindt de Universal Editor en het back-endsysteem. Als u zich lokaal voor de Universele Redacteur wilt kunnen ontwikkelen, moet u een lokaal exemplaar van de Universele Dienst van de Redacteur in werking stellen. Dit komt omdat:

Gevallen gebruiken use-cases

Uw eigen exemplaar van de Universal Editor-service is handig als u het volgende wilt doen:

Beide gebruiksgevallen worden ondersteund. In dit document wordt uitgelegd hoe u AEM uitvoert in HTTPS naast een lokale kopie van de Universal Editor-service.

Als u uw eigen Universal Editor-service wilt uitvoeren als onderdeel van uw eigen infrastructuur, voert u dezelfde stappen uit als in het lokale ontwikkelingsvoorbeeld.

AEM instellen voor uitvoering op HTTPS aem-https

Binnen een buitenframe dat is beveiligd met HTTPS, kan een onbeveiligd HTTP-frame niet worden geladen. De Universal Editor Service wordt uitgevoerd op HTTPS en daarom moet AEM of een andere externe pagina ook worden uitgevoerd op HTTPS.

Hiervoor moet u AEM instellen voor uitvoering op HTTPS. Voor ontwikkelingsdoeleinden kunt u zelfondertekend certificaat gebruiken.

zie dit documentop hoe te opstelling AEM lopend op HTTPS met inbegrip van een zelf-ondertekend certificaat u kunt gebruiken.

De Universal Editor-service installeren install-ue-service

De Universele Dienst van de Redacteur is geen volledig exemplaar van de Universele Redacteur, maar slechts een ondergroep van zijn eigenschappen om ervoor te zorgen dat de vraag van uw lokale AEM milieu niet over Internet wordt verpletterd, maar van een bepaald eindpunt u controleert.

versie NodeJS 20wordt vereist om een lokaal exemplaar van de Universele Dienst van de Redacteur in werking te stellen.

De Universal Editor Service is beschikbaar via Software Distribution. Gelieve te zien de documentatie van de Distributie van de Softwarevoor details op hoe te om tot het toegang te hebben.

Sla het universal-editor-service.cjs -bestand op van Softwaredistributie naar uw lokale ontwikkelomgeving.

Een certificaat maken om de Universal Editor-service met HTTPS uit te voeren ue-https

Voor de Universal Editor Service is ook een certificaat vereist dat op HTTPS in uw ontwikkelomgeving wordt uitgevoerd.

Voer de volgende opdracht uit.

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

De opdracht genereert een key.pem - en een certificate.pem -bestand. Sla deze bestanden op in hetzelfde pad als het universal-editor-service.cjs -bestand.

De configuratie van de Universal Editor-service instellen setting-up-service

Een aantal omgevingsvariabelen moet in NodeJS worden ingesteld om de Universal Editor Service lokaal uit te voeren.

Maak een .env -bestand met de volgende inhoud op hetzelfde pad als de universal-editor-service.cjs -, key.pem - en certificate.pem -bestanden.

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

Dit zijn de minimumwaarden die vereist zijn voor lokale ontwikkeling in ons voorbeeld.

In de volgende tabel worden deze en aanvullende waarden beschreven.

De Universal Editor-service uitvoeren running-ue

Voer de volgende opdracht uit om de Universal Editor Service te starten:

$ node ./universal-editor-service.cjs

Het zou het volgende aan uw terminal moeten uitvoeren:

Universal Editor Service listening on port 8000 as HTTPS Server

Zorg ervoor dat de service HTTPS Server start en niet HTTP Server.

De lokale Universal Editor-service gebruiken in plaats van de algemene service using-local-ue

De Universal Editor weet welke Universal Editor-service moet worden gebruikt om een pagina te bewerken op basis van de manier waarop de pagina van instrumenten is voorzien. Dit gebeurt aan de hand van metatags op de pagina die wordt geladen in de Universal Editor.

Als u een pagina wilt bewerken met uw lokale Universal Editor-service, moet u de volgende metatag instellen:

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

Als deze eenmaal is ingesteld, wordt elke aanroep van de inhoudsupdate weergegeven in plaats van naar https://localhost:8000 de standaardservice van de universele editor.

Een pagina bewerken met de lokale universele editor editing

Met de Universele dienst die van de Redacteuren uw inhoudspagina plaatselijk in werking stelt van instrumenten om de lokale dienst te gebruiken,kunt u de redacteur nu beginnen.