Documentation AEM as a Cloud Service User Guide

Setting Up IMS Integrations for AEM as a Cloud Service

Last update: June 4, 2024

Applies to:
Experience Manager as a Cloud Service

Topics:
Security

CREATED FOR:

Admin

NOTE

Auto-provisioned JWT configurations should not be migrated manually, as they will be handled automatically by Adobe.

Adobe Experience Manager (AEM) as a Cloud Service 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.

Once 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

As the first step you need to configure the OAuth credentials in the Adobe Developer Console.

For details on how to do this, 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

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

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 will open as read-only:
Select OAuth from the Authentication Type dropdown:
The properties available will be 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 will be gone.

recommendation-more-help