Konfigurieren von Asset-Tags mit dem Smart Content Service configure-asset-tagging-using-the-smart-content-service
Sie können Adobe Experience Manager mit dem Smart Content Service mit Adobe Developer Console. Verwenden Sie diese Konfiguration, um von aus auf den Smart Content Service zuzugreifen Experience Manager.
- Smart Content Services ist nicht mehr für neue Kunden von Experience Manager Assets On-Premise verfügbar. Bestehende On-Premise-Kunden, die diese Funktion bereits aktiviert haben, können Smart Content Services weiterhin nutzen.
- Smart Content Services ist für bestehende Kunden von Experience Manager Assets Managed Services verfügbar, für die diese Funktion bereits aktiviert ist.
- Neue Kunden von Experience Manager Assets Managed Services können die in diesem Artikel beschriebenen Anweisungen zum Einrichten von Smart Content Services befolgen.
Der Artikel beschreibt die folgenden wichtigen Aufgaben, die zum Konfigurieren des Smart Content Service erforderlich sind. Am Backend wird die Experience Manager -Server authentifiziert Ihre Dienstanmeldeinformationen mit dem Adobe Developer Console Gateway vor der Weiterleitung Ihrer Anforderung an den Smart Content Service.
-
Erstellen eines Smart Content Service Konfiguration in Experience Manager , um einen öffentlichen Schlüssel zu generieren. Erlangen Sie ein öffentliches Zertifikat für die OAuth-Integration.
-
Erstellen Sie eine Integration in der Adobe Developer Console und laden Sie den generierten öffentlichen Schlüssel hoch.
-
Implementierung konfigurieren Verwendung des API-Schlüssels und anderer Anmeldeinformationen von Adobe Developer Console.
-
Optional können Sie das automatische Tagging beim Hochladen eines Assets aktivieren.
Voraussetzungen prerequisites
Bevor Sie den Smart Content Service verwenden, stellen Sie Folgendes sicher, um eine Integration in Adobe Developer Console:
-
Es ist ein Adobe ID-Konto mit Administratorrechten für die Organisation vorhanden.
-
Der Smart Content Service ist für Ihre Organisation aktiviert.
Um optimierte Smart-Tags zu aktivieren, installieren Sie zusätzlich zu den oben genannten auch die neuesten Experience Manager Service Pack.
Erstellen der Konfiguration des Smart Content Service zum Abrufen eines öffentlichen Zertifikats obtain-public-certificate
Mit einem öffentlichen Zertifikat können Sie Ihr Profil bei Adobe Developer Console.
-
Greifen Sie in der Experience Manager-Benutzeroberfläche auf Tools > Cloud Services > Ältere Cloud Services zu.
-
Klicken Sie auf der Seite „Cloud Services“ unter Assets Smart Tags auf Jetzt konfigurieren.
-
Geben Sie im Dialogfeld Konfiguration erstellen einen Titel und einen Namen für die Smart-Tags-Konfiguration ein. Klicken Sie auf Erstellen.
-
Verwenden Sie im Dialogfeld AEM Smart Content Service die folgenden Werte:
Service-URL:
https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>
Beispiel:
https://smartcontent.adobe.io/apac
. Sie könnenna
,emea
oderapac
als die Regionen angeben, in denen Ihre Experience Manager-Autoreninstanz gehostet wird.note note NOTE Wenn der Experience Manager Managed Service vor dem 1. September 2022 bereitgestellt wurde, verwenden Sie die folgende Service-URL: https://mc.adobe.io/marketingcloud/smartcontent
Autorisierungsserver:
https://ims-na1.adobelogin.com
Lassen Sie die anderen Felder vorerst leer (Werte werden später bereitgestellt). Klicken Sie auf OK.
Abbildung: Dialogfeld von Content Service zum Bereitstellen der Content Service-URL
note note NOTE Die als Service-URL angegebene URL ist über den Browser nicht erreichbar und erzeugt einen 404-Fehler. Die Konfiguration funktioniert problemlos mit demselben Wert für den Service-URL-Parameter. Informationen zum Gesamtstatus und Wartungszeitplan für den Service finden Sie unter https://status.adobe.com. -
Klicken Sie auf Öffentliches Zertifikat für OAuth-Integration herunterladen und laden Sie die öffentliche Zertifikatdatei
AEM-SmartTags.crt
herunter.Abbildung: Einstellungen für den Smart-Tagging-Service
Erneutes Konfigurieren, wenn ein Zertifikat abläuft certrenew
Wenn ein Zertifikat abläuft, ist es nicht mehr vertrauenswürdig. Sie können ein abgelaufenes Zertifikat nicht verlängern. Um ein neues Zertifikat hinzuzufügen, führen Sie diese Schritte aus.
-
Melden Sie sich bei Ihrer Experience Manager-Implementierung als Administrator an. Klicken Sie auf Tools > Sicherheit > Benutzer.
-
Suchen und finden Sie dam-update-service-Benutzer und klicken Sie darauf. Klicken Keystore Registerkarte.
-
Vorhandene löschen similaritysearch Keystore mit dem abgelaufenen Zertifikat. Klicken Sie auf Speichern und schließen.
Abbildung: Löschen des vorhandenen Eintrags
similaritysearch
in Keystore, um ein neues Sicherheitszertifikat hinzuzufügen. -
Navigieren Sie zu Tools > Cloud Services > Legacy-Cloud Services. Klicken Sie auf Asset-Smart-Tags > Konfiguration anzeigen > Verfügbare Konfigurationen. Klicken Sie auf die gewünschte Konfiguration.
-
Um ein öffentliches Zertifikat herunterzuladen, klicken Sie auf Öffentliches Zertifikat für OAuth-Integration herunterladen.
-
Zugriff https://console.adobe.io und navigieren Sie zu den vorhandenen Smart Content Services auf der Integrationen Seite. Laden Sie das neue Zertifikat hoch. Weitere Informationen finden Sie in den Anweisungen unter Erstellen einer Integration in der Adobe Developer Console.
Erstellen einer Integration in der Adobe Developer Console create-adobe-i-o-integration
Um die Smart Content Service-APIs zu verwenden, erstellen Sie eine Integration in der Adobe Developer Console, um den API-Schlüssel (der im Feld CLIENT-ID der Adobe Developer Console-Integration generiert wird), die ID DES TECHNISCHEN KONTOS, die ORGANISATIONS-ID und das CLIENT-GEHEIMNIS für die Smart Tagging Service-Einstellungen für Assets der Cloud-Konfiguration in Experience Manager.
-
Rufen Sie https://console.adobe.io in einem Browser auf. Wählen Sie das entsprechende Konto aus und vergewissern Sie sich, dass die zugehörige Organisationsrolle „Systemadministrator“ ist.
-
Erstellen Sie ein Projekt mit einem beliebigen Namen. Klicken Sie auf API hinzufügen.
-
Wählen Sie auf der Seite API hinzufügen die Option Experience Cloud und dann Smart Content aus. Klicken Sie auf Weiter.
-
Wählen Sie Öffentlichen Schlüssel hochladen aus. Stellen Sie die von Experience Manager heruntergeladenen Zertifikatdatei bereit. Die Meldung Öffentliche® Schlüssel erfolgreich hochgeladen wird angezeigt. Klicken Sie auf Weiter.
Die Seite Neue Dienstkonto (JWT)-Anmeldedaten erstellen zeigt den öffentlichen Schlusselle für das Dienstkonto an, das Sie gerade konfiguriert haben.
-
Klicken Sie auf Weiter.
-
Wählen Sie auf der Seite Produktprofile auswählen die Option Smart Content Services aus. Klicken Sie auf Konfigurierte API speichern.
Auf einer Seite werden weitere Informationen zur Konfiguration angezeigt. Lassen Sie diese Seite geöffnet, um diese Werte zu kopieren und in den Einstellungen des Smart Tagging Service für Assets in der Cloud-Konfiguration in Experience Manager zuzufügen, um Smart Tags zu konfigurieren.
Abbildung: Integrationsdetails in der Adobe Developer Console
Konfigurieren des Smart Content Service configure-smart-content-service
Verwenden Sie zum Konfigurieren der Integration die Werte der Felder ID DES TECHNISCHEN KONTOS, ORGANISATIONS-ID, CLIENT-GEHEIMNIS und CLIENT-ID aus der Adobe Developer Console-Integration. Das Erstellen einer Smart-Tags-Cloud-Konfiguration ermöglicht die Authentifizierung von API-Anfragen aus der Experience Manager-Bereitstellung.
-
Gehen Sie in Experience Manager zu Tools > Cloud Service > Ältere Cloud-Services, um die Cloud Services-Konsole zu öffnen.
-
Unter dem Smart-Tags für Assets, öffnen Sie die oben erstellte Konfiguration. Klicken Sie auf der Seite "Diensteinstellungen"auf Bearbeiten.
-
Verwenden Sie im Dialogfeld AEM Smart Content Service die vorausgefüllten Werte für die Felder Service-URL und Autorisierungsserver.
-
Für die Felder API-Schlüssel, ID des Technischen Kontos, Organisations-ID und Client-Geheimnis, kopieren und verwenden Sie die folgenden Werte, die in Integration der Adobe Developer Console generiert wurden.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Diensteinstellungen für Smart-Tagging in Assets Adobe Developer Console Integrationsfelder API-Schlüssel CLIENT-ID ID des technischen Kontos ID DES TECHNISCHEN KONTOS Organisations-ID ORGANISATIONS-ID Client-Geheimnis CLIENT-GEHEIMNIS
Überprüfen der Konfiguration validate-the-configuration
Nachdem Sie die Konfiguration abgeschlossen haben, verwenden Sie ein JMX MBean, um die Konfiguration zu validieren. Führen Sie zum Überprüfen die folgenden Schritte aus.
-
Greifen Sie unter
https://[aem_server]:[port]
auf Ihren Experience Manager-Server zu. -
Gehen Sie zu Tools > Vorgänge > Web-Konsole, um die OSGi-Konsole zu öffnen. Klicken Sie auf Main > JMX.
-
Klicken com.day.cq.dam.similaritysearch.internal.impl. Die Seite SimilaritySearch Miscellaneous Tasks wird geöffnet
-
Klicken validateConfigs(). Klicken Sie im Dialogfeld Konfigurationen prüfen auf Aufrufen.
Das Überprüfungsergebnis wird im selben Dialogfeld angezeigt.
Aktivieren der Smart-Tagging-Funktion im Workflow DAM Update Asset (optional) enable-smart-tagging-in-the-update-asset-workflow-optional
-
Gehen Sie in Experience Manager zu Tools > Workflow > Modelle.
-
Wählen Sie auf der Seite Workflow-Modelle das Workflow-Modell DAM Update Asset aus.
-
Klicken Sie in der Symbolleiste auf Bearbeiten.
-
Erweitern Sie das Seitenbedienfeld, um die Schritte anzuzeigen. Ziehen Sie den Schritt Asset intelligent taggen, der im Abschnitt „DAM-Workflow“ verfügbar ist, und platzieren Sie ihn nach dem Schritt Prozessminiaturansichten.
Abbildung: Schritt zum Hinzufügen von Smart-Tag-Assets nach dem Schritt „Miniaturansichten verarbeiten“ im Workflow „DAM-Update-Asset“.
-
Öffnen Sie den Schritt im Bearbeitungsmodus. Stellen Sie unter Erweiterte Einstellungen sicher, dass die Option Handler-Erweiterung ausgewählt ist.
Abbildung: Konfigurieren des Workflows „DAM-Update-Asset“ und Hinzufügen des Schritts „Smart-Tag“
-
Wählen Sie auf der Registerkarte Argumente die Option Fehler ignorieren, wenn der Workflow auch dann abgeschlossen werden soll, falls der automatische Tag-Schritt fehlschlägt.
Abbildung: Konfigurieren des Workflows „DAM Update Asset“, um den Schritt „Smart-Tag“ hinzuzufügen und den erweiterten Handler-Modus auszuwählen
Um Assets unabhängig davon mit Tags zu versehen, ob die Smart-Tagging-Funktion für Ordner aktiviert ist, wählen Sie Smart-Tag-Markierung ignorieren aus.
Abbildung: Konfigurieren Sie den Workflow DAM-Update-Asset , um den Schritt "Smart-Tag"hinzuzufügen und das Flag "Smart-Tag ignorieren"auszuwählen.
-
Klicken Sie auf OK, um den Prozessschritt zu schließen, und speichern Sie dann den Workflow.