Configurazione di Adobe I/O per i trigger Adobe Experience Cloud

ATTENZIONE

Se utilizzi una versione precedente dell'integrazione Triggers tramite autenticazione oAuth, devi passare all'Adobe I/O come descritto di seguito.
Durante questo passaggio a Adobe I/O, alcuni trigger in arrivo potrebbero andare persi.

La modalità di autenticazione oAuth legacy con Campaign è stata ritirata il 18 agosto 2021. Gli ambienti ospitati beneficiano di un’estensione fino al 30 novembre 2021. In qualità di cliente on-premise o ibrido, contatta l’Assistenza clienti Adobe per estendere il supporto fino al 30 novembre 2021. Devi fornire ad Adobe l’AppID dell’applicazione OAuth .

Prerequisiti

Questa integrazione si applica solo a partire dalle versioni Campaign Classic 20.2.4 e successive, 19.1.8 e Gold Standard 11.

Prima di avviare questa implementazione, controlla di avere:

  • un identificatore organizzazione valido: l’identificatore dell’organizzazione IMS (Identity Management System) è l’identificatore univoco all’interno di Adobe Experience Cloud, utilizzato ad esempio per il servizio VisitorID e per l’accesso singolo IMS (SSO). Ulteriori informazioni
  • a Accesso sviluppatore alla tua organizzazione. L’amministratore di sistema dell’organizzazione IMS deve seguire la procedura Aggiungi sviluppatori a un singolo profilo di prodotto dettagliata in questa pagina per fornire agli sviluppatori l’accesso per il profilo di prodotto Analytics - {tenantID} del prodotto Adobe Analytics associato ai trigger.

Passaggio 1: Crea/aggiorna progetto di Adobe I/O

  1. Accedi a Adobe I/O e accedi con l’accesso per sviluppatori dell’organizzazione IMS.

    NOTA

    Assicurati di aver effettuato l'accesso al portale organizzazione corretto.

  2. Estrai l'identificatore client esistente (ID client) dal file di configurazione dell'istanza ims/authIMSTAClientId. L'attributo non esistente o vuoto indica che l'identificatore client non è configurato.

    NOTA

    Se l'identificatore client è vuoto, puoi direttamente Create a New project in Adobe I/O.

  3. Identifica il progetto esistente utilizzando l’identificatore client estratto. Cerca progetti esistenti con lo stesso ID client di quello estratto nel passaggio precedente.

  4. Seleziona + Add to Project e scegli API.

  5. Nella finestra Add an API, selezionare Adobe Analytics.

  6. Scegli Service Account (JWT) come tipo di autenticazione.

  7. Se l’ID client era vuoto, selezionare Generate a key pair per creare una coppia di chiavi pubblica e privata.

    Le chiavi vengono quindi scaricate automaticamente con una data di scadenza predefinita di 365 giorni. Una volta scaduta, dovrai creare una nuova coppia di chiavi e aggiornare l’integrazione nel file di configurazione. Utilizzando l'opzione 2, puoi scegliere di creare e caricare manualmente il Public key con una data di scadenza più lunga.

    ATTENZIONE

    È necessario salvare il file config.zip quando viene visualizzato il prompt di download, poiché non sarà più possibile scaricarlo di nuovo.

  8. Fai clic su Next.

  9. Scegli un Product profile esistente o creane uno nuovo, se necessario. Non è richiesta alcuna autorizzazione per questo Product profile. Per ulteriori informazioni su Analytics Product Profiles, consulta la documentazione di Adobe Analytics.

    Quindi, fai clic su Save configured API.

  10. Dal progetto, seleziona Adobe Analytics e copia le seguenti informazioni in Service Account (JWT):

    • Client ID
    • Client Secret
    • Technical account ID
    • Organization ID

ATTENZIONE

Il certificato di Adobe I/O scade dopo 12 mesi. Devi generare una nuova coppia di chiavi ogni anno.

Passaggio 2: Aggiungere le credenziali del progetto in Adobe Campaign

NOTA

Questo passaggio non è necessario se l'identificatore client non è vuoto nel passaggio 1: Crea/aggiorna progetto Adobe I/O.

La chiave privata deve essere codificata in formato UTF-8 base64. Per eseguire questa operazione:

  1. Utilizza la chiave privata generata nel Passaggio 1: Crea/aggiorna la sezione Progetto Adobe I/O. La chiave privata deve essere la stessa utilizzata per creare l’integrazione.

  2. Codifica la chiave privata utilizzando il seguente comando: base64 ./private.key > private.key.base64. In questo modo il contenuto base64 verrà salvato in un nuovo file private.key.base64.

    NOTA

    Talvolta è possibile aggiungere automaticamente righe extra quando si copia/incolla la chiave privata. Ricorda di rimuoverlo prima di codificare la chiave privata.

  3. Copia il contenuto dal file private.key.base64.

  4. Accedi tramite SSH a ciascun contenitore in cui è installata l’istanza Adobe Campaign e aggiungi le credenziali Progetto in Adobe Campaign eseguendo il seguente comando come utente neolane. Questo inserirà le credenziali Technical Account nel file di configurazione dell'istanza.

    nlserver config -instance:<instance name> -setimsjwtauth:Organization_Id/Client_Id/Technical_Account_ID/<Client_Secret>/<Base64_encoded_Private_Key>
    

Passaggio 3: Aggiorna tag pipeline

NOTA

Questo passaggio non è necessario se l'identificatore client non è vuoto nel passaggio 1: Crea/aggiorna progetto Adobe I/O.

Per aggiornare il tag pipelined, è necessario aggiornare il tipo di autenticazione al progetto di Adobe I/O nel file di configurazione config-< instance-name >.xml come segue:

<pipelined ... authType="imsJwtToken"  ... />

Quindi, esegui un config -reload e un riavvio del pipelined per tenere conto delle modifiche.

In questa pagina