Generieren von Service-Anmeldeinformationen
Die Generierung von Service-Anmeldeinformationen ist in zwei Schritte unterteilt:
- Einmalige Erstellung eines technischen Kontos durch Adobe IMS Org-Administrierende
- Herunterladen und Verwenden der JSON mit den Service-Anmeldeinformationen des technischen Kontos
Erstellen eines technischen Kontos
Anders als Zugriffstoken für die lokale Entwicklung erfordern Service-Anmeldeinformationen die Erstellung eines technischen Kontos durch Adobe Org IMS-Administrierende, bevor sie heruntergeladen werden können. Für jeden Client, der programmtechnischen Zugriff auf AEM benötigt, sollten separate technische Konten eingerichtet werden.
Technische Konten werden einmal erstellt, die privaten Schlüssel, die zur Verwaltung der mit dem technischen Konto verbundenen Service-Anmeldeinformationen verwendet werden, können über einen längeren Zeitraum verwaltet werden. So müssen zum Beispiel neue private Schlüssel/Service-Anmeldeinformationen generiert werden, bevor der aktuelle private Schlüssel abläuft, damit Benutzende der Service-Anmeldeinformationen ununterbrochenen Zugriff haben.
-
Stellen Sie sicher, dass Sie wie folgt angemeldet sind:
- Admin des Adobe IMS-Organisationssystems
- Mitglied beim IMS-Produktprofil der AEM-Administrierenden auf AEM Author
-
Melden Sie sich bei Adobe Cloud Manager an
-
Öffnen Sie das Programm, das die AEM as a Cloud Service-Umgebung enthält, um die Einrichtung der Service-Anmeldeinformationen dafür zu integrieren.
-
Tippen Sie auf die Auslassungspunkte neben der Umgebung im Abschnitt Umgebungen und wählen Sie Developer Console.
-
Tippen Sie auf die Registerkarte Integrationen.
-
Tippen Sie auf die Registerkarte Technische Konten.
-
Tippen Sie auf Neues technisches Konto erstellen.
-
Die Service-Anmeldeinformationen des technischen Kontos werden initialisiert und als JSON angezeigt
Sobald die Service-Anmeldeinformationen der AEM as a Cloud Service-Umgebung initialisiert wurden, können andere AEM-Entwicklerinnen und -Entwickler in Ihrer Adobe IMS-Organisation sie herunterladen.
Herunterladen von Service-Anmeldeinformationen
Das Herunterladen der Service-Anmeldeinformationen erfolgt in ähnlichen Schritten wie die Initialisierung.
-
Stellen Sie sicher, dass Sie wie folgt angemeldet sind:
- Administrierende der Adobe IMS-Organisation
- Mitglied beim IMS-Produktprofil der AEM-Administrierenden auf AEM Author
-
Melden Sie sich bei Adobe Cloud Manager an.
-
Öffnen Sie das Programm mit der AEM as a Cloud Service Umgebung, mit der integriert werden soll
-
Tippen Sie auf die Auslassungspunkte neben der Umgebung im Abschnitt Umgebungen und wählen Sie Developer Console aus
-
Tippen Sie auf die Registerkarte Integrationen.
-
Tippen Sie auf die Registerkarte Technische Konten
-
Erweitern Sie das zu verwendende Technische Konto
-
Erweitern Sie den privaten Schlüssel, dessen Service-Anmeldeinformationen heruntergeladen werden, und überprüfen Sie, ob der Status Aktiv ist
-
Tippen Sie auf die Auslassungspunkte … > Ansicht des privaten Schlüssels, um die JSON-Dienstanmeldeinformationen anzuzeigen.
-
Tippen Sie auf die Herunterladen-Schaltfläche in der linken oberen Ecke, um die JSON-Datei herunterzulagen, die die Dienstanmeldeinformationen enthält, und speichern Sie die Datei an einem sicheren Speicherort.
Installieren der Dienstanmeldeinformationen
Die Dienstanmeldeinformationen enthalten die Details, die erforderlich sind, um ein JWT zu generieren. Dieses wird durch ein Zugriffs-Token ersetzt, das zur Authentifizierung bei AEM as a Cloud Service verwendet wird. Die Dienstanmeldeinformationen müssen an einem sicheren Speicherort gespeichert werden, auf den die externen Anwendungen, Systeme oder Services zugreifen können, die sie für den Zugriff auf AEM verwenden. Wie und wo die Dienstanmeldeinformationen verwaltet werden, variiert von Kunde zu Kunde.
Der Einfachheit halber werden die Dienstanmeldeinformationen in diesem Tutorial über die Befehlszeile übergeben. Bestimmen Sie gemeinsam mit Ihrem IT-Sicherheits-Team, wie Sie diese Anmeldeinformationen gemäß den Sicherheitsrichtlinien Ihres Unternehmens speichern und aufrufen können.
- Kopieren Sie die JSON mit den heruntergeladenen Dienstanmeldeinformationen in eine Datei mit dem Namen
service_token.json
im Stammverzeichnis des Projekts.- Denken Sie daran, Anmeldeinformationen niemals an Git zu übertragen!
Verwenden von Dienstanmeldeinformationen
Die Dienstanmeldeinformationen, ein vollständig geformtes JSON-Objekt, sind weder mit dem JWT noch mit dem Zugriffs-Token identisch. Stattdessen werden die Dienstanmeldeinformationen (die einen privaten Schlüssel enthalten) verwendet, um ein JWT zu generieren, das in Adobe IMS-APIs gegen ein Zugriffs-Token ausgetauscht wird.
- Laden Sie die Dienstanmeldeinformationen von der AEM Developer Console an einen sicheren Speicherort herunter.
- Die externe Anwendung muss programmgesteuert mit der AEM as a Cloud Service-Umgebung interagieren.
- Die externe Anwendung liest die Dienstanmeldeinformationen über einen sicheren Speicherort ein.
- Die externe Anwendung verwendet die Dienstanmeldeinformationen, um ein JWT-Token zu erstellen.
- Das JWT-Token wird an Adobe IMS gesendet, wo es gegen ein Zugriffs-Token eingetauscht wird.
- Adobe IMS gibt ein Zugriffs-Token zurück, das für den Zugriff auf AEM as a Cloud Service verwendet werden kann.
- Zugriffs-Token können die Ablaufzeit nicht ändern.
- Die externe Anwendung sendet HTTP-Anfragen an AEM als ein Cloud Service. Dabei wird das Zugriffs-Token zur Autorisierungs-Kopfzeile der HTTP-Anfragen als Bearer-Token hinzugefügt.
- AEM as a Cloud Service empfängt die HTTP-Anfrage, authentifiziert sie, führt die von ihr angeforderte Aufgabe aus und gibt eine HTTP-Antwort an die externe Anwendung zurück.