Verificatie configureren voor Adobe Target API's

De Adobe Target Admin API's, inclusief Recommendations Admin API's, worden beveiligd door verificatie zodat alleen geautoriseerde gebruikers toegang hebben tot Adobe Target. Gebruik de Adobe Developer Console deze verificatie voor iedereen beheren Adobe Experience Cloud solutions, inclusief Adobe Target.

IMPORTANT
De geloofsbrieven van de Rekening van de Dienst (JWT) die in dit artikel worden beschreven zullen ten gunste van de nieuwe geloofsbrieven van Server-aan-Server OAuth worden afgekeurd.
De aanmeldingsgegevens voor de serviceaccount (JWT) blijven geldig tot 1 januari 2025. U moet uw toepassing of integratie migreren om de nieuwe server-aan-server referentie OAuth vóór 1 Januari, 2025 te gebruiken.
Voor meer informatie en geleidelijke instructies om uw integratie te migreren, zie Migratie van JWT-referentie (Service Account) naar OAuth Server-to-Server-referentie in de Ontwerpconsole documentatie.
Voor informatie over het instellen van nieuwe OAuth-referenties raadpleegt u OAuth Server-to-Server credentiële implementatie in de Ontwerpconsole documentatie.

Hier zijn de voorlopige stappen die nodig zijn om de oudere JWT-verificatietokens te genereren die nodig zijn om te kunnen communiceren met Adobe Target API's:

  1. Maak een project (voorheen integratie genoemd) in het dialoogvenster Adobe Developer Console.
  2. Exporteer projectdetails naar Postman.
  3. Genereer een toegangstoken voor toonder.
  4. Test het toegangstoken van de drager.

Voorwaarden

Bron
Details
Postman
Als u deze stappen wilt voltooien, kunt u de opdracht Postman-app voor uw besturingssysteem. Postman basic is gratis bij het maken van accounts. Niet vereist voor gebruik Adobe Target API's in het algemeen maakt Postman API-workflows eenvoudiger, en Adobe Target biedt verschillende Postman-verzamelingen die helpen bij het uitvoeren van de API's en leren hoe ze werken. Voor de rest van deze handleiding wordt uitgegaan van praktische kennis van Postman. Zie voor hulp de Postman-documentatie.
Verwijzingen

In de rest van deze handleiding wordt ervan uitgegaan dat de volgende bronnen bekend zijn:

Een Adobe I/O-project maken

In deze sectie krijgt u toegang tot de Adobe Developer Console en maak een project voor Adobe Target. Raadpleeg voor meer informatie de documentatie over projecten.

