Ausführen eines eigenen universellen Editordienstes local-ue-service

Erfahren Sie, wie Sie Ihren eigenen Universal Editor-Dienst entweder für die lokale Entwicklung oder als Teil Ihrer eigenen Infrastruktur ausführen können.

Übersicht overview

Der Dienst „Universeller Editor“ bindet den universellen Editor und das Backend-System zusammen. Um eine lokale Entwicklung für den universellen Editor durchführen zu können, müssen Sie eine lokale Kopie des Dienstes „Universeller Editor“ ausführen. Der Grund hierfür ist Folgender:

Anwendungsfälle use-cases

Ihre eigene Kopie des Universal Editor-Dienstes ist nützlich, wenn Sie:

Beide Anwendungsfälle werden unterstützt. In diesem Dokument wird beschrieben, wie Sie AEM in HTTPS zusammen mit einer lokalen Kopie des Universal Editor-Dienstes ausführen.

Wenn Sie Ihren eigenen Universal Editor-Dienst als Teil Ihrer eigenen Infrastruktur ausführen möchten, gehen Sie analog zum lokalen Entwicklungsbeispiel vor.

Einrichten von AEM für die Ausführung auf HTTPS aem-https

Innerhalb eines mit HTTPS gesicherten äußeren Rahmens kann kein unsicherer HTTP-Frame geladen werden. Der Dienst „Universeller Editor“ wird auf HTTPS ausgeführt, weshalb AEM oder jede andere Remote-Seite auch auf HTTPS ausgeführt werden muss.

Dazu müssen Sie AEM für die Ausführung auf HTTPS einrichten. Zu Entwicklungszwecken können Sie ein selbstsigniertes Zertifikat verwenden.

In diesem Dokument erfahren Sie, wie Sie AEM einrichten, das auf HTTPS ausgeführt wird, einschließlich eines selbstsignierten Zertifikats, das Sie verwenden können.

Installieren des Dienstes „Universeller Editor“ install-ue-service

Der Dienst „Universeller Editor“ ist keine vollständige Kopie des universellen Editors, sondern nur eine Teilmenge seiner Funktionen, um sicherzustellen, dass Aufrufe aus Ihrer lokalen AEM-Umgebung nicht über das Internet weitergeleitet werden, sondern von einem definierten Endpunkt, den Sie steuern.

NodeJS Version 20 ist erforderlich, um eine lokale Kopie des Dienstes „Universeller Editor“ auszuführen.

Der Dienst „Universeller Editor“ ist über die Software-Verteilung verfügbar. In der Dokumentation zur Software-Verteilung finden Sie weitere Informationen zum Zugriff darauf.

Speichern Sie die Datei universal-editor-service.cjs von der Software-Verteilung in Ihrer lokalen Entwicklungsumgebung.

Erstellen eines Zertifikats zum Ausführen des Dienstes „Universeller Editor“ mit HTTPS ue-https

Für den Dienst „Universeller Editor“ ist auch ein Zertifikat erforderlich, das in Ihrer Entwicklungsumgebung auf HTTPS ausgeführt werden kann.

Führen Sie den folgenden Befehl aus.

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

Der Befehl generiert eine Datei key.pem und eine Datei certificate.pem. Speichern Sie diese Dateien unter demselben Pfad wie Ihre Datei universal-editor-service.cjs.

Einrichten der Konfiguration des Dienstes „Universeller Editor“ setting-up-service

In NodeJS müssen eine Reihe von Umgebungsvariablen festgelegt sein, damit der Dienst „Universeller Editor“ lokal ausgeführt werden kann.

Erstellen Sie unter demselben Pfad wie die Dateien universal-editor-service.cjs, key.pem und certificate.pem eine Datei .env mit dem folgenden Inhalt.

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

Dies sind die Mindestwerte, die für die lokale Entwicklung in unserem Beispiel erforderlich sind.

In der folgenden Tabelle sind diese und zusätzliche Werte aufgeführt.

Ausführen des Dienstes „Universeller Editor“ running-ue

Führen Sie den folgenden Befehl aus, um den Dienst „Universeller Editor“ zu starten:

$ node ./universal-editor-service.cjs

Er sollte Folgendes an Ihr Terminal ausgeben:

Universal Editor Service listening on port 8000 as HTTPS Server

Stellen Sie sicher, dass der Dienst den HTTPS-Server und nicht den HTTP-Server startet.

Verwenden des lokalen Dienstes „Universeller Editor“ anstatt des globalen Dienstes using-local-ue

Der universelle Editor weiß, welcher Dienst „Universeller Editor“ zum Bearbeiten einer Seite verwendet werden soll, basierend darauf, wie die Seite instrumentiert ist. Dies erfolgt über Meta-Tags auf der Seite, die im universellen Editor geladen wird.

Damit eine Seite mit Ihrem lokalen Dienst „Universeller Editor“ bearbeitet werden kann, muss das folgende Meta-Tag festgelegt sein:

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

Nach der Festlegung sollte jeder Inhaltsaktualisierungsaufruf an https://localhost:8000 anstelle des standardmäßigen Dienstes „Universeller Editor“ erfolgen.

Bearbeiten einer Seite mit dem lokalen Dienst „Universeller Editor“ editing

Mit dem lokal ausgeführten Dienst „Universeller Editor“ und Ihrer Inhaltsseite, die für die Verwendung des lokalen Dienstes instrumentiert wurde,können Sie jetzt den Editor starten.