Configurazione IMS da utilizzare per l’integrazione con Adobe Target

L’integrazione di AEM con Adobe Target tramite l’API di Target Standard richiede la configurazione di Adobe IMS (Identity Management System). La configurazione viene realizzata con la console Adobe Developer.

NOTA

Il supporto per l’API Adobe Target Standard è una novità di AEMaaCS. L’API di Target Standard utilizza l’autenticazione IMS.

La selezione API è guidata dal metodo di autenticazione utilizzato per l’integrazione AEM/Target.

Prerequisiti

Prima di iniziare questa procedura:

  • Il Supporto Adobe deve effettuare il provisioning del tuo account per:

    • Console Adobe
    • Console per sviluppatori di Adobe
    • Adobe Target e
    • Adobe IMS (Identity Management System)
  • L’amministratore di sistema della tua organizzazione deve utilizzare l’Admin Console per aggiungere gli sviluppatori necessari ai profili di prodotto pertinenti.

    • Questo fornisce agli sviluppatori specifici le autorizzazioni per abilitare le integrazioni tramite la console Adobe Developer.
    • Per maggiori dettagli vedi Gestire gli sviluppatori.

Impostare una configurazione IMS - Generare una chiave pubblica

La prima fase consiste nel creare una configurazione IMS in AEM e generare la chiave pubblica.

  1. In AEM apri il menu Strumenti.

  2. Nella sezione Sicurezza seleziona Configurazioni Adobe IMS.

  3. Seleziona Crea per aprire Configurazione dell’account tecnico Adobe IMS.

  4. Utilizzando il menu a discesa in Configurazione cloud, seleziona Adobe Target.

  5. Attiva Crea nuovo certificato e immetti un nuovo alias.

  6. Conferma con Crea certificato.

    Crea certificato

  7. Seleziona Scarica (o Scarica chiave pubblica) per scaricare il file sull'unità locale, in modo che sia pronto per l'uso durante la configurazione di IMS per l’integrazione di Adobe Target con AEM.

    ATTENZIONE

    Mantieni aperta questa configurazione, sarà necessaria di nuovo durante il completamento della configurazione IMS in AEM.

    Scarica certificato

Configurazione di IMS per l’integrazione di Adobe Target con AEM

Progetto Adobe Developer Console (integrazione) con Adobe Target che AEM utilizzerà, quindi assegna i privilegi richiesti.

Creazione del progetto

Apri Adobe Developer Console per creare un progetto con Adobe Target che AEM utilizzerà:

  1. Apri la console Adobe Developer per progetti:

    https://developer.adobe.com/console/projects

  2. Verranno visualizzati tutti i progetti che hai. Seleziona Crea nuovo progetto; la posizione e l’utilizzo dipenderanno da:

    • Se non hai ancora un progetto, Crea nuovo progetto sarà al centro, in basso.
      Crea nuovo progetto - Primo progetto
    • Se disponi già di progetti esistenti, questi verranno elencati e Crea nuovo progetto sarà in alto a destra.
      Crea nuovo progetto - Più progetti
  3. Seleziona Aggiungi a progetto seguito da API:

    Aggiungi a progetto

  4. Seleziona Adobe Target, quindi Successivo:

    NOTA

    Se sei abbonato a Adobe Target ma non lo vedi nell’elenco, controlla i Prerequisiti.

  5. Carica la chiave pubblica e, una volta completato, continua con Successivo:

    Carica la chiave pubblica

  6. Controlla le credenziali e continua con Successivo:

    Controlla le credenziali

  7. Seleziona i profili di prodotto richiesti e continua con Salva API configurata:

    NOTA

    I profili di prodotto visualizzati dipendono dall’esistenza o meno di:

    • Adobe Target Standard: è disponibile solo l'area di lavoro predefinita
    • Adobe Target Premium: vengono elencate tutte le aree di lavoro disponibili, come illustrato di seguito

    Seleziona i profili di prodotto e salva l’API configurata

  8. La creazione verrà confermata.

Assegnazione di privilegi all'integrazione

Ora devi assegnare i privilegi richiesti all’integrazione:

  1. Apri l’Admin Console Adobe:

  2. Passa a Prodotti (barra degli strumenti superiore), quindi seleziona Adobe Target - <tuo-id-tenant> (dal pannello a sinistra).

  3. Seleziona Profili di prodotto, quindi l’area di lavoro richiesta dall’elenco presentato. Ad esempio, Area di lavoro predefinita.

  4. Seleziona Credenziali API, quindi la configurazione di integrazione richiesta.

  5. Seleziona Editor come Ruolo del prodotto; anziché Osservatore.

Dettagli memorizzati per il progetto di integrazione della console Adobe Developer

Dalla console Progetti di Adobe Developer Console è disponibile un elenco di tutti i progetti di integrazione:

Seleziona Visualizza (a destra di una specifica voce progetto) per visualizzare ulteriori dettagli sulla configurazione. Comprendono:

  • Panoramica del progetto
  • Approfondimenti
  • Credenziali
    • Account servizio (JWT)
      • Dettagli delle credenziali
      • Genera JWT
  • API
    • Ad esempio, Adobe Target

Alcune di queste sono necessarie per completare l’integrazione di Adobe Target in AEM basato su IMS.

Completamento della configurazione IMS in AEM

Tornando a AEM puoi completare la configurazione IMS aggiungendo i valori richiesti dall’integrazione IMS per Target:

  1. Torna a Configurazione IMS aperta in AEM.

  2. Seleziona Avanti.

  3. Qui puoi utilizzare i dettagli dalla configurazione del progetto nella console Adobe Developer:

    • Titolo: il tuo testo.
    • Server di autorizzazione: copia/incolla questo dalla riga aud della sezione seguente del Payload, ad esempio https://ims-na1.adobelogin.com nell’esempio seguente
    • Chiave API: copiala dalla sezione Panoramica del progetto
    • Segreto client: generalo nella sezione Panoramica del progetto e copialo
    • Payload: copialo dalla sezione Genera JWT

    Configurazione account tecnico Adobe IMS

  4. Conferma con Crea.

  5. La configurazione di Adobe Target verrà visualizzata nella console AEM.

    Configurazione IMS

Conferma della configurazione IMS

Per confermare che la configurazione funziona come previsto:

  1. Apri:

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    Esempio:

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. Seleziona la configurazione.

  3. Seleziona Verifica stato dalla barra degli strumenti, seguita da Verifica.

    Verifica stato

  4. In caso di esito positivo, verrà visualizzato un messaggio di conferma.

Completare l’integrazione con Adobe Target

Adesso puoi utilizzare questa configurazione IMS per completare l’Integrazione con Adobe Target.

In questa pagina