Create the Integration in Adobe I/O
Adobe I/O is Adobe's developer ecosystem and community. It consists of the adobe.io website, the Adobe I/O developer tools and APIs, APIs for all Adobe products, and our social media presence.
In order to make API calls to your Platform account you will need to create a new Integration in the Adobe I/O Console. When you create an Integration, you are assigned an API Key (client ID) and other access credentials. You can then obtain a secure access token from Adobe for each API session.
For service-to-service integrations such as with Experience Platform, you will also need a JSON Web Token (JWT) that encapsulates your client credentials and authenticates the identity of your integration. You exchange the JWT for the access token that authorizes access.
An integration can be subscribed to one or more services. In many cases, you will use the same client credentials to access multiple Adobe services. In addition to APIs, you may also subscribe your integration to I/O Events so that your applications can access content and services in real-time.
Create the Certificate
- Mac Users: Open Terminal
- Next you will use OpenSSL to generate a a private key and self-signed certificate with a public key. Since this certificate will only be used in your local environment for this tutorial, we do not need to sign it by Global Certificate Authority. After completing the tutorial and when you are getting ready to start incorporating the API in to your own applications, you will need to create a signed certificate. Alternatively, if you have a signed certificate, you can skip the next few steps and use it instead. Execute the command below in your Terminal window:
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout private.key -out certificate_pub.crt
- You will get a response similar to the following which prompts you to enter some information about yourself:
Generating a 2048 bit RSA private key .................+++ .......................................+++ writing new private key to 'private.key' ----- You are about to be asked to enter information that will be incorporated into your certificate request. What you are about to enter is what is called a Distinguished Name or a DN. There are quite a few fields but you can leave some blank For some fields there will be a default value, If you enter '.', the field will be left blank. ----- Country Name (2 letter code) : State or Province Name (full name) : Locality Name (eg, city) : Organization Name (eg, company) : Organizational Unit Name (eg, section) : Common Name (eg, fully qualified host name) : Email Address :
After entering the information two files will be generated: certificate_pub.crt and private.key in the same directory from which you ran the openssl command.
The certificate_pub.crt certificate will later be uploaded to the Adobe IO Console for when you create an API key for access to any Adobe I/O API.
Your private key file named private.key will be used later to sign your JWT token.
Don't close this terminal window as you will need it later.
Create the Integration in the Adobe I/O Console
- Navigate to the Adobe I/O Console and sign in with your Adobe ID.
- From the Adobe I/O Console home screen, click View Integrations
- Make sure the Experience Cloud Organization you are intending to use for this tutorial is selected in the dropdown
- Note that with the correct user access privileges assigned in the previous lesson, Organization Role should say Developer or Administrator.
- Click New integration
- Make sure Access an API is selected
- Click Continue
- Select Experience Platform API
- Click Continue
- Name your integration (we recommend including an identifier for your name) F
- Add a Description
- Upload your public certificate—the certificate_pub.crt file we generated in the previous section
- Click on Adobe Cloud Platform as the Product Profile (or whatever the appropriate Product Profile is setup in your org)
- Finally, click Create Integration to finish up the process
- After your integration has been created you will land on a screen like the one pictured below. Click Continue to Integration Details ,
- You will be able to view the details of your integration. After clicking on Retrieve client Secret your screen should look similar to this (without the blurring!):
Copy the values for your , which is the Organization ID, and as these will be used in upcoming lessons.