Verificatie configureren voor Adobe Target API’s

De Adobe Target Admin API’s, inclusief Recommendations Admin API’s, worden via verificatie beveiligd zodat alleen geautoriseerde gebruikers deze kunnen gebruiken voor toegang tot Adobe Target . Gebruik ​ Adobe Developer Console ​ om deze authentificatie voor allen Adobe Experience Cloud solutions, met inbegrip van Adobe Target te beheren.

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 ​ Migrerend van de Rekening van de Dienst (JWT) referentie aan OAuth Server-aan-Server credential ​ in de Developer Console documentatie.
Voor informatie aan opstellings nieuwe geloofsbrieven OAuth, zie ​ Server-aan-Server referentie implementatie ​ in de Developer Console documentatie.

Hier volgen de eerste 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 de 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
Om deze stappen met succes te voltooien, krijg app ​ Postman ​ voor uw werkend systeem. Postman basic is gratis bij het maken van accounts. Hoewel het niet nodig is om API’s van Adobe Target in het algemeen te gebruiken, maakt Postman API-workflows eenvoudiger en biedt Adobe Target verschillende Postman-verzamelingen om de API’s van de API’s uit te voeren en te leren hoe ze werken. Voor de rest van deze handleiding wordt uitgegaan van praktische kennis van Postman. Voor hulp, zie de ​ documentatie van Postman ​.
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 Adobe Developer Console en maakt u een project voor Adobe Target . Voor meer informatie, verwijs naar de ​ documentatie over projecten ​.

