Configure AEM Assets with Brand Portal configure-integration-65

Article link
AEM as a Cloud Service
Click here
AEM 6.5
This article

Adobe Experience Manager Assets Brand Portal lets you publish approved brand assets from Adobe Experience Manager Assets to Brand Portal and distribute them to the Brand Portal users.

AEM Assets is configured with Brand Portal via Adobe Developer Console, which procures an Adobe Identity Management Services (IMS) account token for authorization of the Brand Portal tenant.

Configuring AEM Assets with Brand Portal via Adobe Developer Console is supported on AEM and above.
For existing customers only
Adobe recommends that you continue to use the existing legacy OAuth Gateway configuration. If you encounter problems with legacy OAuth Gateway configuration, delete the existing configuration and create a configuration by way of the Adobe Developer Console.

The information provided is based on the assumption that anyone reading this Help is familiar with the following technologies:

  • Installing, configuring, and administering Adobe Experience Manager and AEM packages.

  • Using Linux┬« and Microsoft┬« Windows operating systems.

Prerequisites prerequisites

You require the following to configure AEM Assets with Brand Portal:

  • An up and running AEM Assets Author instance with the latest Service Pack
  • A Brand Portal tenant URL
  • A user with system administrator privileges on the IMS organization of the Brand Portal tenant

Download and install AEM 6.5

Download and install the latest AEM Service Pack

Download and install AEM 6.5 aemquickstart

It is recommended to have AEM 6.5 to set up an AEM Author instance. If you do not have AEM up and running, download it from the following locations:

After you download AEM, for instructions to set up an AEM Author instance, see deploying and maintaining.

Download and install AEM latest Service Pack servicepack

For detailed instructions, see the current AEM 6.5 Service Pack Release Notes.

Contact Adobe Customer Support if you cannot find the latest AEM package or Service Pack.

Create configuration configure-new-integration-65

You cannot create new JWT credentials from June 2024 onwards. Henceforth, only OAuth credentials are created. See more creating an OAuth configuration.

Configuring AEM Assets with Brand Portal requires configurations in both AEM Assets Author instance and the Adobe Developer Console.

  1. In Adobe Developer Console, create a project for your Brand Portal tenant (organization).
  2. In Experience Manager Assets, configure the Brand Portal cloud service using the IMS account and Brand Portal endpoint (organization URL).
  3. Test your configuration by publishing an asset from Experience Manager Assets to Brand Portal.
An AEM Assets Author instance shall only be configured with one Brand Portal tenant.

Perform the following steps in the listed sequence if you are configuring AEM Assets with Brand Portal for the first time:

Create a new configuration create-new-configuration

Perform the following steps in the specified sequence to configure Experience Manager Assets with Brand Portal.

Configure the OAuth credentials in the Adobe Developer Console config-oauth

Configure the OAuth credentials in the Adobe Developer Console and select Brand Portal API.

Create new Adobe IMS integration using OAuth create-ims-account-configuration

Create a new Adobe IMS Integration using OAuth and select Brand Portal from the drop down.

Configure cloud service configure-cloud-service

  1. Log in to your AEM Assets Author instance.

  2. From the Tools Tools panel, navigate to Cloud Services > AEM Brand Portal.

  3. In the Brand Portal Configurations page, click Create.

  4. Specify a Title for the configuration.

    Select the IMS configuration that you have created while configuring the IMS account.

    In the Service URL field, specify your Brand Portal tenant (organization) URL.

    Brand Portal Configuration window

  5. Click Save & Close. The cloud configuration is created.

    Your AEM Assets Author instance is now configured with the Brand Portal tenant.