Asset-Tags mit dem Smart Content Service konfigurieren

Sie können Adobe Experience Manager mit dem Smart Content Service integrieren, indem Sie Adobe Developer Console verwenden. Verwenden Sie diese Konfiguration, um von Experience Manager aus auf den Smart Content Service zuzugreifen.

Der Artikel beschreibt die folgenden Hauptaufgaben, die zum Konfigurieren des Smart Content Service erforderlich sind. Am Backend authentifiziert der Server Experience Manager Ihre Dienstberechtigungen mit dem Adobe Developer Console Gateway, bevor Sie Ihre Anforderung an den Smart Content Service weiterleiten.

  1. Erstellen Sie in eine Konfiguration für den Smart Content Service, um einen öffentlichen Schlüssel zu erstellen. Experience Manager Erlangen Sie ein öffentliches Zertifikat für die OAuth-Integration.

  2. Erstellen Sie eine Integration in der Adobe Developer Console und laden Sie den generierten öffentlichen Schlüssel hoch.

  3. Konfigurieren Sie Ihre Bereitstellung mithilfe des API-Schlüssels und anderer Anmeldeinformationen von Adobe Developer Console.

  4. Testen Sie die Konfiguration.

  5. Optional können Sie das automatische Tagging beim Hochladen von Assets aktivieren.

Voraussetzungen

Bevor Sie den Smart Content Service verwenden, stellen Sie Folgendes sicher, um eine Integration auf Adobe Developer Console zu erstellen:

  • Es ist ein Adobe ID-Konto mit Administratorrechten für die Organisation vorhanden.

  • Der Smart Content ist für Ihre Organisation aktiviert.

Um erweiterte Smart-Tags zu aktivieren, installieren Sie zusätzlich zu den oben stehenden auch das neueste Experience Manager-Service Pack.

Konfiguration des Smart Content Service erstellen, um das öffentliche Zertifikat zu erhalten

Mit einem öffentlichen Zertifikat können Sie Ihr Profil auf Adobe Developer Console authentifizieren.

  1. Rufen Sie in der Experience Manager-Benutzeroberfläche Tools > Cloud Services > Ältere Cloud Services auf.

  2. Klicken Sie auf der Seite "Cloud Services"unter Assets Smart Tags auf Jetzt konfigurieren.

  3. Geben Sie im Dialogfeld Konfiguration erstellen einen Titel und einen Namen für die Smart-Tags-Konfiguration ein. Klicken Sie auf Erstellen.

  4. Verwenden Sie im Dialogfeld AEM Smart Content Service die folgenden Werte:

    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.

    Dialogfeld "Experience Manager-Smart-Content-Dienst"zur Bereitstellung der Content-Dienst-URL

    Abbildung: Dialogfeld "Smart Content Service"zum Bereitstellen der URL des Inhaltsdienstes

    HINWEIS

    Die als Dienst-URL bereitgestellte URL kann nicht über den Browser aufgerufen werden und erzeugt einen 404-Fehler. Die Konfiguration funktioniert mit demselben Wert des Parameters Dienst-URL. Der Gesamtplan für den Dienststatus und die Wartung finden Sie unter https://status.adobe.com.

  5. Klicken Sie auf Öffentliches Zertifikat für OAuth-Integration herunterladen und laden Sie die Datei für das öffentliche Zertifikat AEM-SmartTags.crt herunter.

    Darstellung der für den Smart-Tagging-Service erstellten Einstellungen

    Abbildung: Einstellungen für den intelligenten Tag-Dienst

Konfigurieren, wenn ein Zertifikat abläuft

Nach Ablauf eines Zertifikats wird es nicht mehr als vertrauenswürdig eingestuft. Sie können ein abgelaufenes Zertifikat nicht verlängern. Um ein neues Zertifikat hinzuzufügen, führen Sie diese Schritte aus.

  1. Melden Sie sich bei Ihrer Experience Manager-Implementierung als Administrator an. Klicken Sie auf Tools > Sicherheit > Benutzer.

  2. Suchen und finden Sie dam-update-service-Benutzer und klicken Sie darauf. Klicken Sie auf die Registerkarte Keystore.

  3. Löschen Sie den vorhandenen similaritysearch-Keystore mit dem abgelaufenen Zertifikat. Klicken Sie auf Speichern und schließen.

    Löschen Sie den vorhandenen Eintrag für Ähnlichkeitssuche in Keystore, um ein neues Sicherheitszertifikat hinzuzufügen.

    Abbildung: Löschen des vorhandenen Eintrags similaritysearch in Keystore, um ein neues Sicherheitszertifikat hinzuzufügen.

  4. Navigieren Sie zu Werkzeuge > Cloud Services > Legacy-Cloud Services. Klicken Sie auf Asset-Smart-Tags > Konfiguration anzeigen > Verfügbare Konfigurationen. Klicken Sie auf die gewünschte Konfiguration.

  5. Um ein öffentliches Zertifikat herunterzuladen, klicken Sie auf Öffentliches Zertifikat für OAuth-Integration herunterladen.

  6. Rufen Sie https://console.adobe.io auf und navigieren Sie zu den vorhandenen Smart Content Services auf der Seite Integrationen. Laden Sie das neue Zertifikat hoch. Weitere Informationen finden Sie in den Anweisungen unter Adobe Developer Console-Integration erstellen.

Adobe Developer Console-Integration erstellen

