IMS Configuration for use when Integrating with Adobe Target

The integration of AEM with Adobe Target via the Target Standard API requires the configuration of Adobe IMS (Identity Management System). The configuration is realized with the Adobe Developer Console.

NOTE

Support for the Adobe Target Standard API is new in AEMaaCS. The Target Standard API uses IMS authentication.

The API selection is driven by the authentication method used for AEM/Target integration.

Prerequisites

Before starting this procedure:

  • Adobe Support must provision your account for:

    • Adobe Console
    • Adobe Developer Console
    • Adobe Target and
    • Adobe IMS (Identity Management System)
  • Your organization’s System Administrator should use the Admin Console to add the required developers in your organization to the relevant product profiles.

    • This provides the specific developers with permissions to enable integrations using the Adobe Developer Console.
    • For further details see Manage Developers.

Configuring an IMS Configuration - Generating a Public Key

The first stage of the configuration is to create an IMS Configuration in AEM and generate the Public Key.

  1. In AEM open the Tools menu.

  2. In the Security section select Adobe IMS Configurations.

  3. Select Create to open the Adobe IMS Technical Account Configuration.

  4. Using the drop down under Cloud Configuration, select Adobe Target.

  5. Activate Create new certificate and enter a new alias.

  6. Confirm with Create certificate.

    Create Certificate

  7. Select Download (or Download Public Key) to download the file to your local drive, so that it is ready for use when configuring IMS for Adobe Target integration with AEM.

    CAUTION

    Keep this configuration open, it will be needed again when Completing the IMS Configuration in AEM.

    Download certificate

Configuring IMS for Adobe Target integration with AEM

Adobe Developer Console Project (integration) with Adobe Target that AEM will use, then assign the required privileges.

Creating the Project

Open the Adobe Developer Console to create a Project with Adobe Target that AEM will use:

  1. Open the Adobe Developer Console for Projects:

    https://developer.adobe.com/console/projects

  2. Any projects that you have will be shown. Select Create New Project - the location and usage will depend on:

    • If you do not have any project yet, Create new project will be center, bottom.
      Create New Project - First Project
    • If you already have existing projects these will be listed and Create new project will be top right.
      Create New Project - Multiple Projects
  3. Select Add to Project followed by API:

    Add to Project

  4. Select Adobe Target, then Next:

    NOTE

    If you are subscribed to Adobe Target, but do not see it listed then you should check the Prerequisites.

  5. Upload your public key, and when complete, continue with Next:

    Upload your public key

  6. Review the credentials, and continue with Next:

    Review credentials

  7. Select the required product profiles, and continue with Save configured API:

    NOTE

    The product profiles displayed with depend on whether you have:

    • Adobe Target Standard - only Default Workspace is available
    • Adobe Target Premium - all available workspaces are listed, as shown below

    Select product profiles and save the configured API

  8. The creation will be confirmed.

Assigning privileges to the Integration

You must now assign the required privileges to the integration:

  1. Open the Adobe Admin Console:

  2. Navigate to Products (top toolbar), then select Adobe Target - <your-tenant-id> (from the left panel).

  3. Select Product Profiles, then your required workspace from the list presented. For example, Default Workspace.

  4. Select API Credentials, then the required integration configuration.

  5. Select Editor as the Product Role; instead of Observer.

Details stored for the Adobe Developer Console Integration Project

From the Adobe Developer Console Projects console you can see a list of all your integration projects:

Select View (to the right of a specific project entry) to show further details about the configuration. These include:

  • Project overview
  • Insights
  • Credentials
    • Service Account (JWT)
      • Credential details
      • Generate JWT
  • APIS
    • For example, Adobe Target

Some of these you will need to complete the integration of Adobe Target in AEM based on IMS.

Completing the IMS Configuration in AEM

Returning to AEM you can complete the IMS configuration by adding required values from the IMS integration for Target:

  1. Return to the IMS Configuration open in AEM.

  2. Select Next.

  3. Here you can use the details from the project configuration in Adobe Developer Console:

    • Title: Your text.
    • Authorization Server: Copy/paste this from the aud line of the Payload section below, e.g. https://ims-na1.adobelogin.com in the example below
    • API Key: Copy this from the Project Overview section
    • Client Secret: Generate this in the Project Overview section, and copy
    • Payload: Copy this from the Generate JWT section

    Adobe IMS Technical Account Configuration

  4. Confirm with Create.

  5. Your Adobe Target configuration will be shown in the AEM console.

    IMS configuration

Confirming the IMS Configuration

To confirm that the configuration is operating as expected:

  1. Open:

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    For example:

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. Select your configuration.

  3. Select Check Health from the toolbar, followed by Check.

    Check Health

  4. If successful, you will see a confirmation message.

Complete the Integration with Adobe Target

You can now use this IMS configuration to complete the integration with Adobe Target.

On this page