Configurare i tag delle risorse tramite Smart Content Service

È possibile integrare Adobe Experience Manager con Smart Content Service utilizzando Adobe Developer Console. Utilizzate questa configurazione per accedere a Smart Content Service dall'interno di Experience Manager.

L’articolo descrive le seguenti attività chiave necessarie per configurare il Servizio di contenuti avanzati. Nel back-end, il server di Experience Manager autentica le credenziali del servizio con il gateway di prima di inoltrare la richiesta al Servizio di contenuti avanzati.Adobe Developer Console

  1. Crea una configurazione del Servizio di contenuti avanzati in Experience Manager per generare una chiave pubblica. Ottieni un certificato pubblico per l’integrazione di OAuth.

  2. Crea un’integrazione in Adobe Developer Console e carica la chiave pubblica generata.

  3. Configurate la distribuzione utilizzando la chiave API e altre credenziali da Adobe Developer Console.

  4. Verifica la configurazione.

  5. Facoltativamente, abilita l'assegnazione di tag automatica al caricamento delle risorse.

Prerequisiti

Prima di utilizzare Smart Content Service, accertatevi quanto segue per creare un'integrazione su Adobe Developer Console:

  • Devi disporre di un account Adobe ID con privilegi di amministratore dell’organizzazione.

  • Smart Content Service è abilitato per la vostra organizzazione.

Per abilitare Enhanced Smart Tags, oltre a quanto sopra, installare anche il service pack Experience Manager più recente.

Creare la configurazione di Smart Content Service per ottenere il certificato pubblico

Un certificato pubblico consente di autenticare il profilo su Adobe Developer Console.

  1. Nell’interfaccia di Experience Manager, accedi a Strumenti > Cloud Services > Servizi cloud precedenti.

  2. Nella pagina Cloud Services, fare clic su Configura ora in Risorse Smart Tags.

  3. Nella finestra di dialogo Crea configurazione, specifica un titolo e un nome per la configurazione di tag avanzati. Fai clic su Crea.

  4. Nella finestra di dialogo Servizio di contenuti avanzati AEM, usa i seguenti valori:

    URL servizio: https://mc.adobe.io/marketingcloud/smartcontent

    Server autorizzazioni: https://ims-na1.adobelogin.com

    Lascia vuoti gli altri campi per il momento (dovranno essere riempiti successivamente). Fai clic su OK.

    Finestra di dialogo Servizio di contenuti avanzati di Experience Manager per fornire l’URL del servizio di contenuti

    Figura: Finestra di dialogo Smart Content Service per fornire l'URL del servizio di contenuto

    NOTA

    L'URL fornito come URL servizio non è accessibile tramite browser e genera un errore 404. La configurazione funziona correttamente con lo stesso valore del parametro URL del servizio. Per informazioni sullo stato generale del servizio e sul programma di manutenzione, vedere https://status.adobe.com.

  5. Fai clic su Scarica certificato pubblico per integrazione OAuth e scarica il file del certificato pubblico AEM-SmartTags.crt.

    Una rappresentazione delle impostazioni create per il servizio assegnazione tag avanzati

    Figura: Impostazioni per il servizio di smart tag

Riconfigura alla scadenza del certificato

Una volta scaduto, il certificato non è più affidabile. Non è possibile rinnovare un certificato scaduto. Per aggiungere un nuovo certificato, effettua le seguenti operazioni.

  1. Accedi alla tua implementazione di Experience Manager come amministratore. Fai clic su Strumenti > Protezione > Utenti.

  2. Individua e fai clic sull’utente dam-update-service. Fare clic sulla scheda Keystore.

  3. Elimina il registro chiavi esistente similaritysearch con il certificato scaduto. Fai clic su Salva e chiudi.

    Per aggiungere un nuovo certificato di protezione, eliminate la voce di ricerca per similarità esistente in Keystore

    Figura: per aggiungere un nuovo certificato di sicurezza, elimina la voce esistente similaritysearch in Registro chiavi

  4. Vai a Strumenti > Cloud Services > Servizi cloud precedenti. Fai clic su Tag avanzati risorse > Mostra configurazioni > Configurazioni disponibili. Seleziona la configurazione richiesta.

  5. Per scaricare un certificato pubblico, fai clic su Scarica certificato pubblico per integrazione OAuth.

  6. Accedi a https://console.adobe.io e passa ai Servizi di contenuti avanzati esistenti nella pagina Integrazioni. Carica il nuovo certificato. Per ulteriori informazioni, consultare le istruzioni riportate in Creare 'integrazione della console per sviluppatori di Adobi.

Crea 'integrazione con Developer Console di Adobe

