Configura autenticazione per Adobe Target API

Il Adobe Target API di amministrazione, tra cui Recommendations Admin Le API sono protette dall'autenticazione per garantire che solo gli utenti autorizzati possano accedervi Adobe Target. Utilizza il Console Adobe Developer per gestire questa autenticazione per tutti Adobe Experience Cloud solutions, tra cui Adobe Target.

IMPORTANT
Le credenziali dell’account di servizio (JWT) descritte in questo articolo diventeranno obsolete e verranno sostituite dalle nuove credenziali server-to-server OAuth.
Le credenziali dell’account di servizio (JWT) continueranno a funzionare fino al 1° gennaio 2025. È necessario migrare l’applicazione o l’integrazione per utilizzare le nuove credenziali server-to-server OAuth prima del 1° gennaio 2025.
Per ulteriori informazioni e istruzioni dettagliate per la migrazione dell’integrazione, consulta Migrazione dalle credenziali dell’account di servizio (JWT) alle credenziali server-to-server OAuth nel Console per sviluppatori documentazione.
Per informazioni sulla configurazione delle nuove credenziali OAuth, consulta Implementazione delle credenziali server-to-server OAuth nel Console per sviluppatori documentazione.

Di seguito sono riportati i passaggi preliminari necessari per generare i token di autenticazione JWT legacy necessari per interagire correttamente con Adobe Target API:

  1. Creare un progetto (precedentemente denominato integrazione) in Adobe Developer Console.
  2. Esporta dettagli progetto in Postman.
  3. Genera un token di accesso bearer.
  4. Verifica il token di accesso bearer.

Prerequisiti

Risorsa
Dettagli
Postman
Per completare correttamente questi passaggi, scarica il app Postman per il sistema operativo. Postman basic è gratuito con la creazione dell'account. Sebbene non sia necessario per utilizzare Adobe Target API in generale, Postman semplifica i flussi di lavoro API e Adobe Target fornisce diverse raccolte Postman per aiutarti a eseguire le API e a scoprire come funzionano. Il resto di questa guida presuppone una conoscenza operativa di Postman. Per assistenza, consulta Documentazione di Postman.
Riferimenti

Per il resto di questa guida si presume che le risorse seguenti siano familiari:

Creazione di un progetto di Adobe I/O

In questa sezione, potrai accedere al Adobe Developer Console e crea un progetto per Adobe Target. Per ulteriori informazioni, consulta documentazione sui progetti.

