ÃÛ¶¹ÊÓƵ

DocumentationAEM 6.5User Guide

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

Last update: Thu Aug 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
NOTE
ÃÛ¶¹ÊÓƵ customers use the 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 .

ÃÛ¶¹ÊÓƵ Experience Manager (AEM) can be integrated with many other ÃÛ¶¹ÊÓƵ solutions. For example, ÃÛ¶¹ÊÓƵ Target, ÃÛ¶¹ÊÓƵ Analytics, and others.

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

CAUTION
Previously, configurations were made with JWT Credentials that are now subject to deprecation in the ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Developer Console.

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

  • Overview:

  • Creating a new OAuth credential:

  • Migrating an existing JWT credential to an OAuth credential:

For example:

OAuth Credential in the Developer Console

Creating an OAuth configuration creating-oauth-configuration

To create a new ÃÛ¶¹ÊÓƵ IMS Integration using OAuth:

  1. In AEM, navigate to Tools, Security, ÃÛ¶¹ÊÓƵ IMS Integration.

  2. Select Create.

  3. Complete the configuration based on details from the . For example:

    Create OAuth Configuration

  4. Save your changes.

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

To migrate an existing ÃÛ¶¹ÊÓƵ IMS Integration based on JWT credentials:

NOTE
This example shows a Launch IMS Configuration.

  1. In AEM, navigate to Tools, Security, ÃÛ¶¹ÊÓƵ IMS Integration.

  2. Select the JWT configuration that needs to be migrated. JWT configurations are marked with the warning JWT Credentials (deprecated).

  3. Select Properties:

    Select JWT Configuration

  4. The configuration opens as read-only:

    Configuration Properties - Read-only

  5. Select OAuth from the Authentication Type dropdown:

    Select Authentication Type

  6. The properties available are updated. Use details from the Developer Console to complete them:

    Complete OAuth details

  7. 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