v7
Applicabile solo a Campaign Classic v7

Configurazione di Adobe I/O per i trigger Adobe Experience Cloud configuring-adobe-io

CAUTION
Se utilizzi una versione precedente dell’integrazione Triggers tramite autenticazione oAuth, devi passare ad Adobe I/O come descritto di seguito.
Tieni presente che durante questo spostamento a Adobe I/O, alcuni trigger in arrivo potrebbero andare persi.
La modalità di autenticazione OAuth legacy con Campaign è stata ritirata il 20 ottobre 2021. Gli ambienti in hosting usufruiscono di un’estensione fino al 25 maggio 2022. Se sei un cliente on-premise o ibrido, contatta l’Assistenza clienti Adobe per estendere il supporto a Maggio 2022. Devi fornire l’AppID dell’applicazione OAuth all'Adobe.

Prerequisiti adobe-io-prerequisites

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

Prima di iniziare questa implementazione, verifica di disporre di:

  • un valore valido Identificatore organizzazione: l’ID organizzazione è l’identificatore univoco all’interno di Adobe Experience Cloud, utilizzato ad esempio per il servizio VisitorID e l’accesso Single Sign-On (SSO) di IMS. Ulteriori informazioni
  • a Accesso per sviluppatori alla tua organizzazione. L’amministratore di sistema dell’organizzazione deve seguire la procedura Aggiungere sviluppatori a un singolo profilo di prodotto procedura dettagliata in questa pagina per fornire agli sviluppatori l'accesso per Analytics - {tenantID} Profilo prodotto del prodotto Adobe Analytics associato a Triggers.

Passaggio 1: creare/aggiornare un progetto di Adobe I/O creating-adobe-io-project

AVAILABILITY
Il codice JWT (JSON Web Tokens) è attualmente in fase di ammortamento e viene sostituito con OAuth. La transizione viene eseguita progressivamente nelle prossime versioni di Campaign e la documentazione verrà aggiornata per riflettere tali aggiornamenti.
  1. Accesso Adobe I/O e accedi con l’accesso per sviluppatori della tua organizzazione. Assicurarsi di aver effettuato l'accesso al portale dell'organizzazione corretto.

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

    note note
    NOTE
    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 i progetti esistenti con lo stesso identificatore client di quello estratto nel passaggio precedente.

  4. Seleziona + Add to Project e scegli API.

  5. In Add an API finestra, seleziona Adobe Analytics.

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

  7. Se l'ID client è vuoto, seleziona Generate a key pair per creare una coppia di chiavi pubblica e privata.

    Le chiavi verranno 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 Public key con una data di scadenza più lunga.

    Per una guida dettagliata su come sostituire le coppie di chiavi di certificato in scadenza, consulta questa pagina.

    note caution
    CAUTION
    È consigliabile salvare il file config.zip quando viene visualizzato il prompt di download, in quanto non sarà più possibile scaricarlo.

  8. Fai clic su Next.

  9. Scegli un elemento esistente Product profile o creane uno nuovo, se necessario. Non è richiesta alcuna autorizzazione per questo Product profile. Per ulteriori informazioni su Analytics Product Profiles, fare riferimento a 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

CAUTION
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 add-credentials-campaign

NOTE
Questo passaggio non è necessario se l’identificatore client non è vuoto in Passaggio 1: creare/aggiornare un progetto di Adobe I/O.

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

  1. Utilizza la chiave privata generata in Passaggio 1: creare/aggiornare la sezione Progetto di Adobe I/O. La chiave privata deve essere la stessa di quella utilizzata per creare l’integrazione.

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

    note note
    NOTE
    Talvolta è possibile aggiungere automaticamente righe supplementari quando si copia/incolla la chiave privata. Ricordati di rimuoverlo prima di codificare la chiave privata.
  3. Copia il contenuto dal file private.key.base64.

  4. Accedi tramite SSH a ogni contenitore in cui è installata l’istanza di Adobe Campaign e aggiungi le credenziali del progetto in Adobe Campaign eseguendo il seguente comando come neolane utente. Verrà inserito il Technical Account credenziali nel file di configurazione dell’istanza.

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

Passaggio 3: aggiornare il tag pipeline update-pipelined-tag

NOTE
Questo passaggio non è necessario se l’identificatore client non è vuoto in Passaggio 1: creare/aggiornare un progetto di Adobe I/O.

Da aggiornare pipelined , devi aggiornare il tipo di autenticazione a progetto Adobe I/O nel file di configurazione config-< nome-istanza >.xml come segue:

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

Quindi, esegui una config -reload e il riavvio del pipelined affinché le modifiche siano prese in considerazione.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1