<!—(1. Genera la tua chiave privata e il certificato pubblico, in base al documentazione sull’autenticazione. // [//]: # (come descritto in Passaggio 1 di Come impostare Adobe IO: Authentication - procedura dettagliata. Dopo aver completato il passaggio 1, torna a questa guida e riprendi con il passaggio 2, di seguito. // Il risultato di questa fase dovrebbe essere la creazione di un private.key file e un certificate_pub.crt file. Tornate a questa guida dopo aver generato questi due file.)—>

  1. In Adobe Admin Console, assicurati che Adobe l'account utente è stato concesso entrambi Amministratore prodotto e Sviluppatore livello di accesso a Target.

  2. In Console Adobe Developer, seleziona la Organizzazione Experience Cloud per la quale desideri creare questa integrazione. (È probabile che tu abbia accesso a un solo Organizzazione Experience Cloud.)

    configure-io-target-createproject2.png

  3. Clic Crea nuovo progetto.

    configure-io-target-createproject3.png

  4. Clic Aggiungi API per aggiungere un’API REST al progetto per accedere a Adobe servizi e prodotti.

    Aggiungi API

  5. Seleziona Adobe Target come Adobe servizio che desideri integrare con. Fai clic su Successivo che viene visualizzato.

    configure-io-target-createproject5

  6. Seleziona un’opzione per associare le chiavi pubbliche e private all’integrazione dell’account di servizio per cui stai creando l’app Target. Per questo esempio, seleziona Opzione 1: generazione di una coppia di chiavi e fai clic su Genera coppia di chiavi.

    configure-io-target-createproject6

  7. Come da istruzioni, annota il file di configurazione scaricato automaticamente (config), che contiene la tua chiave privata. Fai clic su Successivo.

    configure-io-target-createproject7

  8. Nel file system, verificare la posizione di config, file di configurazione compresso creato nel passaggio precedente. Ancora una volta, questo config Il file contiene la tua chiave privata, che ti servirà in seguito. La posizione esatta all’interno del file system potrebbe essere diversa da quella mostrata qui.

    configure-io-target-createproject8

  9. Nella console Adobe Developer, seleziona la profilo/i di prodotto corrisponde alle proprietà in cui utilizzi Adobe Recommendations. Se non utilizzi le proprietà, seleziona l’opzione Area di lavoro predefinita. Clic Salva API configurata.

    configure-io-target-createproject9

  10. Clic Creare un’integrazione. Dovresti ricevere un messaggio temporaneo che indica che l’API è stata configurata correttamente.

  11. Come passaggio finale, rinomina il progetto in un nome più significativo dell’originale Project 1. A questo scopo, accedi al progetto utilizzando il percorso di navigazione come mostrato, fai clic su Modifica progetto per accedere a Modifica Progetto e rinominare il progetto.

    configure-io-target-createproject11

NOTE
In questo esempio, diamo un nome al nostro progetto "Target Integrazione." Se prevedi di utilizzare il progetto per più di Adobe Target, è possibile denominarlo di conseguenza. Ad esempio, puoi scegliere di denominarla "API Adobe" o "API Experience Cloud", in quanto può essere utilizzata con altre soluzioni in Adobe Experience Cloud.

Esporta dettagli progetto

Ora che hai un progetto di Adobe che puoi utilizzare per accedere a Target, devi assicurarti di inviare i dettagli di quel progetto insieme alle richieste API di Adobe. Questi dettagli sono necessari per interagire con diverse API di Adobe, tra cui diverse Target API. Ad esempio, i dettagli di integrazione includono le informazioni di autorizzazione e autenticazione richieste da Target API di amministrazione. Pertanto, per utilizzare le API con Postman, è necessario inserire tali dettagli in Postman.

Esistono diversi modi per specificare i dettagli del progetto in Postman, ma in questa sezione sfrutta alcune funzioni e raccolte predefinite. Innanzitutto (in questa sezione), esporterai i dettagli dell’integrazione in un ambiente Postman. Nella sezione successiva verrà generato un token di accesso Bearer per consentire l’accesso alle risorse Adobi necessarie.

NOTE
Per istruzioni video applicabili a qualsiasi soluzione di Experience Cloud, tra cui Target, vedi Utilizzare Postman con le API Experienci Platform. Le sezioni seguenti sono rilevanti per Target API: 1. Creazione ed esportazione di Experienci Platform API in Postman 2. Generare un token di accesso con Postman. Questi passaggi sono descritti anche di seguito.
  1. Ancora in Console Adobe Developer, passa a visualizzare i Account di servizio (JWT) credenziali. Utilizza la barra di navigazione a sinistra o Credenziali come mostrato nella.

    JWT1

    In entrata Dettagli delle credenziali, nota: è possibile visualizzare Chiavi pubbliche, ID client e altre informazioni relative al tuo account di servizio.

    JWT1a

  2. Fai clic su per passare alle informazioni su Adobe Target API. Utilizza la barra di navigazione a sinistra o Prodotti e servizi connessi come mostrato nella.

    JWT2

  3. Clic Scarica per Postman > Account di servizio (JWT) per creare un file JSON che acquisisca le informazioni di autenticazione per un ambiente Postman.

    JWT3

    Prendi nota del file JSON nel file system.

    JWT3a

  4. In Postman, fai clic sull’icona a forma di ingranaggio per gestire gli ambienti, quindi fai clic su Importa per importare il file JSON (ambiente).

    JWT4

  5. Scegli il file e fai clic su Apri.

    JWT5

  6. In Postman Gestisci ambienti , fai clic sul nome dell’ambiente appena importato per esaminarlo. (Il nome dell’ambiente potrebbe essere diverso da quello mostrato qui. Modifica il nome come desiderato. Non deve necessariamente corrispondere al nome del Adobe project.)

    JWT6

  7. Nota CLIENT_SECRET e API_KEY (insieme ad altre variabili) hanno i loro valori precompilati, tratti dall'integrazione come definita nella console Adobe Developer. (Postman CLIENT_SECRET deve corrispondere al valore CLIENT SECRET credenziali di Adobe visualizzate in Console sviluppatori e API_KEY in Postman deve corrispondere CLIENT ID nella Console per sviluppatori.) Al contrario, nota PRIVATE_KEY, JWT_TOKEN, e ACCESS_TOKEN sono vuoti. Iniziamo fornendo il PRIVATE_KEY valore.

    JWT7

  8. Dal file system, apri config e aprire il file private file di chiave.

    JWT8

  9. Seleziona e copia l’intero contenuto del private file di chiave.

    JWT9

  10. In Postman, incolla il valore della chiave privata nel VALORE INIZIALE e VALORE CORRENTE campi.

    JWT10

  11. Clic Aggiorna e chiudi la finestra modale Ambienti.

Genera il token di accesso bearer

In questa sezione viene generato il token di accesso bearer, necessario per autenticare l’interazione con Adobe Target API. Per generare il token di accesso bearer, devi inviare i dettagli dell’integrazione (stabiliti nelle sezioni precedenti) a Servizio Identity Management di Adobe (IMS). Esistono alcuni modi diversi per farlo, ma in questa guida utilizziamo una raccolta Postman contenente una chiamata IMS predefinita che rende il processo diretto e semplice. Dopo aver importato la raccolta, puoi riutilizzarla quando necessario, per generare nuovi token non solo per Adobe Target, ma anche altre API di Adobe.

  1. Accedi a Adobe di chiamate di esempio per l’API dei servizi Identity Management.

    token1

  2. Fai clic su Adobe I/O di raccolta Postman per la generazione di token di accesso.

    token2

  3. Ottieni il JSON non elaborato per questa raccolta facendo clic su Raw, quindi copiando il JSON risultante negli Appunti. In alternativa, puoi salvare il file JSON non elaborato come file .json.

    token3

  4. In Postman, importa la raccolta incollando e inviando il JSON non elaborato dagli Appunti. In alternativa, puoi caricare il file .json salvato. Fate clic su Continue (Continua).

    token4

  5. Seleziona la IMS: JWT Generate + Auth tramite token utente nell’insieme Postman per la generazione di token di accesso Adobe I/O, assicurati che l’ambiente sia selezionato e fai clic su Invia per generare il token.

    token5

    note note
    NOTE
    Questo token di accesso al bearer sarà valido per 24 ore. Invia nuovamente la richiesta ogni volta che devi generare un nuovo token.
  6. Apri nuovamente la finestra modale Manage Environments (Gestisci ambienti) e seleziona l’ambiente.

    token6

  7. Osserva ACCESS_TOKEN e JWT_TOKEN I valori ora sono compilati.

    token7

Domanda: devo utilizzare la raccolta Postman di generazione del token di accesso Adobe I/O per generare il token web JSON (JWT) e il token di accesso bearer?

Risposta: No. L’insieme Postman Adobe I/O Access Token Generation è disponibile per semplificare la generazione del token di accesso JWT e bearer in Postman. In alternativa, puoi utilizzare le funzionalità all’interno della console Adobe Developer per generare manualmente il token di accesso bearer.

Verifica il token di accesso bearer

In questo esercizio, utilizzerai il nuovo token di accesso bearer inviando una richiesta API che recupera un elenco di attività dal tuo Target account. Una risposta corretta indica che Adobe Il progetto e l’autenticazione funzionano come previsto per utilizzare l’API.

  1. Importa Adobe Target Raccolta Postman di API amministratore. Segui tutti i prompt finché la raccolta non viene importata in Postman.

    testtoken1

  2. Espandi la raccolta e prendi nota della Elencare attività richiesta.

    testtoken1

  3. Tieni presente che le variabili come {{access_token}} sono inizialmente non risolti. Puoi risolvere questo problema in diversi modi, ad esempio definendo una nuova variabile di raccolta denominata {{access_token}}— In questa guida, modificherai invece la richiesta API per sfruttare l’ambiente Postman che utilizzavi in precedenza. Questo consentirà all’ambiente di continuare a fungere da consolidamento unico e coerente di tutte le variabili comuni tra le API Adobe.

    testtoken2

  4. Digita per sostituire {{access_token}} con {{ACCESS_TOKEN}}.

    testtoken3

  5. Digita per sostituire {{api_key}} con {{API_KEY}}.

    testtoken4

  6. Digita per sostituire {{tenant}} con {{TENANT_ID}}. Nota {{TENANT_ID}} non è ancora stato riconosciuto.

    testtoken4

  7. Apri la finestra modale Manage Environments (Gestisci ambienti) e seleziona l’ambiente.

    JWT11

  8. Digita per aggiungere una nuova {{TENANT_ID}} variabile di ambiente. Copia e incolla il valore ID tenant in VALORE INIZIALE e VALORE CORRENTE campi per il nuovo TENANT_ID variabile di ambiente.

    testtoken5

    note note
    NOTE
    L’ID tenant è diverso dal tuo Target clientcode. L’ID tenant esiste nell’URL al momento dell’accesso a Target. Per ottenere l’ID tenant, accedi a Adobe Experience Cloud, apri Targete fai clic sulla scheda Target. Utilizza il valore ID tenant indicato nel sottodominio URL. Ad esempio, se l’URL di è stato registrato in Adobe Target è <https://mycompany.experiencecloud.adobe.com/...> quindi il tuo ID tenant è "mia azienda".
  9. Invia la richiesta, dopo aver verificato di aver selezionato l’ambiente corretto. Dovresti ricevere una risposta contenente l’elenco delle attività.

    testtoken6

Dopo aver verificato l’autenticazione Adobe, puoi utilizzarla per interagire con Adobe Target API di (nonché altre API di Adobe). Ad esempio, puoi Utilizzare le API di Recommendations per creare o gestire i consigli, oppure puoi utilizzarli con API di consegna di Target.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3