<!—(1. Produceer uw privé sleutel en openbaar certificaat, per de ​ documentatie op authentificatie ​. // [//] : # (zoals die in wordt beschreven Stap 1 van ​ hoe te opstelling Adobe IO: Authentificatie - Stap door Stap ​. Na de voltooiing van Stap 1, terugkeer aan deze gids en hervat met Stap 2, hieronder. // Het resultaat van deze stap moeten het maken van een private.key -bestand en een certificate_pub.crt -bestand zijn. Keer terug naar deze gids zodra u deze twee dossiers hebt geproduceerd.)—>

  1. In ​ Adobe Admin Console ​, zorg ervoor uw Adobe gebruikersrekening zowel ​ Admin van het Product ​ als ​ het niveautoegang van de Ontwikkelaar ​ tot Target is verleend.

  2. In ​ Adobe Developer Console ​, selecteer Experience Cloud Organization waarvoor u deze integratie wilt tot stand brengen. (Let op: u hebt waarschijnlijk slechts toegang tot één Experience Cloud Organization .)

    ​ vorm-io-doel-createproject2.png ​

  3. Klik op Create new project .

    ​ vorm-io-doel-createproject3.png ​

  4. Klik op Add API om een REST API aan uw project toe te voegen voor toegang tot Adobe -services en -producten.

    ​ voeg API ​ toe

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

    ​ vorm-io-doel-createproject5 ​

  6. Selecteer een optie om openbare en persoonlijke sleutels te koppelen aan de integratie van de serviceaccount die u maakt voor Target . Selecteer Option 1: Generate a key pair voor dit voorbeeld en klik op Generate keypair .

    ​ vorm-io-doel-createproject6 ​

  7. Zoals geïnstrueerd, neem nota van het automatisch gedownloade configuratiedossier (config), dat uw privé sleutel bevat. Klik op Next .

    ​ vorm-io-doel-createproject7 ​

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

    ​ vorm-io-doel-createproject8 ​

  9. Terug in Adobe Developer Console, selecteer ​ productprofiel(en) ​ die aan de eigenschappen beantwoorden waarin u Adobe Recommendations gebruikt. (Als u geen eigenschappen gebruikt, selecteert u de optie Standaard-Workspace.) Klik op Save configured API .

    ​ vorm-io-doel-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 zinvoller is dan de naam van het oorspronkelijke project Project 1 . Hiervoor navigeert u naar het project met het navigatiepad zoals getoond, klikt u op Edit project om het modaal Edit Project te openen en wijzigt u de naam van het project.

    ​ vorm-io-doel-createproject11 ​

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

Projectdetails exporteren

Nu u een Adobe-project hebt dat u kunt gebruiken om Target te openen, moet u ervoor zorgen dat u de details van dat project verzendt samen met uw Adobe API-aanvragen. Deze gegevens zijn vereist voor interactie met verschillende API’s van Adobe, waaronder enkele API’s van het type Target . De integratiegegevens 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. Vervolgens (in de volgende sectie) genereert u een token voor toonder toegang om u toegang te verlenen tot de benodigde Adobe-bronnen.

NOTE
Voor videoinstructies toepasselijk voor om het even welke oplossing van Experience Cloud, met inbegrip van Target, zie ​ Postman van het Gebruik met Experience Platform APIs ​. De volgende secties zijn relevant voor de API's van Target : 1. Experience Platform API maken en exporteren naar Postman 2. Genereer een toegangstoken met Postman. Deze stappen worden ook hieronder gegeven.
  1. Nog in ​ Adobe Developer Console ​, navigeer om de 2} geloofsbrieven van uw nieuw project te bekijken {. Service Account (JWT) Gebruik de linkernavigatie of de sectie Credentials zoals getoond.

    ​ JWT1 ​

    In Credential details kunt u de Public key(s) , Client ID en andere informatie over uw serviceaccount bekijken.

    ​ JWT1a ​

  2. Klik om naar informatie over de Adobe Target API te navigeren. Gebruik of de linkernavigatie of de Verbonden producten en de diensten sectie zoals getoond.

    ​ JWT2 ​

  3. Klik op 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 het bestand en klik op Open .

    ​ JWT5 ​

  6. In Postman beheert Milieu modaal, klik de naam van het onlangs ingevoerde milieu om het te inspecteren. (De naam van uw omgeving kan verschillen van de naam die u hier ziet. Bewerk de naam naar wens. Dit hoeft niet noodzakelijkerwijs overeen te komen met de naam van het Adobe -project.)

    ​ JWT6 ​

  7. Opmerking CLIENT_SECRET en API_KEY (samen met andere variabelen) hebben hun waarden vooraf ingevuld en zijn afkomstig van de integratie die in de Adobe Developer Console is gedefinieerd. (De Postman CLIENT_SECRET -variabele moet overeenkomen met de CLIENT SECRET Adobe-referentie die in de Developer Console wordt weergegeven, en API_KEY in Postman moet dezelfde waarde hebben als CLIENT ID in de Developer Console.) Opmerking PRIVATE_KEY , JWT_TOKEN en ACCESS_TOKEN zijn daarentegen leeg. Laten we beginnen met het opgeven van de waarde PRIVATE_KEY .

    ​ JWT7 ​

  8. Open vanuit uw bestandssysteem het config -bestand en open het private -sleutelbestand.

    ​ JWT8 ​

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

    ​ JWT9 ​

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

    ​ JWT10 ​

  11. Klik op Update en sluit het modaal milieu-item.

Het toegangstoken voor toonder genereren

In deze sectie genereert u uw toegangstoken aan toonder, die nodig is voor het verifiëren van uw interactie met Adobe Target API’s. Om uw die toegangstoken van de toonder te produceren, moet u uw integratiedetails (in de voorafgaande secties worden gevestigd) naar de ​ Dienst van Adobe Identity Management (IMS) ​ verzenden. 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 voor andere Adobe API’s.

  1. Navigeer aan de ​ de steekproefvraag van de Dienst API van Adobe van Identity Management ​.

    ​ token1 ​

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

    ​ token2 ​

  3. Haal de onbewerkte JSON voor deze verzameling op door op Raw te klikken en de resulterende JSON vervolgens naar het klembord te kopiëren. (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 aanvraag IMS: JWT Generate + Auth via User Token in de Adobe I/O Access Token Generation Postman-verzameling, controleer of de omgeving is geselecteerd en klik op Send om het token te genereren.

    ​ token5 ​

    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. De waarden ACCESS_TOKEN en JWT_TOKEN zijn nu ingevuld.

    ​ token7 ​

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

Antwoord: Nee. De Adobe I/O Access Token Generation Postman-collectie is beschikbaar als een handige manier om de JWT en de toegangstoken voor toonder in Postman gemakkelijker te kunnen genereren. 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 toegangstoken van de toonder gebruiken door een API verzoek te verzenden dat een lijst van activiteiten van uw Target rekening terugwint. Een geslaagde reactie geeft aan dat uw Adobe -project werkt en dat de verificatie naar behoren functioneert om de API te kunnen gebruiken.

  1. Importeer de Adobe Target Admin APIs Postman Inzameling ​. Volg alle aanwijzingen totdat de verzameling in Postman is geïmporteerd.

    ​ testtoken1 ​

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

    ​ testtoken1 ​

  3. Variabelen zoals {{access_token}} zijn aanvankelijk niet opgelost. U kunt dit probleem op verschillende manieren oplossen. U kunt bijvoorbeeld een nieuwe verzamelingsvariabele met de naam {{access_token}} definiëren. In deze handleiding wijzigt u echter de API-aanvraag zodat de Postman-omgeving die u eerder gebruikte, wordt benut. Hierdoor kan de omgeving blijven fungeren als één consistente consolidatie van alle variabelen die in Adobe API’s worden gebruikt.

    ​ testtoken2 ​

  4. Typ om {{access_token}} te vervangen door {{ACCESS_TOKEN}} .

    ​ testtoken3 ​

  5. Typ om {{api_key}} te vervangen door {{API_KEY}} .

    ​ testtoken4 ​

  6. Typ om {{tenant}} te vervangen door {{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 nieuwe omgevingsvariabele {{TENANT_ID}} toe te voegen. Kopieer en plak de waarde voor de id van de huurder in de velden INITIAL VALUE en CURRENT VALUE voor de nieuwe omgevingsvariabele TENANT_ID .

    ​ testtoken5 ​

    note
    NOTE
    De Tenant-id verschilt van uw Target clientcode . De huurder-id staat in de URL wanneer u bent aangemeld bij Target . Als u uw huurder-id wilt ophalen, meldt u zich aan bij de Adobe Experience Cloud, opent u Target en klikt u op de doelkaart. Gebruik de waarde van de huurder-id zoals vermeld in het URL-subdomein. Als uw URL bij het aanmelden bij Adobe Target bijvoorbeeld [https://mycompany.experiencecloud.adobe.com/...](https://mycompany.experiencecloud.adobe.com/...) is, is de id van uw huurder "mijn bedrijf".
  9. Verzend uw verzoek nadat u de juiste omgeving hebt geselecteerd. U ontvangt een reactie met uw lijst met activiteiten.

    ​ testtoken6 ​

Nu u uw Adobe-verificatie hebt geverifieerd, kunt u deze gebruiken voor interactie met Adobe Target API’s (en andere Adobe API’s). Bijvoorbeeld, kunt u ​ Aanbevelingen APIs van het Gebruik ​ om aanbevelingen tot stand te brengen of te leiden, of u kunt het met ​ de Levering API van het Doel gebruiken ​.

recommendation-more-help
target-dev-help-dev