Creating the service connection for Adobe Data Provider
Overview
The integration option is available for Adobe enterprise customers only (Creative Cloud for enterprise plans).
A service connection allows you to establish access to the Adobe User Management API and obtain data from it without sharing the credentials. A service connection is configured once by an administrator and then it can automatically use a service for obtaining data.
The Adobe Data Provider add-on contains an Adobe service. This service is needed for creating a service connection to Adobe User Management API.
To create a service connection, take the following steps:
- Configure the authentication and authorization settings for integration in the Adobe admin console.
- Create a tenant in Enterprise Service Management.
- Create a service connection in Enterprise Service Management.
A DWP subsciption is required to be able to use the Adobe Data Provider add-on.
Configuring the authentication and authorization in the Adobe admin console
To configure the integration settings for Adobe, you will need to register your Enterprise Service Management application in the console.
Registering a project
- On the Adobe Developer Console home page, click Create new project.
- In the Get started section of your new project, click Add API.
- Select the User Management API and click Next.
Only members of the organization with SYSTEM ADMIN role can create the integration for user management API. You can use the Adobe Admin Console to grant the administrative privilege to users.
- On the page that opens, click Save configured API.
After saving, you will see the User Management API tab of your new Adobe project. Switch to the OAuth Server-to-Server tab as you will need it later to configure your tenant.
Creating a tenant
In Matrix42 Enterprise Service Management, you need to create a tenant for the service connection.
- Go to the Administration application and open the Integration > Service Connections > Tenants navigation item.
- Run the Add Tenant action. A new tenant dialog opens.
- Provide an appropriate name for your tenant.
- Select Adobe (OAuth) in the Service field.
- Fill in all required fields with the following data:
Field | Adobe property | Note |
Client ID | Client ID | |
Tenant | Organization ID | |
Client Secret | Client Secret | Click on Retrieve client secret on the OAuth Server-to-Server tab in the Adobe Developer Console. |
- Save the dialog.
Tenant settings for the deprecated Service Account (JWT) credential
If you are still using the deprecated JWT credential, there are some differences when creating a tenant.
- In the Service field, you need to select Adobe.
- The credentials' fields must be filled in as follows:
Field | Adobe property | Note |
Client ID | Client ID | |
Tenant | Organization ID | |
Client Secret | Client Secret | Click on Retrieve client secret in the credentials overview in the Adobe Developer Console. |
Account Id | Technical Account ID | |
Private Key | private.key file which was downloaded at the time of generating a keypair in Adobe | Copy and paste the content of the private.key file but remove the first and last line as well as all line breaks. |
Creating a service connection
Next, create a service connection to your new Adobe project.
- In the Administration application, go to Integration > Service Connections > Connections.
- Run the Add Service Connection action. A new connection dialog opens.
- Select Adobe (OAuth) - Enterprise User SDK Scope in the Service field. Alternatively, it is Adobe - Enterprise User SDK Scope for the deprecated JWT credential.
- In the Tenant field, select the tenant record that you have created earlier.
- Click Setup authentication.
Now you can use this service connection in the configuration of the Adobe Data Provider.
For more information on creating and using service connections, please refer to this article.