Come impostare l’accesso API dell’AAM
Scopri come creare un progetto nella console per sviluppatori per generare credenziali JWT API Audience Manager.
Descrizione description
Ambiente
Adobe Audience Manager
Problema/Sintomi
Come impostare e generare le credenziali per l’API Audience Manager?
Risoluzione resolution
Per generare le credenziali per l’API Audience Manager, nell’Admin Console sono necessarie le autorizzazioni di amministratore di sistema. I passaggi 1 e 2 descrivono come concedere queste autorizzazioni inoltrate a un livello superiore. Gli amministratori di sistema attuali preferiscono seguire questi passaggi piuttosto che concedere autorizzazioni di amministrazione inoltrate a un altro utente, in tal caso passano direttamente al passaggio 3.
- Passare all'Admin Console e selezionare "Aggiungi amministratori" dal menu "Collegamenti rapidi":
- Immetti le e-mail per tutti gli utenti a cui desideri concedere l’accesso. Nella pagina successiva, selezionare "Amministratore di sistema" per il livello di autorizzazione:
- Passa a https://developer.adobe.com/console . Se non disponi ancora dell’accesso nonostante ti siano stati concessi i diritti di amministratore di sistema nei passaggi precedenti, prova ad aggiornare i cookie/cache.
- Crea un nuovo progetto dal menu di avvio rapido (o dal menu Progetti nella navigazione superiore):
- Aggiungi l'API Audience Manager al progetto:
- Segui i passaggi per generare (o caricare) le credenziali JWT. Se scegli di generare le credenziali tramite la console di sviluppo, assicurati di memorizzare in modo sicuro la chiave privata. La chiave privata sarà necessaria nei passaggi successivi.
- Successivamente, ti verrà richiesto di assegnare le credenziali ai profili di prodotto rilevanti. Se l'organizzazione utilizza controlli di accesso basati sui ruoli, è necessario seguire questi passaggi per creare un account utente tecnico e aggiungere tale account al gruppo RBAC pertinente: https://experienceleague.adobe.com/docs/audience-manager/user-guide/api-and-sdk-code/rest-apis/aam-api-getting-started.html?lang=it#technical-account-rbac-permissions
- Una volta completati questi passaggi, puoi generare un token di accesso per effettuare la prima richiesta API. Innanzitutto, fai clic su nella pagina di panoramica delle credenziali nella console di sviluppo:
- Fare clic sulla scheda "Genera JWT" nella parte superiore della pagina e incollare l'intera chiave privata dal file scaricato al passaggio 6, quindi fare clic su "Genera token":
Infine, puoi effettuare richieste API utilizzando il token di accesso recuperato nel passaggio precedente. Le chiamate possono essere effettuate da qualsiasi piattaforma API, ad esempio Postman, direttamente tramite i comandi cURL o anche dalla pagina della documentazione API: https://bank.demdex.com/portal/swagger/index.html#/
Per effettuare chiamate utilizzando le funzioni demo nella nostra documentazione, segui i passaggi precedenti per generare il token, quindi fai clic su "Autorizza" sul lato destro della pagina e inserisci il token:
Accertati inoltre di selezionare il server aam.adobe.io, come indicato nella schermata precedente. Ora puoi utilizzare la funzione demo su qualsiasi richiesta API, inserendo i parametri rilevanti e facendo clic sul pulsante "Prova":
Tieni presente che questo invierà una vera richiesta API alla tua istanza. Se utilizzi una richiesta DELETE, PUT o POST, potresti apportare modifiche non desiderate all’istanza. Prima di inviare la richiesta, leggi sempre attentamente la documentazione di ciascuna di queste chiamate API.