Dokumentation AEM as a Cloud Service Benutzerhandbuch

[AEM Forms]{class="badge positive" title="Gilt für AEM Forms)."}

OAuth Server-zu-Server-Authentifizierung

Last update: Fri Apr 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Gilt für:
Experience Manager as a Cloud Service

Themen:
Adaptive Formulare

Erstellt für:

Admin
Entwickler
Benutzende

Die OAuth Server-zu-Server-Authentifizierung ermöglicht den sicheren, Token-basierten Zugriff auf AEM Forms Communications-APIs, ohne dass eine Benutzerinteraktion erforderlich ist. Die OAuth-Server-zu-Server-Authentifizierung wird von Adobe Developer Console unterstützt.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

Stellen Sie sicher, dass Sie Zugriff auf die Adobe Developer Console speziell für die von Ihnen verwendete Umgebung haben.
Weisen Sie in der Adobe Admin Console die Rolle „Systemadministrator“ oder „Entwickler“ zu um den Zugriff auf die Adobe Developer Console zu ermöglichen.

Wie wird ein Zugriffs-Token mithilfe der OAuth-Server-zu-Server-Authentifizierung generiert?

Gehen Sie wie folgt vor, um ein Zugriffstoken von der Adobe Developer-Konsole aus zu generieren und Ihren ersten API-Aufruf über OAuth-Server-zu-Server-Authentifizierung durchzuführen.

1. Adobe Developer Console-Projekteinrichtung

Navigieren Sie zu Adobe Developer Console
Mit Adobe ID anmelden
Neues Projekt erstellen oder zu Ihrem vorhandenen Projekt navigieren

So erstellen Sie ein neues Projekt

Klicken Sie Abschnitt „Schnellstart auf Neues Projekt erstellen
Ein neues Projekt wird mit einem Standardnamen erstellt
Klicken oben auf „Projekt bearbeiten“
Geben Sie einen aussagekräftigen Namen an (z. B. „FormsProject„)
Klicken Sie auf Speichern.

So navigieren Sie zu Ihrem vorhandenen Projekt

Klicken Sie Adobe Developer Console auf Alle Projekte“
Suchen Sie Ihr Projekt und klicken Sie darauf, um es zu öffnen.

2. Hinzufügen von Forms-APIs

Fügen Sie Forms-APIs hinzu, je nachdem, was Sie tun möchten:

AEM Forms Communications APIs: Wird verwendet, wenn Sie Dokumente (PDF und zugehörige Formate) generieren, konvertieren, zusammenstellen oder sichern müssen.
Adaptive Forms Runtime-APIs - Wird verwendet, wenn Sie adaptive Forms zur Laufzeit rendern, übermitteln oder verarbeiten müssen.

Für AEM Forms Communications-APIs

Klicken Sie auf API hinzufügen
Forms-Kommunikations-APIs
1. Filtern im Dialogfeld „API" nach Experience Cloud
2. Wählen Sie Forms-Kommunikations-APIs“
3. Klicken Sie auf Weiter.
4. Wählen Sie OAuth Server-zu-Server Authentifizierungsmethode aus

Für adaptive Forms Runtime-APIs

Klicken Sie auf API hinzufügen
AEM Forms-Bereitstellungs- und Laufzeit-API auswählen
1. Filtern im Dialogfeld „API" nach Experience Cloud
2. Wählen Sie AEM Forms-Bereitstellungs- und Laufzeit-API“
3. Klicken Sie auf Weiter.
4. Wählen Sie die Authentifizierungsmethode OAuth-Server-zu-Server aus.

You can also add the API and authentication method to your existing project by clicking Add to Project > API
Add API to existing Project

3. Add Product Profile

Product profile provides permissions (or authorization) for credentials to access the AEM resources.

Select the Product Profile that matches your AEM instance URL (https://Service Type -Environment Type-Program XXX-Environment XXX.adobeaemcloud.com).

Service Type – specifies services or permissions associated with the AEM instance
Environment Type – specifies whether the envrionment is for Author or Publish service
Program XXX – identifies the Cloud Manager program ID
Environment XXX – identifies the specific environment ID within that program

note note
NOTE
Product profiles are tied to a specific AEM instance (program + environment). Always choose the profile that matches your instance URL.

Klicken Sie auf Konfigurierte API speichern. The API and Product Profile are added to your project

4. Generate and Save Credentials

Navigate to your project in Adobe Developer Console
Click OAuth Server-to-Server credential
View the Credential details section

Record API Credentials

    API Credentials:
    ================
    Client ID: <your_client_id>
    Client Secret: <your_client_secret>
    Technical Account ID: <tech_account_id>
    Organization ID: <org_id>
    Scopes: AdobeID,openid,read_organizations

5. Access Token Generation

Generate the Access token either manually or programmatically:

For Testing

Generate access tokens manually in Adobe Developer Console:

Navigate to your Project
1. In Adobe Developer Console, open your project
2. Click OAuth Server-to-Server

Zugriffs-Token generieren

Klicken Sie im API-Abschnitt Ihres Projekts auf Schaltfläche Zugriffs-Token generieren“.
Kopieren des generierten Zugriffstokens

Zugriffs-Token generieren

note note
NOTE
Das Zugriffs-Token ist nur für 24 Stunden gültig

Für die Produktion

Programmgesteuerte Generierung von Token mithilfe Adobe IMS-API:

Erforderliche Anmeldedaten:

Client-ID
Client-Geheimnis
Bereiche (typischerweise: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Token-Endpunkt:

code language-none
`https://ims-na1.adobelogin.com/ims/token/v3`

Beispielanfrage (curl):

code language-bash

code language-bash
`curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \ -H 'Content-Type: application/x-www-form-urlencoded' \ -d 'grant_type=client_credentials' \ -d 'client_id=<YOUR_CLIENT_ID>' \ -d 'client_secret=<YOUR_CLIENT_SECRET>' \ -d 'scope=AdobeID,openid,read_organizations'`

curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials' \
-d 'client_id=<YOUR_CLIENT_ID>' \
-d 'client_secret=<YOUR_CLIENT_SECRET>' \
-d 'scope=AdobeID,openid,read_organizations'

Antwort:

code language-json
`{ "access_token": "eyJhbGciOiJSUz...", "token_type": "bearer", "expires_in": 86399 }`

Sie können jetzt das generierte Zugriffstoken verwenden, um API-Aufrufe für Entwicklungs-, Staging- oder Produktionsumgebungen durchzuführen.

Best Practices: Verwalten von Anmeldeinformationen für Entwicklung, Staging und Produktion

Verwenden Sie immer separate Anmeldeinformationen für Entwicklung, Staging und Produktion.
Ordnen Sie jede Berechtigung der richtigen AEM-Umgebungs-URL zu.
Geheime Daten sicher speichern und niemals in die Quell-Code-Verwaltung übertragen.
Verfolgen Sie die Gültigkeit des Zugriffs-Tokens, da Token nur für 24 Stunden gültig sind.

Nächste Schritte

Informationen zum Einrichten einer Umgebung für synchrone Forms-Kommunikations-APIs finden Sie unter Synchrone Verarbeitung von AEM Forms as a Cloud Service Communications.