JSON Web Tokens (JWT) are an open, industry standard RFC 7519 method for representing claims securely between two parties.
Communication with the Launch API occurs through the Adobe I/O gateway, and requires the use of JWT-based access tokens.
Access to the Launch APIs requires the creation of an Integration via Adobe I/O.
Open a browser and navigate to https://console.adobe.io/
Ensure the correct organization selected in the drop-down under
Click the “New Integration” button.
Select “Access an API” and click “Continue”
From the list of Adobe APIs, find the section titled “Adobe Experience Platform”. Under that section, select “Experience Platform Launch API”.
Leave the default option at the bottom as “Access an API” and click “Continue”
Leave the “New Integration” option selected and click “Continue”
On this next screen, define the configuration settings for the integration.
Give it a descriptive Name and a detailed Description for others to easily identify this application and its purpose
Next, generate an SSL private key and a public certificate.
Open a terminal application (Terminal.app, for example). Using OpenSSL, generate a new SSL certificate and key.
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout private.key -out adobe-io-public.crt
Download an OpenSSL client to generate public certificates; For example, OpenSSL Windows client.
Extract the folder and copy it to
Open a command line window and execute the following:
set OPENSSL_CONF=C:/libs/openssl-1.1.1-win64-mingw/openssl.cnf cd C:/libs/openssl-1.1.1-win64-mingw/ openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout private.key -out adobe-io-public.crt
These commands will create two files in the current directory (usually the current user’s home directory).
The names of the files maybe changed as desired. Keep the private key safe and limit access!
Next, upload the certificate (crt) file via the Adobe I/O configuration window by either drag-n-drop or select to upload.
Multiple certificates may be added.
Next, select the “Role” or set of permissions for applications using this integration.
DETAILED PERMISSION TABLE
|Admin||IT Admin||Developer||Approver||Publisher||Extension Developer|
Click “Create Integration”
If an error is encountered, it’s generally related to certificate generation issues.
Navigate to the Integration in the Adobe I/O Console.
Click on the tab labeled “JWT”
Use a text editor to open the private key file generated in the steps above.
Paste the contents of the private key file into the browser window in the text box labeled “Paste private key”.
Next, click “Generate JWT”.
Two boxes should now be visible.
Copy the sample cURL request into your terminal and execute it to verify the API call succeeds.
The sample cURL request from the previous step demonstrates exchanging the JWT for an access token, returned as
access_token in the response, for use in Launch.
The Launch API requires an
Authorization header, with the access token supplied as the
Bearer in requests.
Authorization: Bearer [TOKEN]
An access token will typically expire after 24 hours.
JWT Libraries and SDKs: https://jwt.io/
Postman API development: https://www.getpostman.com/