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.
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:
- Maak een project (voorheen integratie genoemd) in het dialoogvenster Adobe Developer Console.
- Exporteer projectdetails naar Postman.
- Genereer een toegangstoken voor toonder.
- Test het toegangstoken van de drager.
Voorwaarden
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.)—>
-
In de Adobe Admin Console, zorg ervoor dat uw Adobe gebruikersaccount is toegekend aan beide Productbeheerder en Ontwikkelaar toegang tot Target.
-
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.)
-
Klik op Create new project.
-
Klikken Add API om REST API aan uw project toe te voegen om toegang te hebben Adobe diensten en producten.
-
Selecteren Adobe Target als de Adobe service waarmee u wilt integreren. Klik op de knop Next die wordt weergegeven.
-
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.
-
Noteer het automatisch gedownloade configuratiebestand (
config
), dat uw persoonlijke sleutel bevat. Klik op Next. -
Controleer in uw bestandssysteem de locatie van
config
Dit is het gecomprimeerde configuratiebestand dat in de vorige stap is gemaakt. Nogmaals, ditconfig
bevat uw persoonlijke sleutel, die u later nodig hebt. De exacte locatie in uw bestandssysteem kan afwijken van de locatie die u hier ziet. -
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.
-
Klik op Create Integration. U ontvangt een tijdelijk bericht dat aangeeft dat de API is geconfigureerd.
-
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.
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.
-
Nog steeds in de Adobe Developer Console, navigeert u om de Service Account (JWT) referenties. Gebruik de linkernavigatie of de Credentials zoals weergegeven.
In Credential details, let erop dat u uw Public key(s), Client ID en andere informatie over uw serviceaccount.
-
Klik om naar informatie over de Adobe Target API. Gebruik de linkernavigatie of de Verbonden producten en services zoals weergegeven.
-
Klikken Download for Postman > Service Account (JWT) om een JSON-bestand te maken waarin uw verificatiegegevens worden vastgelegd voor een Postman-omgeving.
Noteer het JSON-bestand in uw bestandssysteem.
-
Klik in Postman op het tandwielpictogram om uw omgevingen te beheren en klik vervolgens op Import om het JSON-bestand (omgeving) te importeren.
-
Kies uw bestand en klik op Open.
-
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.)
-
Opmerking
CLIENT_SECRET
enAPI_KEY
(samen met andere variabelen) hun waarden vooraf invullen en uit uw integratie halen zoals gedefinieerd in de Adobe Developer-console. (De PostmanCLIENT_SECRET
variabele moet overeenkomen metCLIENT SECRET
de referentie van de Adobe, zoals wordt weergegeven in de Developer Console, enAPI_KEY
in PostmanCLIENT ID
in de Developer Console.) Notitie daarentegenPRIVATE_KEY
,JWT_TOKEN
, enACCESS_TOKEN
zijn leeg. Laten we beginnen met dePRIVATE_KEY
waarde. -
Open vanuit uw bestandssysteem uw
config
en opent u hetprivate
sleutelbestand. -
Selecteer en kopieer de volledige inhoud van het dialoogvenster
private
sleutelbestand. -
Plak in Postman uw waarde voor de persoonlijke sleutel in de INITIAL VALUE en CURRENT VALUE velden.
-
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.
-
Ga naar de Adobe Identity Management Service API voorbeeldaanroepen.
-
Klik op de knop Adobe I/O Access Token Generation Postman collection.
-
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.)
-
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.
-
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.
note note NOTE Dit toegangsteken aan toonder is 24 uur geldig. Verzend het verzoek opnieuw wanneer u een nieuw teken moet produceren. -
Open nogmaals het modaal van Milieu's beheren en selecteer uw milieu.
-
Noteer de
ACCESS_TOKEN
enJWT_TOKEN
waarden worden nu gevuld.
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.
-
Het dialoogvenster Importeren Adobe Target Admin API's Postman Collection. Volg alle aanwijzingen totdat de verzameling in Postman is geïmporteerd.
-
Vouw de verzameling uit en noteer de List activities verzoek.
-
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. -
Te vervangen tekst
{{access_token}}
with{{ACCESS_TOKEN}}
. -
Te vervangen tekst
{{api_key}}
with{{API_KEY}}
. -
Te vervangen tekst
{{tenant}}
with{{TENANT_ID}}
. Opmerking{{TENANT_ID}}
wordt nog niet herkend. -
Open het modaal beheer van milieu's, en selecteer uw milieu.
-
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 nieuweTENANT_ID
omgevingsvariabele.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". -
Verzend uw verzoek nadat u de juiste omgeving hebt geselecteerd. U ontvangt een reactie met uw lijst met activiteiten.
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.