Einrichten eines Adobe Developer Console-Projekts configure-adc-project
Um die AEM Content AI Services-API aufzurufen, benötigen Sie Anmeldedaten, die von einem Adobe Developer Console-Projekt (ADC) ausgestellt wurden. Diese Seite führt Sie durch die Erstellung des Projekts, die Auswahl einer Authentifizierungsmethode und die Erstellung der Anmeldeinformationen, die Sie in jede API-Anfrage einbeziehen.
Gehen Sie zu Adobe Developer Console, damit Ihre Organisation beginnen kann.
Voraussetzungen prerequisites
Bevor Sie beginnen, stellen Sie Folgendes sicher:
- Sie haben Zugriff auf Adobe Developer Console für Ihr Unternehmen.
- Sie werden als Entwickler zum Produktprofil AEM Content AI Services in Adobe Admin Console hinzugefügt. Ohne diese Rolle ist die AEM Content AI Services-API-Karte deaktiviert und die Server-zu-Server-Authentifizierungsoption ist ausgeblendet.
- Sie kennen die Programm- und Umgebungsnummern für das Produktprofil, das Sie auswählen möchten (z. B.
AEM User - publish - Program 12345 - Environment 67890). - Sie haben die Systemadministrator-Rolle in Admin Console für das Programm. In dieser Rolle können Sie Produktprofile verwalten und Benutzende der Umgebung zuweisen.
Authentifizierungsmethode auswählen choose-auth
AEM Content AI Services unterstützt zwei Authentifizierungsmethoden. Wählen Sie die aus, die Ihrer Integration entspricht:
Server-zu-Server-Authentifizierung s2s-auth
-
Wählen Sie APIs und Services und dann APIs aus.
-
Filtern Sie nach AEM Content AI Services und wählen Sie dann Projekt erstellen, um ein neues Projekt zu starten, oder API hinzufügen, wenn Sie den Service zu einem vorhandenen Projekt hinzufügen.
note NOTE Wenn die API-Karte durch die Meldung „Lizenz erforderlich“ deaktiviert wird, wird Ihre AEM as a Cloud Service-Umgebung möglicherweise nicht modernisiert. Siehe Modernisierung der AEM as a Cloud Service-. -
Wählen Dialogfeld „API konfigurieren die Authentifizierung Server-zu-Server aus.
note tip TIP Wenn die Option Server-zu-Server nicht verfügbar ist, wird der Benutzer, der die Integration einrichtet, nicht als Entwickler zum Produktprofil hinzugefügt. Siehe Aktivieren der Server-zu-Server-Authentifizierung. -
Benennen Sie die Berechtigung bei Bedarf um. Wählen Sie Weiter aus.
Schritt
-
Wählen Sie das Produktprofil AEM-Benutzer - Veröffentlichen - Programm XXX - Umgebung XXX und/oder AEM-Benutzer - Autor - Programm XXX - Umgebung XXX aus und klicken Sie dann auf Speichern.
-
Überprüfen Sie die API- und Authentifizierungskonfiguration.
Erstellen eines Zugriffs-Tokens generate-token
-
Wechseln Sie in Ihrem ADC-Projekt zu Anmeldeinformationen und wählen Sie Zugriffstoken erstellen aus.
-
Fügen Sie das Token in die
Authorizationjeder API-Anfrage ein:code language-http Authorization: Bearer YOUR_ACCESS_TOKENnote warning WARNING Speichern Sie das Token sicher. Sie läuft ab und muss regelmäßig neu generiert werden.
API-Schlüsselauthentifizierung api-key-auth
-
Wenn Sie die AEM Content AI Services-API zu Ihrem Projekt hinzufügen, wählen Sie API-Schlüssel im Dialogfeld Authentifizierungstyp auswählen aus.
-
Bestätigen Sie die API-Schlüssel-Anmeldedaten.
-
Um zu beschränken, welche Ursprünge den Schlüssel verwenden können, konfigurieren Sie die zulässigen Domains.
-
Ihr API-Schlüssel (Client-ID) wird unter Verbundene Anmeldeinformationen angezeigt. Wählen Sie Kopieren.
-
Schließen Sie den Schlüssel in jede API-Anfrage ein:
code language-http x-api-key: YOUR_API_KEYIhr Projekt ist jetzt bereit. Verwenden Sie den -Schlüssel bei jeder Anfrage an AEM Content AI Services.
Nächste Schritte next-steps
- Steuern Ihrer Inhaltsquellen - Konfigurieren einer Inhaltsquelle in Cloud Manager und Trigger-Akquise.
- Content-API-Referenz - Verwenden Sie Ihr Zugriffstoken oder Ihren API-Schlüssel, um den indizierten Inhalt abzufragen.