Um Smart Content Service-APIs zu verwenden, erstellen Sie eine Integration in der Adobe Developer Console, um API-Schlüssel (generiert im Feld CLIENT-ID der Adobe Developer Console-Integration), TECHNISCHE ACCOUNT-ID, ORGANISATION-ID und zu erhalten. CLIENT SECRET für Assets Smart Tagging Service Settings der Cloud-Konfiguration in Experience Manager.

  1. 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.

  2. Erstellen Sie ein Projekt mit einem beliebigen Namen. Klicken Sie auf API hinzufügen.

  3. Wählen Sie auf der Seite Hinzufügen eine API Experience Cloud und dann Smart Content. Klicken Sie auf Weiter.

  4. 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.

  5. Klicken Sie auf Weiter.

  6. 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 in Assets Smart Tagging Service Settings der Cloud-Konfiguration in Experience Manager zu kopieren und hinzuzufügen, um Smarttags zu konfigurieren.

    Auf der Registerkarte „Übersicht“ können Sie die für die Integration bereitgestellten Informationen überprüfen.

    Abbildung: Integrationsdetails in der Adobe Developer Console

Konfigurieren des Smart Content Service

Verwenden Sie zum Konfigurieren der Integration die Werte der Felder TECHNISCHE KONTO-ID, ORGANISATIONS-ID, CLIENT SECRET und CLIENT-ID aus der Adobe Developer Console. Das Erstellen einer Smart-Tags-Cloud-Konfiguration ermöglicht die Authentifizierung von API-Anforderungen aus der Experience Manager-Bereitstellung.

  1. Navigieren Sie in Experience Manager zu Tools > Cloud Service > Ältere Cloud Services, um die Konsole Cloud Services zu öffnen.

  2. Öffnen Sie unter den Smart-Tags für Assets die oben erstellte Konfiguration. Klicken Sie auf der Seite mit den Serviceeinstellungen auf Bearbeiten.

  3. Verwenden Sie im Dialogfeld AEM Smart Content Service die vorausgefüllten Werte für die Felder Service-URL und Autorisierungsserver.

  4. Kopieren Sie für die Felder API-Schlüssel, Technische Konto-ID, Organisations-ID und Clientgeheimnis die folgenden Werte, die in Adobe Developer Console integration generiert wurden, und verwenden Sie sie.

    Diensteinstellungen für Smart-Tagging in Assets Adobe Developer Console Integrationsfelder
    API-Schlüssel CLIENT-ID
    ID des technischen Kontos TECHNISCHE KONTO-ID
    Unternehmens-ID Organisations-ID
    Client-Geheimnis CLIENT SECRET

Überprüfen der Konfiguration

Nachdem Sie die Konfiguration abgeschlossen haben, verwenden Sie eine JMX MBean, um die Konfiguration zu validieren. Führen Sie zum Überprüfen die folgenden Schritte aus.

  1. Greifen Sie auf Ihren Experience Manager-Server unter https://[aem_server]:[port] zu.

  2. Öffnen Sie unter Tools > Vorgänge > Web-Konsole die OSGi-Konsole. Klicken Sie auf Haupt > JMX.

  3. Klicken Sie auf com.day.cq.dam.similaritysearch.internal.impl. Es wird Ähnliche Suche Verschiedene Aufgaben geöffnet.

  4. Klicken Sie auf validateConfigs(). Klicken Sie im Dialogfeld Konfigurationen überprüfen auf Aufrufen.

    Die Überprüfungsergebnisse werden im gleichen Dialogfeld angezeigt.

Aktivieren Sie intelligentes Tagging im DAM Update Asset-Arbeitsablauf (Optional)

  1. Gehen Sie in Experience Manager zu Tools > Workflow > Modelle.

  2. Wählen Sie auf der Seite Workflow-Modelle das Workflow-Modell DAM Update Asset aus.

  3. Klicken Sie in der Symbolleiste auf Bearbeiten.

  4. 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.

    Schritt zum Hinzufügen von Smart-Tag-Assets nach dem Schritt „Miniaturansichten verarbeiten“ im Workflow „DAM-Update-Asset“

    Abbildung: Schritt zum Hinzufügen von Smart-Tag-Assets nach dem Schritt „Miniaturansichten verarbeiten“ im Workflow „DAM-Update-Asset“.

  5. Öffnen Sie den Schritt im Bearbeitungsmodus. Stellen Sie unter Erweiterte Einstellungen sicher, dass die Option Handler-Erweiterung ausgewählt ist.

    DAM-Arbeitsablauf zum Aktualisieren von Assets konfigurieren und Schritt zum Hinzufügen von Smarttags

    Abbildung: DAM-Arbeitsablauf zum Aktualisieren von Assets konfigurieren und Schritt zum Hinzufügen von Smarttags

  6. 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.

    DAM-Arbeitsablauf zum Aktualisieren von Assets konfigurieren, um einen Schritt zum intelligenten Tag hinzuzufügen und Handler-Modus auszuwählen

    Abbildung: DAM-Arbeitsablauf zum Aktualisieren von Assets konfigurieren, um einen Schritt zum intelligenten Tag hinzuzufügen und 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.

    Konfigurieren Sie den Arbeitsablauf für DAM-Aktualisierung für Assets, um einen Schritt für intelligente Tags hinzuzufügen, und wählen Sie "Smart-Tag-Flag ignorieren"

    Abbildung: Konfigurieren Sie den Arbeitsablauf für DAM-Aktualisierung für Assets, um einen Schritt für intelligente Tags hinzuzufügen, und wählen Sie "Smart-Tag-Flag ignorieren"

  7. Klicken Sie auf OK, um den Prozessschritt zu schließen, und speichern Sie dann den Workflow.

Auf dieser Seite

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now