Konfigurera autentisering för Adobe Target API:er
The Adobe Target Admin-API:er, inklusive Recommendations Admin API:er, skyddas av autentisering för att säkerställa att endast behöriga användare använder dem för åtkomst Adobe Target. Använd Adobe Developer Console för att hantera denna autentisering för alla Adobe Experience Cloud solutions, inklusive Adobe Target.
Här följer de inledande stegen som krävs för att generera de äldre JWT-autentiseringstoken som behövs för att kunna interagera med Adobe Target API:
- Skapa ett projekt (som tidigare kallades integration) i Adobe Developer Console.
- Exportera projektinformation till Postman.
- Generera en token för innehavaråtkomst.
- Testa token för innehavaråtkomst.
Krav
Du bör känna till följande resurser under resten av den här guiden:
Skapa ett Adobe I/O-projekt
I det här avsnittet kommer du åt Adobe Developer Console och skapa ett projekt för Adobe Target. Mer information finns i dokumentation om projekt.
<!—(1. Generera din privata nyckel och ditt offentliga certifikat, enligt dokumentation om autentisering. // [//]: # (enligt beskrivning i Steg 1 av Så här konfigurerar du Adobe IO: Autentisering - Steg för steg. När du är klar med steg 1 går du tillbaka till den här guiden och fortsätter med steg 2 nedan. // Resultatet av det här steget bör vara att en private.key
och en certificate_pub.crt
-fil. Återgå till den här guiden när du har skapat de här två filerna.)—>
-
I Adobe Admin Console, kontrollera att Adobe användarkontot har tilldelats båda Produktadministratör och Utvecklare behörighet till Target.
-
I Adobe Developer Consoleväljer du Experience Cloud Organization som du vill skapa den här integreringen för. (Observera att du antagligen bara har tillgång till en enda Experience Cloud Organization.)
-
Klicka på Create new project.
-
Klicka Add API för att lägga till ett REST API i ditt projekt för att få åtkomst Adobe tjänster och produkter.
-
Välj Adobe Target som Adobe tjänster som du vill integrera med. Klicka på Next som visas.
-
Välj ett alternativ för att associera offentliga och privata nycklar med tjänstkontointegreringen som du skapar för Target. I detta exempel väljer du Option 1: Generate a key pair och klicka Generate keypair.
-
Anteckna den automatiskt hämtade konfigurationsfilen (
config
), som innehåller din privata nyckel. Klicka på Next. -
Kontrollera var i filsystemet
config
, som är den komprimerade konfigurationsfilen som skapades i föregående steg. Igen, den härconfig
filen innehåller din privata nyckel, som du behöver senare. Den exakta platsen i filsystemet kan skilja sig från den som visas här. -
Gå tillbaka till Adobe Developer Console och välj produktprofil(er) motsvarar de egenskaper som du använder Adobe Recommendations i. (Om du inte använder egenskaper markerar du alternativet Standardarbetsyta.) Klicka på Save configured API.
-
Klicka på Create Integration. Du bör få ett tillfälligt meddelande om att ditt API har konfigurerats.
-
Som ett sista steg byter du namn på projektet till ett namn som är mer meningsfullt än det ursprungliga
Project 1
. Det gör du genom att navigera till projektet med navigeringssökvägen som visas och klicka på Edit project för att komma åt Edit Project modal och ge projektet ett nytt namn.
Exportera projektinformation
Nu när du har ett Adobe-projekt som du kan använda för att komma åt Targetmåste du se till att du skickar information om det projektet tillsammans med dina Adobe API-begäranden. Dessa uppgifter krävs för att interagera med flera Adobe-API:er, inklusive flera Target API. Integreringsinformationen innehåller till exempel information om autentisering och autentisering som krävs av Target Admin-API:er. Om du vill använda API:erna med Postman måste du därför hämta dessa uppgifter till Postman.
Det finns många sätt att ange projektinformation i Postman, men i det här avsnittet kan vi utnyttja vissa färdiga funktioner och samlingar. Först (i det här avsnittet) exporteras information om din integrering till en Postman-miljö. Därefter (i följande avsnitt) genererar du en token för innehavaråtkomst som ger dig tillgång till de nödvändiga Adobe-resurserna.
-
Fortfarande i Adobe Developer Consolenavigera till det nya projektets Service Account (JWT) autentiseringsuppgifter. Använd antingen den vänstra navigeringen eller Credentials som visas.
I Credential details kan du se Public key(s), Client ID och annan information om ditt tjänstkonto.
-
Klicka för att navigera till information om Adobe Target API. Använd antingen den vänstra navigeringen eller Anslutna produkter och tjänster som visas.
-
Klicka Download for Postman > Service Account (JWT) för att skapa en JSON-fil som hämtar din autentiseringsinformation för en Postman-miljö.
Observera JSON-filen i filsystemet.
-
I Postman klickar du på kugghjulsikonen för att hantera dina miljöer och sedan på Import för att importera JSON-filen (miljö).
-
Välj filen och klicka på Open.
-
I POSTMAN Hantera miljöer modal klickar du på namnet på den nyligen importerade miljön för att inspektera den. (Ditt miljönamn kan skilja sig från det som visas här. Redigera namnet efter behov. Det behöver inte nödvändigtvis matcha namnet på Adobe projekt.)
-
Anteckning
CLIENT_SECRET
ochAPI_KEY
(tillsammans med andra variabler) har sina värden ifyllda i förväg, som hämtats från integreringen enligt definitionen i Adobe Developer Console. (PostmanCLIENT_SECRET
variabeln ska matchaCLIENT SECRET
autentiseringsuppgifter för Adobe som de visas i Developer Console, ochAPI_KEY
i Postman bör likaså matchaCLIENT ID
i Developer Console.) ObserveraPRIVATE_KEY
,JWT_TOKEN
ochACCESS_TOKEN
är tomma. Vi börjar med att erbjudaPRIVATE_KEY
värde. -
Öppna ditt filsystem
config
och öppnaprivate
nyckelfil. -
Markera och kopiera hela innehållet i
private
nyckelfil. -
I Postman klistrar du in ditt privata nyckelvärde i INITIAL VALUE och CURRENT VALUE fält.
-
Klicka Update och stänger Miljöerna modal.
Generera token för innehavaråtkomst
I det här avsnittet skapar du en token för innehavaråtkomst som krävs för att autentisera din interaktion med Adobe Target API. Om du vill generera en token för innehavaråtkomst måste du skicka din integreringsinformation (som anges i de föregående avsnitten) till Adobe Identity Management Service (IMS). Det finns några olika sätt att göra detta, men i den här guiden drar vi nytta av en Postman-samling som innehåller ett färdigbyggt IMS-anrop som gör processen direkt och enkel. När du har importerat samlingen kan du återanvända den när det behövs för att generera nya tokens inte bara för Adobe Target, men även andra Adobe-API:er.
-
Navigera till Adobe Identity Management Service API-exempelanrop.
-
Klicka på Adobe I/O Access Token Generation Postman collection.
-
Hämta rå-JSON för den här samlingen genom att klicka Raw och sedan kopiera den resulterande JSON-filen till Urklipp. (Du kan också spara raw-JSON som en .json-fil.)
-
I Postman importerar du samlingen genom att klistra in och skicka rå JSON från Urklipp. (Du kan också överföra den .json-fil som du sparade.) Klicka på Continue.
-
Välj IMS: JWT Generate + Auth via User Token begär Postman-samlingen för generering av Adobe I/O Access-token, kontrollera att din miljö är markerad och klicka sedan på Send för att generera token.
note note NOTE Denna innehavaråtkomsttoken gäller i 24 timmar. Skicka begäran igen när du behöver generera en ny token. -
Öppna Hantera miljöer modal igen och välj din miljö.
-
Anteckna
ACCESS_TOKEN
ochJWT_TOKEN
värden har nu fyllts i.
Fråga: Måste jag använda Postman-samlingen Adobe I/O Access Token Generation för att generera JSON Web Token (JWT) och innehavaråtkomsttoken?
Svar: Nej. Adobe I/O Access Token Generation Postman-samlingen är tillgänglig som ett bekvämt sätt att enklare generera JWT- och Bearer-åtkomsttoken i Postman. Du kan också använda funktionerna i Adobe Developer Console för att manuellt generera en token för innehavaråtkomst.
Testa innehavaråtkomsttoken
I den här övningen använder du din nya innehavaråtkomsttoken genom att skicka en API-begäran som hämtar en lista över aktiviteter från din Target konto. Ett lyckat svar indikerar att Adobe projekt och autentisering fungerar som förväntat för att API:t ska kunna användas.
-
Importera Adobe Target Admin-API:er för Postman Collection. Följ alla instruktioner tills samlingen har importerats till Postman.
-
Expandera samlingen och notera List activities begäran.
-
Observera att variabler som
{{access_token}}
är från början olösta. Du kan lösa detta på flera olika sätt - du kan till exempel definiera en ny samlingsvariabel som kallas{{access_token}}
- men i den här handboken ändrar du i stället API-begäran så att du kan utnyttja den Postman-miljö du använde tidigare. På så sätt kan miljön fortsätta att fungera som en enda, konsekvent konsolidering av alla variabler som är gemensamma för olika API:er i Adobe. -
Text som ska ersättas
{{access_token}}
med{{ACCESS_TOKEN}}
. -
Text som ska ersättas
{{api_key}}
med{{API_KEY}}
. -
Text som ska ersättas
{{tenant}}
med{{TENANT_ID}}
. Anteckning{{TENANT_ID}}
känns inte igen än. -
Öppna modal Hantera miljöer och välj din miljö.
-
Skriv för att lägga till en ny
{{TENANT_ID}}
miljövariabel. Kopiera och klistra in värdet för ditt klient-ID i INITIAL VALUE och CURRENT VALUE fält för dina nyaTENANT_ID
miljövariabel.note note NOTE Klient-ID:t skiljer sig från din Target clientcode
. Klient-ID:t finns i URL:en när du är inloggad på Target. Logga in på Adobe Experience Cloud och öppna för att få ditt klient-ID Targetoch klicka på Target-kortet. Använd det klient-ID som anges i URL-underdomänen. Om din URL-adress till exempel är inloggad på Adobe Target är<https://mycompany.experiencecloud.adobe.com/...>
blir ditt klient-ID"mincompany". -
Skicka din begäran efter att du har valt rätt miljö. Du bör få ett svar med din lista över aktiviteter.
Nu när du har verifierat din autentisering från Adobe kan du använda den för att interagera med Adobe Target API:er (och andra Adobe-API:er). Du kan till exempel Använda Recommendations API:er för att skapa eller hantera rekommendationer, eller så kan du använda dem med Målleverans-API.