Konfigurieren der Veröffentlichung auf Microservice-Basis mit JWT-Authentifizierung
[Cloud Service]{class="badge informative"}
Microservice-basierte Veröffentlichung in für Adobe Experience Manager Guides as a Cloud Service unterstützt die Typen von PDF (nativ und DITA-OT-basiert), HTML5, JSON und benutzerdefinierten Ausgabevorgaben.
Da die Anmeldedaten für das Dienstkonto (JWT) veraltet sind, wird empfohlen, die OAuth-basierte Authentifizierung von Adobe IMS zu verwenden. Erfahren Sie, wie Sie mit der OAuth-Authentifizierung 🔗 die Veröffentlichung auf Microservice-Basis konfigurieren.
Für den durch die JWT-basierte Authentifizierung von Adobe IMS gesicherten Publishing-Dienst sollten Kunden die folgenden Schritte ausführen, um ihre Umgebungen mit sicheren Token-basierten Authentifizierungsworkflows zu integrieren und mit der Verwendung der neuen Cloud-basierten skalierbaren Publishing-Lösung zu beginnen.
Erstellen von IMS-Konfigurationen in Adobe Developer Console
Rolle, die zum Erstellen der Konfigurationen erforderlich ist: Systemadministrator
Führen Sie die folgenden Schritte aus, um IMS-Konfigurationen in Adobe Developer Console zu erstellen:
-
Öffnen Sie Developer Console:
https://developer.adobe.com/console
. -
Wechseln Sie von oben auf die Registerkarte Projekte .
{width="500"}
-
Um ein neues leeres Projekt zu erstellen, wählen Sie Leeres Projekt aus der Dropdown-Liste Neues Projekt erstellen aus.
{width="500"}
-
Wählen Sie API aus der Dropdown-Liste Zum Projekt hinzufügen aus, um Ihrem Projekt die IO Management-API hinzuzufügen.
{width="300"} {width="500"}
-
Erstellen Sie beim Hinzufügen der API ein neues Paar aus privatem/öffentlichem Schlüssel. Dadurch wird automatisch der private Schlüssel auf Ihr System heruntergeladen.
{width="500"}
-
Speichern Sie die konfigurierte API.
{width="600"}
-
Gehen Sie zurück zur Registerkarte Projekte und klicken Sie links auf Projektübersicht .
{width="500"}
-
Klicken Sie oben auf die Schaltfläche Herunterladen , um die Service-JSON herunterzuladen.
{width="500"}
Sie haben jetzt die Details zur JWT-Authentifizierung konfiguriert und auch den privaten Schlüssel und die JSON-Datei mit den Dienstdetails heruntergeladen. Halten Sie diese beiden Dateien bereit, da diese Dateien im nächsten Abschnitt benötigt werden.
Hinzufügen der IMS-Konfiguration zur Umgebung
Führen Sie die folgenden Schritte aus, um der Umgebung die IMS-Konfiguration hinzuzufügen:
-
Öffnen Sie Experience Manager und wählen Sie dann Ihr Programm aus, das die Umgebung enthält, die Sie konfigurieren möchten.
-
Wechseln Sie zur Registerkarte Umgebungen .
-
Klicken Sie auf den Umgebungsnamen, den Sie konfigurieren möchten. Dies sollte Sie zur Seite "Umgebungsinformationen"führen.
-
Wechseln Sie zur Registerkarte Konfiguration .
-
Laden Sie den privaten Schlüssel und die Projekt-JSON hoch, wie im Screenshot unten dargestellt. Stellen Sie sicher, dass Sie dieselben Namen und Konfigurationen wie unten hervorgehoben verwenden.
{width="500"}
Nachdem Sie die IMS-Konfiguration zur Umgebung hinzugefügt haben, führen Sie die folgenden Schritte aus, um diese Eigenschaften mithilfe von OSGi mit Experience Manager Guides zu verknüpfen:
-
Fügen Sie im Git-Projektcode des Cloud Manager-Cloud-Managers die folgenden beiden Dateien hinzu (Dateiinhalte finden Sie unter Anhang).
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml
-
Stellen Sie sicher, dass die neu hinzugefügten Dateien von Ihrem
filter.xml
abgedeckt werden. -
Übernehmen Sie Ihre Git-Änderungen und übertragen Sie sie.
-
Führen Sie die Pipeline aus, um die Änderungen auf die Umgebung anzuwenden.
Danach sollten Sie in der Lage sein, das neue Microservice-basierte Cloud Publishing zu verwenden.
Häufig gestellte Fragen
- Kann ein einzelner Schlüssel in mehreren Cloud-Umgebungen verwendet werden?
- Ja, Sie können einen privaten Schlüssel generieren und ihn für alle Umgebungen verwenden. Sie müssen jedoch Umgebungsvariablen für alle Umgebungen konfigurieren und denselben Schlüssel verwenden.
- Wenn OSGi-Konfigurationen zur Verwendung von Microservice aktiviert sind, funktioniert der Veröffentlichungsprozess auf einem lokalen AEM-Server mit derselben Codebasis?
- Nein, wenn das Flag
dxml.use.publish.microservice
auftrue
gesetzt ist, sucht es immer nach Microservice-Konfigurationen. Setzen Siedxml.use.publish.microservice
auffalse
, damit die Veröffentlichung auf Ihrer lokalen Seite funktioniert.
- Nein, wenn das Flag
- Wie viel Speicher wird dem DITA-Prozess bei der Verwendung von mikrodienstbasierter Veröffentlichung zugewiesen? Wird dies über DITA-Profil-Ameisenparameter gesteuert?
- Bei mikrodienstbasierter Veröffentlichung wird die Speicherzuordnung nicht durch DITA-Profil-ant-Parameter gesteuert. Der im Dienstcontainer verfügbare Gesamtspeicher beträgt 8 GB, von denen 6 GB dem DITA-OT-Prozess zugeordnet sind.
Anhang appendix
Datei:com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
Inhalt:
{
"service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
"private.key": "$[secret:PRIVATE_KEY]"
}
Datei: com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml
Inhalt:
dxml.use.publish.microservice
: Wechsel zur Aktivierung der Veröffentlichung auf Microservice-Basis mithilfe von DITA-OTdxml.use.publish.microservice.native.pdf
: Wechseln Sie zum Aktivieren der mikrodienstbasierten nativen PDF-Veröffentlichung.
<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
jcr:primaryType="sling:OsgiConfig"
dxml.publish.microservice.url="https://adobeioruntime.net/api/v1/web/543112-guidespublisher/default/publishercaller.json"
dxml.use.publish.microservice="{Boolean}true"
dxml.use.publish.microservice.native.pdf="{Boolean}true"
/>