Konfigurieren von Asset-Tags mit dem Smart Content Service

Sie können Adobe Experience Manager mit dem Smart Content Service mit Adobe Developer Console integrieren. 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 Service-Anmeldedaten mit dem Gateway Adobe Developer Console , bevor Ihre Anfrage an den Smart Content Service weitergeleitet wird.

  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 mit dem API-Schlüssel und anderen Anmeldedaten aus 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 in 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 optimierte Smart-Tags zu aktivieren, installieren Sie zusätzlich zu den oben genannten auch das neueste Experience Manager Service Pack.

Erstellen der Konfiguration des Smart Content Service zum Abrufen eines öffentlichen Zertifikats

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 > Legacy-Cloud Services auf.

  2. Klicken Sie auf der Cloud Services-Seite unter Smart-Tags für Assets 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 Service"zur Bereitstellung der Inhaltsdienst-URL

    Abbildung: Dialogfeld "Smart Content Service"zur Bereitstellung der Content Service-URL

    HINWEIS

    Die als Dienst-URL angegebene URL kann nicht über den Browser aufgerufen werden und erzeugt einen 404-Fehler. Die Konfiguration funktioniert mit dem gleichen Wert wie der Parameter Dienst-URL . Der allgemeine Dienststatus und Wartungsplan finden Sie unter https://status.adobe.com.

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

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

    Abbildung: Einstellungen für den Smart-Tagging-Dienst

Neu konfigurieren, wenn ein Zertifikat abläuft

Nachdem ein Zertifikat abgelaufen ist, 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 similaritysearch 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.

Integration der Adobe Developer Console erstellen

Um Smart Content Service-APIs zu verwenden, erstellen Sie eine Integration in der Adobe Developer Console, um API-Schlüssel zu erhalten (generiert im Feld CLIENT-ID der Adobe Developer Console-Integration), TECHNISCHE KONTO-ID, ORGANIZATION ID und . 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 API hinzufügen die Option Experience Cloud und dann Smart Content aus. 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 zu kopieren und in Assets Smart Tagging Service Settings der Cloud-Konfiguration in Experience Manager hinzuzufügen, um Smart-Tags 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-GEHEIMNIS und CLIENT-ID aus der Adobe Developer-Integration. Das Erstellen einer Smart-Tags-Cloud-Konfiguration ermöglicht die Authentifizierung von API-Anfragen aus der Experience Manager-Implementierung.

  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 Client-Geheimnis die folgenden Werte, die in Adobe Developer Console-Integration generiert wurden.

    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 ein 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 Ähnlichkeitssuche Verschiedene Aufgaben geöffnet.

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

    Die Überprüfungsergebnisse werden im selben Dialogfeld angezeigt.

Aktivieren Sie Smart-Tagging im Workflow "DAM-Update-Asset"(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.

    Konfigurieren des Workflows "DAM-Update-Asset"und Hinzufügen des Schritts "Smart-Tag"

    Abbildung: Konfigurieren des Workflows "DAM-Update-Asset"und Hinzufügen des Schritts "Smart-Tag"

  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.

    Konfigurieren Sie den Workflow DAM-Update-Asset , um den Schritt "Smart-Tag"hinzuzufügen und den Handler-Modus auszuwählen.

    Abbildung: Konfigurieren Sie den Workflow DAM-Update-Asset , um den Schritt "Smart-Tag"hinzuzufügen und den 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 Workflow DAM-Update-Asset , um den Schritt "Smart-Tag"hinzuzufügen und das Flag "Smart-Tag ignorieren"auszuwählen.

    Abbildung: Konfigurieren Sie den Workflow DAM-Update-Asset , um den Schritt "Smart-Tag"hinzuzufügen und das Flag "Smart-Tag ignorieren"auszuwählen.

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

Auf dieser Seite