Per utilizzare le API di Smart Content Service, create un'integrazione in Adobe Developer Console per ottenere Chiave API (generata nel campo ID CLIENT dell'integrazione Adobe Developer Console), ID ACCOUNT TECNICO, ID ORGANIZZAZIONE e ID CLIENT SECRET per Assets Smart Tagging Service Settings della configurazione cloud in Experience Manager.

  1. Accedi a https://console.adobe.io in un browser. Seleziona l’account appropriato e verifica che il ruolo aziendale associato sia quello di amministratore di sistema.

  2. Crea un progetto con il nome desiderato. Fai clic su Aggiungi API.

  3. Nella pagina Aggiungi un API, selezionare Experience Cloud, quindi selezionare Smart Content. Fai clic su Avanti.

  4. Seleziona Carica la chiave pubblica. Fornisci il file del certificato scaricato da Experience Manager. Viene visualizzato il messaggio Chiavi pubbliche caricate correttamente. Fai clic su Avanti.

    Nella pagina per la creazione di una nuova credenziale dell’account di servizio (JWT) viene visualizzata la chiave pubblica per l’account di servizio appena configurato.

  5. Fai clic su Avanti.

  6. Nella pagina per la selezione dei profili di prodotto, seleziona Servizi di contenuti avanzati. Fai clic su Salva API configurata.

    In una pagina vengono visualizzate ulteriori informazioni sulla configurazione. Tenete aperta questa pagina per copiare e aggiungere questi valori in Impostazioni servizio Smart Tagging Assets della configurazione cloud in Experience Manager per configurare gli smart tag.

    Nella scheda Panoramica, puoi esaminare le informazioni fornite sull’integrazione.

    Figura: Dettagli dell'integrazione in Adobe Developer Console

Configurare il Servizio di contenuti avanzati

Per configurare l'integrazione, utilizzate i valori dei campi ID ACCOUNT TECNICO, ID ORGANIZZAZIONE, CLIENT SECRET e ID CLIENT dall'integrazione Developer Console. La creazione di una configurazione cloud di Smart Tags consente l'autenticazione delle richieste API dalla distribuzione Experience Manager.

  1. In Experience Manager, passa a Strumenti > Cloud Service > Servizi cloud precedenti per aprire la console Cloud Services.

  2. In Tag avanzati risorse, apri la configurazione creata in precedenza. Nella pagina delle impostazioni del servizio, fai clic su Modifica.

  3. Nella finestra di dialogo Servizio di contenuti avanzati AEM, utilizza i valori precompilati per i campi URL servizio e Server autorizzazioni.

  4. Per i campi Chiave API, ID account tecnico, ID organizzazione e Segreto cliente, copiate e utilizzate i seguenti valori generati in Integrazione con Developer Console di Adobe.

    Impostazioni servizio tag avanzati di Assets Adobe Developer Console campi di integrazione
    Chiave API ID CLIENT
    ID account tecnico ID ACCOUNT TECNICO
    ID organizzazione ID ORGANIZZAZIONE
    Segreto client SEGRETO CLIENT

Convalidare la configurazione

Dopo aver completato la configurazione, utilizzate un MBean JMX per convalidare la configurazione. Per eseguire la convalida, effettua le seguenti operazioni.

  1. Accedi al server di Experience Manager all’indirizzo https://[aem_server]:[port].

  2. Passa a Strumenti > Operazioni > Console Web per aprire la console OSGi. Fai clic su Principale > JMX.

  3. Fai clic su com.day.cq.dam.similaritysearch.internal.impl. Si apre SimilaritySearch Miscellaneous Tasks.

  4. Fai clic su validateConfigs(). Nella finestra di dialogo Validate Configurations (Convalida configurazioni), fai clic su Invoke (Richiama).

    I risultati della convalida vengono visualizzati nella stessa finestra di dialogo.

Abilitare i tag avanzati nel flusso di lavoro DAM Update Asset (facoltativo)

  1. In Experience Manager, passare a Strumenti > Flusso di lavoro > Modelli.

  2. Nella pagina Modelli flusso di lavoro, seleziona il modello del flusso di lavoro Risorsa di aggiornamento DAM.

  3. Fai clic su Modifica nella barra degli strumenti.

  4. Per visualizzare i passaggi, espandi il pannello laterale. Trascina il passaggio Risorsa di tag avanzati della sezione Flusso di lavoro DAM e inseriscilo dopo il passaggio Elabora miniature.

    Aggiungi il passaggio Risorsa di tag avanzati dopo il passaggio Elabora miniature nel flusso di lavoro Aggiorna risorsa DAM

    Figura: Aggiungi il passaggio Risorsa di tag avanzati dopo il passaggio Elabora miniature nel flusso di lavoro Aggiorna risorsa DAM.

  5. Apri il passaggio in modalità di modifica. In Impostazioni avanzate, accertati che sia selezionata l’opzione Avanzamento gestore.

    Configurare il flusso di lavoro Aggiorna risorsa DAM e aggiungere il passaggio smart tag

    Figura: Configurare il flusso di lavoro Aggiorna risorsa DAM e aggiungere il passaggio smart tag

  6. Nella scheda Argomenti, seleziona Ignora errori se vuoi che il flusso di lavoro venga completato anche con esito negativo del passaggio di assegnazione tag automatica.

    Configurare il flusso di lavoro Aggiorna risorsa DAM per aggiungere il passaggio smart tag e selezionare l'avanzamento del gestore

    Figura: Configurare il flusso di lavoro Aggiorna risorsa DAM per aggiungere il passaggio smart tag e selezionare l'avanzamento del gestore

    Per assegnare i tag alle risorse quando vengono caricate, a prescindere dal fatto che l’assegnazione tag avanzati sia abilitata o meno per le cartelle, seleziona Ignora flag di tag avanzati.

    Configurare il flusso di lavoro Aggiorna risorsa DAM per aggiungere il passo smart tag e selezionare Ignora flag Smart Tag

    Figura: Configurare il flusso di lavoro Aggiorna risorsa DAM per aggiungere il passo smart tag e selezionare Ignora flag Smart Tag

  7. Fai clic su OK per chiudere il passaggio del processo, quindi salva il flusso di lavoro.

In questa pagina