Come impostare l’accesso API dell’AAM
Questo articolo illustra come creare un progetto nella console per sviluppatori per generare credenziali JWT API Audienci Manager.
Descrizione description
Ambiente
Adobe Audience Manager
Problema/Sintomi
Come impostare e generare le credenziali per l’API Audienci Manager?
Risoluzione resolution
Per generare le credenziali per l’API Audienci 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.
- Accedi a Admin Console , quindi 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:
- Accedi 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 Audienci 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 la tua organizzazione utilizza controlli dell’accesso basati sui ruoli, dovrai 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=en#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:
- Fai clic sulla scheda "Generate JWT" (Genera JWT) nella parte superiore della pagina e incolla l’intera chiave privata dal file scaricato al passaggio 6, quindi fai clic su "Generate Token" (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 persino dalla nostra pagina di 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.