How to set up Adobe IO: Authentication - Step by Step

Generate private key and public certificate per the following documentation: https://www.adobe.io/apis/cloudplatform/console/authentication/createcert.html

On a Mac, the following commands are built in terminal. 
On a computer, you have to download Cygwin (or other tool of personal preference) and run it from command line. Here are the steps to download and install Cygwin:

1. Browse to https://cygwin.com/install.html
2. Download and run setup-x86_64.exe

Note:  Your home directory  is: C:\cygwin64\home\WINDOWSUSER
You can search for and install additional packages during the install phase. I recommend installing everything related to "curl" and "ssh."

Here is the command to run:

Note:  It asks you several questions that you have to fill out to generate the certificate, see screenshot below:

After the files have been created, you convert the secret.key to secret.pem using the following command:

Here are the files that are created on your file system (you may move these files to another location on your machine at this point for organization):

Create integration within the Adobe IO console:

• Go to https://console.adobe.io/
• Select company.
• Click "New Integration" button.

• Select "Access an API" option, then click "continue."

• Select Adobe Solution (currently only available for Target).

Note: User must be a user of the Experience Cloud AND have access to that solution.

• Select "New integration" and click "Continue."

• Fill out integration form.

• Drag "certificate.pem" from file system into form to upload.

• Once the file is uploaded, click "Create integration" button - see screenshot: fileuploaded_createint.

• When processing is complete, click "continue to integration details."

Success! You have now created an integration.

Generate JSON Web Token (JWT):

In the Integration UI, click the JWT tab, paste in private key, click Generate JWT button - see screenshot: generating JWT - input.

• Once it is generated, you see the JWT and a sample CURL command.
• Click "copy" icon below "Generated JWT."

Exchange JWT for Bearer Access Token:

Note: If you run this on a Mac terminal, the response seems to get truncated. Instead, use Postman.

• Download and install free API tool named "Postman" (available on Mac, Windows, or Linux): https://www.getpostman.com/
• Import this api call into Postman by copying the code below into a text file on your computer with a .json extension:

Example filename: exchangeJwt.json

• Import file into Postman by going to file > Import: you can drag-and-drop the .json file here or browse for the file.

• This creates a "collection" in Postman on the left side, with one API call in it named "Exchange JWT for Bearer token."

• Click the API call "Exchange JWT for Bearer token."
• In the main section of the UI, this is what you see:

Note: as highlighted in red above, I'm in the "Body" tab. If you are in another tab, you do not see the three pieces of information that are required.

Info Needed:
client_id: get from Integration overview page
client_secret: generate on Integration overview page
jwt_token: paste in generated JWT token that you copied in previous step

Click "Send."
The bearer token is retrieved, which is used to make API calls.

The access_token is what is used as part of the API calls you intend to run.

Example API call:

• Target
• Run Target call with access token