<!—(1. Genereer uw persoonlijke sleutel en openbaar certificaat per documentatie over verificatie. // [//]: # (zoals beschreven in Stap 1 van Hoe te opstelling Adobe IO: Authentificatie - Stap voor Stap. Na de voltooiing van Stap 1, terugkeer aan deze gids en hervat met Stap 2, hieronder. // Het resultaat van deze stap moet de instelling van een private.key en een certificate_pub.crt bestand. Keer terug naar deze gids zodra u deze twee dossiers hebt geproduceerd.)—>

  1. In de Adobe Admin Console, zorg ervoor dat uw Adobe gebruikersaccount is toegekend aan beide Productbeheerder en Ontwikkelaar toegang tot Target.

  2. In de Adobe Developer Console, selecteert u de Experience Cloud Organization waarvoor u deze integratie wilt creëren. (Let op: u hebt waarschijnlijk slechts toegang tot één Experience Cloud Organization.)

    configure-io-target-create project2.png

  3. Klik op Create new project.

    configure-io-target-create project3.png

  4. Klikken Add API om REST API aan uw project toe te voegen om toegang te hebben Adobe diensten en producten.

    API toevoegen

  5. Selecteren Adobe Target als de Adobe service waarmee u wilt integreren. Klik op de knop Next die wordt weergegeven.

    configure-io-target-createproject5

  6. Selecteer een optie om openbare en privé sleutels met de integratie van de de dienstrekening te associëren u voor creeert Target. In dit voorbeeld selecteert u Option 1: Generate a key pair en klik op Generate keypair.

    configure-io-target-createproject6

  7. Noteer het automatisch gedownloade configuratiebestand (config), dat uw persoonlijke sleutel bevat. Klik op Next.

    configure-io-target-createproject7

  8. Controleer in uw bestandssysteem de locatie van configDit is het gecomprimeerde configuratiebestand dat in de vorige stap is gemaakt. Nogmaals, dit config bevat uw persoonlijke sleutel, die u later nodig hebt. De exacte locatie in uw bestandssysteem kan afwijken van de locatie die u hier ziet.

    configure-io-target-createproject8

  9. Selecteer in de Adobe Developer Console de optie productprofiel(en) komt overeen met de eigenschappen waarin u Adobe Recommendations gebruikt. (Als u geen eigenschappen gebruikt, selecteert u de optie Standaardwerkruimte.) Klik op Save configured API.

    configure-io-target-createproject9

  10. Klik op Create Integration. U ontvangt een tijdelijk bericht dat aangeeft dat de API is geconfigureerd.

  11. Als laatste stap wijzigt u de naam van het project in een naam die betekenisvoller is dan de naam van het oorspronkelijke project Project 1. Om dit te doen, navigeer aan het project gebruikend de navigatiepad zoals tonen, klik Edit project toegang tot Edit Project en hernoemen.

    configure-io-target-createproject11

NOTE
In dit voorbeeld noemen we ons project "Target Integratie." Als u uw project voor meer dan enkel verwacht gebruikt Adobe Target, kunt u het dienovereenkomstig noemen. U kunt er bijvoorbeeld voor kiezen om de naam "Adobe-API's" of "Experience Cloud-API's" te geven, omdat deze kunnen worden gebruikt met andere oplossingen in de Adobe Experience Cloud.

Projectdetails exporteren

Nu u een project van de Adobe hebt kunt u voor toegang gebruiken Target, moet u ervoor zorgen om details van dat project samen met uw Adobe API verzoeken te verzenden. Deze gegevens zijn vereist voor interactie met verschillende Adobe-API's, waaronder diverse Target API's. De integratiedetails bevatten bijvoorbeeld autorisatie- en verificatiegegevens die vereist zijn voor de Target Admin API's. Als u de API's met Postman wilt gebruiken, moet u deze gegevens daarom naar Postman overbrengen.

Er zijn vele manieren om de details van uw project in Postman te specificeren, maar in deze sectie, profiteren wij van sommige pre-gebouwde eigenschappen en inzamelingen. Eerst (in deze sectie) exporteert u de details van uw integratie naar een Postman-omgeving. Daarna (in de volgende sectie), zult u een dragertoegangstoken produceren om u toegang tot de noodzakelijke middelen van de Adobe te verlenen.

NOTE
Voor video-instructies die van toepassing zijn op alle Experiencen Cloud, waaronder Target, zie Postman gebruiken met Experience Platform-API's. De volgende punten zijn relevant voor de Target API's: 1. Experience Platform-API maken en exporteren naar Postman 2. Genereer een toegangstoken met Postman. Deze stappen worden ook hieronder gegeven.
  1. Nog steeds in de Adobe Developer Console, navigeert u om de Service Account (JWT) referenties. Gebruik de linkernavigatie of de Credentials zoals weergegeven.

    JWT1

    In Credential details, let erop dat u uw Public key(s), Client ID en andere informatie over uw serviceaccount.

    JWT1a

  2. Klik om naar informatie over de Adobe Target API. Gebruik de linkernavigatie of de Verbonden producten en services zoals weergegeven.

    JWT2

  3. Klikken Download for Postman > Service Account (JWT) om een JSON-bestand te maken waarin uw verificatiegegevens worden vastgelegd voor een Postman-omgeving.

    JWT3

    Noteer het JSON-bestand in uw bestandssysteem.

    JWT3a

  4. Klik in Postman op het tandwielpictogram om uw omgevingen te beheren en klik vervolgens op Import om het JSON-bestand (omgeving) te importeren.

    JWT4

  5. Kies uw bestand en klik op Open.

    JWT5

  6. In de Postman Omgevingen beheren Klik op de naam van de nieuwe geïmporteerde omgeving om deze te inspecteren. (De naam van uw omgeving kan verschillen van de naam die u hier ziet. Bewerk de naam naar wens. Het hoeft niet noodzakelijkerwijs overeen te komen met de naam van de Adobe project.)

    JWT6

  7. Opmerking CLIENT_SECRET en API_KEY (samen met andere variabelen) hun waarden vooraf invullen en uit uw integratie halen zoals gedefinieerd in de Adobe Developer-console. (De Postman CLIENT_SECRET variabele moet overeenkomen met CLIENT SECRET de referentie van de Adobe, zoals wordt weergegeven in de Developer Console, en API_KEY in Postman CLIENT ID in de Developer Console.) Notitie daarentegen PRIVATE_KEY, JWT_TOKEN, en ACCESS_TOKEN zijn leeg. Laten we beginnen met de PRIVATE_KEY waarde.

    JWT7

  8. Open vanuit uw bestandssysteem uw config en opent u het private sleutelbestand.

    JWT8

  9. Selecteer en kopieer de volledige inhoud van het dialoogvenster private sleutelbestand.

    JWT9

  10. Plak in Postman uw waarde voor de persoonlijke sleutel in de INITIAL VALUE en CURRENT VALUE velden.

    JWT10

  11. Klikken Update en sluit het modaal milieu.

Het toegangstoken voor toonder genereren

In deze sectie genereert u het toegangstoken aan toonder, dat vereist is voor het verifiëren van uw interactie met Adobe Target API's. Als u uw toegangstoken voor toonder wilt genereren, moet u uw integratiegegevens (die in de voorgaande secties zijn vastgelegd) naar de Adobe Identity Management Service (IMS). Er zijn een paar verschillende manieren om dit te doen, maar in deze gids maken we gebruik van een Postman-collectie die een vooraf gebouwde IMS-aanroep bevat die het proces direct en eenvoudig maakt. Nadat u de verzameling hebt geïmporteerd, kunt u deze desgewenst opnieuw gebruiken om nieuwe tokens te genereren, niet alleen voor Adobe Target, maar ook andere Adobe-API's.

  1. Ga naar de Adobe Identity Management Service API voorbeeldaanroepen.

    token1

  2. Klik op de knop Adobe I/O Access Token Generation Postman collection.

    token2

  3. Haal de onbewerkte JSON voor deze verzameling op door op Raw en kopieert u vervolgens de resulterende JSON naar het klembord. (U kunt de onbewerkte JSON ook opslaan als een .json-bestand.)

    token3

  4. Importeer de verzameling in Postman door de onbewerkte JSON vanaf het Klembord te plakken en in te dienen. (U kunt ook het .json-bestand uploaden dat u hebt opgeslagen.) Klik op Continue.

    token4

  5. Selecteer de IMS: JWT Generate + Auth via User Token verzoek in de inzameling van Postman van de Generatie van de Token van de Toegang van de Adobe I/O, zorg ervoor uw milieu wordt geselecteerd en klik Send om het token te genereren.

    token5

    note note
    NOTE
    Dit toegangsteken aan toonder is 24 uur geldig. Verzend het verzoek opnieuw wanneer u een nieuw teken moet produceren.
  6. Open nogmaals het modaal van Milieu's beheren en selecteer uw milieu.

    token6

  7. Noteer de ACCESS_TOKEN en JWT_TOKEN waarden worden nu gevuld.

    token7

Vraag: Moet ik de inzameling van Postman van de Generatie van de Token van de Toegang van de Adobe I/O gebruiken om de Token van het Web JSON (JWT) en het toegangstoken van de toonder te produceren?

Antwoord: Nee. De inzameling van Postman van de Generatie van de Token van de Toegang van de Adobe I/O is beschikbaar als gemak om JWT en het toegangstoken van de tokens in Postman gemakkelijker te produceren. U kunt ook de mogelijkheden in de Adobe Developer-console gebruiken om het toegangstoken voor toonder handmatig te genereren.

Test het toegangstoken aan toonder

In deze oefening, zult u uw nieuwe toegangsteken van de toverdrager gebruiken door een API verzoek te verzenden dat een lijst van activiteiten van uw terugwint Target account. Een succesvol antwoord geeft aan dat uw Adobe project en authentificatie werken zoals verwacht om API te gebruiken.

  1. Het dialoogvenster Importeren Adobe Target Admin API's Postman Collection. Volg alle aanwijzingen totdat de verzameling in Postman is geïmporteerd.

    testtoken1

  2. Vouw de verzameling uit en noteer de List activities verzoek.

    testtoken1

  3. Variabelen zoals {{access_token}} zijn aanvankelijk niet opgelost. U kunt dit probleem op verschillende manieren oplossen. U kunt bijvoorbeeld een nieuwe verzamelingsvariabele definiëren met de naam {{access_token}}—maar in deze handleiding wijzigt u in plaats daarvan de API-aanvraag om de Postman-omgeving die u eerder gebruikte te benutten. Hierdoor kan de omgeving blijven fungeren als één consistente consolidatie van alle variabelen die in de Adobe-API's worden gebruikt.

    testtoken2

  4. Te vervangen tekst {{access_token}} with {{ACCESS_TOKEN}}.

    testtoken3

  5. Te vervangen tekst {{api_key}} with {{API_KEY}}.

    testtoken4

  6. Te vervangen tekst {{tenant}} with {{TENANT_ID}}. Opmerking {{TENANT_ID}} wordt nog niet herkend.

    testtoken4

  7. Open het modaal beheer van milieu's, en selecteer uw milieu.

    JWT11

  8. Typ om een nieuw type toe te voegen {{TENANT_ID}} omgevingsvariabele. Kopieer en plak uw waarde voor de id van de huurder in de INITIAL VALUE en CURRENT VALUE velden voor uw nieuwe TENANT_ID omgevingsvariabele.

    testtoken5

    note note
    NOTE
    De Tenant ID is anders dan uw Target clientcode. De huurder-id staat in de URL wanneer u bent aangemeld bij Target. Als u uw Tenant-id wilt verkrijgen, meldt u zich aan bij de Adobe Experience Cloud. Open Targeten klik op de doelkaart. Gebruik de waarde van de huurder-id zoals vermeld in het URL-subdomein. Bijvoorbeeld als uw URL wanneer het programma openen aan Adobe Target is <https://mycompany.experiencecloud.adobe.com/...> Dan is je Tenant ID "mijnbedrijf".
  9. Verzend uw verzoek nadat u de juiste omgeving hebt geselecteerd. U ontvangt een reactie met uw lijst met activiteiten.

    testtoken6

Nu u uw authentificatie van de Adobe hebt geverifieerd, kunt u het gebruiken om met te communiceren Adobe Target API's (en andere Adobe-API's). U kunt bijvoorbeeld Recommendations API's gebruiken om aanbevelingen te creëren of te beheren, of u kunt het met gebruiken API voor doellevering.

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