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.

IMPORTANT
De JWT-autentiseringsuppgifter (Service Account) som beskrivs i den här artikeln kommer att bli inaktuella till förmån för de nya OAuth Server-till-Server-autentiseringsuppgifterna.
JWT-inloggningsuppgifterna (Service Account) kommer att fortsätta att fungera fram till 1 januari 2025. Du måste migrera programmet eller integreringen för att kunna använda de nya autentiseringsuppgifterna för OAuth Server-till-server före 1 januari 2025.
Mer information och stegvisa instruktioner för att migrera din integrering finns i Migrerar från JWT-autentiseringsuppgifter (Service Account) till OAuth Server-till-Server-autentiseringsuppgifter i Developer Console dokumentation.
Mer information om hur du konfigurerar nya OAuth-autentiseringsuppgifter finns i Autentiseringsimplementering av OAuth Server-till-Server i Developer Console dokumentation.

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:

  1. Skapa ett projekt (som tidigare kallades integration) i Adobe Developer Console.
  2. Exportera projektinformation till Postman.
  3. Generera en token för innehavaråtkomst.
  4. Testa token för innehavaråtkomst.

Krav

Resurs
Information
Postman
Om du vill slutföra de här stegen måste du skaffa Postman för ditt operativsystem. Postman Basic är kostnadsfritt när man skapar konto. Krävs inte för att använda Adobe Target API:er i allmänhet gör Postman API-arbetsflöden enklare och Adobe Target innehåller flera Postman-samlingar som hjälper dig att köra API:erna och lära dig hur de fungerar. Resten av guiden förutsätter att man har kunskap om Postman. Om du behöver hjälp kan du läsa Postman-dokumentation.
Referenser

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.)—>

  1. I Adobe Admin Console, kontrollera att Adobe användarkontot har tilldelats båda Produktadministratör och Utvecklare behörighet till Target.

  2. 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.)

    configure-io-target-create-project2.png

  3. Klicka på Create new project.

    configure-io-target-create-project3.png

  4. 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.

    Lägg till API

  5. Välj Adobe Target som Adobe tjänster som du vill integrera med. Klicka på Next som visas.

    configure-io-target-createproject5

  6. 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.

    configure-io-target-createproject6

  7. Anteckna den automatiskt hämtade konfigurationsfilen (config), som innehåller din privata nyckel. Klicka på Next.

    configure-io-target-createproject7

  8. Kontrollera var i filsystemet config, som är den komprimerade konfigurationsfilen som skapades i föregående steg. Igen, den här config 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.

    configure-io-target-createproject8

  9. 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.

    configure-io-target-createproject9

  10. Klicka på Create Integration. Du bör få ett tillfälligt meddelande om att ditt API har konfigurerats.

  11. 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.

    configure-io-target-createproject11

NOTE
I det här exemplet kallar vi vårt projekt "Target Integrering." Om du tänker använda ditt projekt för mer än bara Adobe Targetkan du ge den ett namn. Du kan till exempel välja att ge den namnet"Adobe API:er" eller"Experience Cloud API:er", eftersom den kan användas med andra lösningar i Adobe Experience Cloud.

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.

NOTE
För videoinstruktioner för alla Experience Cloud-lösningar, inklusive Target, se Använd Postman med Experience Platform API:er. Följande avsnitt gäller Target API: 1. Skapa och exportera Experience Platform API till Postman 2. Generera en åtkomsttoken med Postman. De här stegen finns också nedan.
  1. Fortfarande i Adobe Developer Consolenavigera till det nya projektets Service Account (JWT) autentiseringsuppgifter. Använd antingen den vänstra navigeringen eller Credentials som visas.

    JWT1

    I Credential details kan du se Public key(s), Client ID och annan information om ditt tjänstkonto.

    JWT1a

  2. 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.

    JWT2

  3. Klicka Download for Postman > Service Account (JWT) för att skapa en JSON-fil som hämtar din autentiseringsinformation för en Postman-miljö.

    JWT3

    Observera JSON-filen i filsystemet.

    JWT3a

  4. I Postman klickar du på kugghjulsikonen för att hantera dina miljöer och sedan på Import för att importera JSON-filen (miljö).

    JWT4

  5. Välj filen och klicka på Open.

    JWT5

  6. 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.)

    JWT6

  7. Anteckning CLIENT_SECRET och API_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. (Postman CLIENT_SECRET variabeln ska matcha CLIENT SECRET autentiseringsuppgifter för Adobe som de visas i Developer Console, och API_KEY i Postman bör likaså matcha CLIENT ID i Developer Console.) Observera PRIVATE_KEY, JWT_TOKENoch ACCESS_TOKEN är tomma. Vi börjar med att erbjuda PRIVATE_KEY värde.

    JWT7

  8. Öppna ditt filsystem config och öppna private nyckelfil.

    JWT8

  9. Markera och kopiera hela innehållet i private nyckelfil.

    JWT9

  10. I Postman klistrar du in ditt privata nyckelvärde i INITIAL VALUE och CURRENT VALUE fält.

    JWT10

  11. 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.

  1. Navigera till Adobe Identity Management Service API-exempelanrop.

    token1

  2. Klicka på Adobe I/O Access Token Generation Postman collection.

    token2

  3. 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.)

    token3

  4. 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.

    token4

  5. 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.

    token5

    note note
    NOTE
    Denna innehavaråtkomsttoken gäller i 24 timmar. Skicka begäran igen när du behöver generera en ny token.
  6. Öppna Hantera miljöer modal igen och välj din miljö.

    token6

  7. Anteckna ACCESS_TOKEN och JWT_TOKEN värden har nu fyllts i.

    token7

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.

  1. Importera Adobe Target Admin-API:er för Postman Collection. Följ alla instruktioner tills samlingen har importerats till Postman.

    testtoken1

  2. Expandera samlingen och notera List activities begäran.

    testtoken1

  3. 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.

    testtoken2

  4. Text som ska ersättas {{access_token}} med {{ACCESS_TOKEN}}.

    testtoken3

  5. Text som ska ersättas {{api_key}} med {{API_KEY}}.

    testtoken4

  6. Text som ska ersättas {{tenant}} med {{TENANT_ID}}. Anteckning {{TENANT_ID}} känns inte igen än.

    testtoken4

  7. Öppna modal Hantera miljöer och välj din miljö.

    JWT11

  8. 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 nya TENANT_ID miljövariabel.

    testtoken5

    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".
  9. Skicka din begäran efter att du har valt rätt miljö. Du bör få ett svar med din lista över aktiviteter.

    testtoken6

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.

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