Setting Up IMS Integrations for AEM setting-up-ims-integrations-for-aem

Last update: Thu Jun 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Topics:
Security

CREATED FOR:

Admin

NOTE

Adobe customers use the Adobe Developer Console to generate credentials that enable access to various APIs. Customers select from various credential types ranging from OAuth Server-to-Server to Single-Page App. The credential type Service Account (JWT) is now deprecated in favor of the OAuth Server-to-Server credentials with Service Pack 20. This change can be back ported to older Service Packs, starting with Service Pack 11 up to Service Pack 20 with the use of a hotfix that you can download here.

Adobe Experience Manager (AEM) can be integrated with many other Adobe solutions. For example, Adobe Target, Adobe Analytics, and others.

The integrations use an IMS integration, configured with S2S OAuth.

After you have created:
- Credentials in the Developer Console
Then you can:
- Create a (new) OAuth configuration
- Migrate an existing JWT configuration to an OAuth configuration

CAUTION

Previously, configurations were made with JWT Credentials that are now subject to deprecation in the Adobe Developer Console.

Such configurations can no longer be created or updated, but can be migrated to OAuth configurations.

Credentials in the Developer Console credentials-in-the-developer-console

As the first step, you must configure the OAuth credentials in the Adobe Developer Console.

For details on how to do this configuration, see the Developer Console documentation, depending on your requirements:

Overview:
- Server to Server authentication
Creating a new OAuth credential:
- OAuth Server-to-Server credential implementation guide
Migrating an existing JWT credential to an OAuth credential:
- Migrating from Service Account (JWT) credential to OAuth Server-to-Server credential

For example:

OAuth Credential in the Developer Console

Creating an OAuth configuration creating-oauth-configuration

To create a new Adobe IMS Integration using OAuth:

In AEM, navigate to Tools, Security, Adobe IMS Integration.
Select Create.
Complete the configuration based on details from the Developer Console. For example:
Save your changes.

Migrating an existing JWT configuration to an OAuth configuration migrating-existing-JWT-configuration-to-oauth

To migrate an existing Adobe IMS Integration based on JWT credentials:

NOTE

This example shows a Launch IMS Configuration.

In AEM, navigate to Tools, Security, Adobe IMS Integration.
Select the JWT configuration that needs to be migrated. JWT configurations are marked with the warning JWT Credentials (deprecated).
Select Properties:
The configuration opens as read-only:
Select OAuth from the Authentication Type dropdown:
The properties available are updated. Use details from the Developer Console to complete them:
Use Save & Close to persist your updates.
When you return to the console, the JWT Credentials (deprecated) warning is gone.

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2