Adobe Experience Manager (AEM) Assets is configured with Brand Portal through Adobe I/O, which procures an IMS token for authorization of your Brand Portal tenant.
Configuring AEM Assets with Brand Portal via Adobe I/O is supported on AEM 188.8.131.52 and above.
Earlier, Brand Portal was configured in Classic UI via Legacy OAuth Gateway, which uses the JWT token exchange to obtain an IMS Access token for authorization.
Configuration via Legacy OAuth is no longer supported from April 6, 2020, and is changed to configuring via Adobe I/O.
(For existing customers only)
It is recommended to continue using existing legacy OAuth Gateway configuration. In case, you encounter problems with legacy OAuth Gateway configuration, delete the existing configuration and create new configuration via Adobe I/O.
This help describes the following two use-cases:
- New configuration: If you are a new Brand Portal user and want to configure your AEM Assets author instance with Brand Portal, you can create new configuration on Adobe I/O.
- Upgrade configuration: If you are an existing Brand Portal user with your AEM Assets author instance configured with Brand Portal on legacy OAuth Gateway, it is recommended to delete the existing configuration and create new configuration on Adobe I/O.
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
You require the following to configure AEM Assets with Brand Portal:
- An up and running AEM Assets author instance with latest Service Pack.
- Brand Portal tenant URL.
- A user with system administrator privileges on the IMS organization of the Brand Portal tenant.
Download and install AEM 6.3
It is recommended to have AEM 6.3 to set up an AEM author instance. If you do not have AEM up and running, download it from the following locations:
If you are an existing AEM customer, download AEM 6.3 from Adobe Licensing website.
If you are an Adobe partner, use Adobe Partner Training Program to request AEM 6.3.
After you download AEM, for instructions to set up an AEM author instance, see deploying and maintaining.
Download and install AEM 6.3 latest Service Pack
For detailed instructions see,
Contact Support if you are unable to find the latest AEM package or Service Pack.
AEM Assets Brand Portal Replication window opens.
In Tenant URL, enter the tenant URL of your organization.
In Authorization Server, enter the URL: https://ims-na1.adobelogin.com/
The next step is to create Adobe I/O integration and then you can continue to configure the Brand Portal cloud service.
The integration generates API Key, Technical Account Id, Organization Id, and Client Secret key which is required in configuring Brand Portal cloud service.
Create a new integration page opens.
Select your organization from the drop-down list.
In Experience Cloud], select AEM Brand Portal and click Continue.
If the Brand Portal option is disabled for you, ensure that you have selected correct organization from the drop-down box above the Adobe Services option. If you do not know your organization, contact your administrator.
The API Key, Technical Account Id, Organization Id, and Client Secret key information will be used to configure the Brand Portal cloud service.
You can configure the Brand Portal cloud service to update the configuration. Continue with the last step where you left in create cloud service.
Paste the API Key, Technical Account Id, Org Id, and Client Secret key that you have copied at the end of create Adobe I/O integration.
Create only one, valid configuration.
Make sure to test the configuration. In case, the configuration fails, delete it and create a new configuration.
Four replication agents are created for each tenant.
Locate the replication agents of your Brand Portal tenant.
Click the replication agent URL.
The replication agents work in parallel and share the job distribution equally, thereby increasing the publishing speed by four times the original speed. After the cloud service is configured, additional configuration is not required to enable the replication agents that are activated by default to enable parallel publishing of multiple assets.
Avoid disabling any of the replication agents, as it can cause the replication of some of the assets to fail.
Ensure that no publishing job is running on your AEM Assets author instance before you make any modifications. For that, you can verify all four replication agents and ensure that the queue is ideal/empty.
You must run the following check-list while deleting the existing configuration.
- Delete all four replication agents
- Delete cloud service
- Delete MAC user
Perform the following steps to delete the existing configuration:
You can now create configuration on your AEM 6.3 author instance on Adobe I/O.
After replication succeeds, you can publish assets, folders, and collections to Brand Portal. To publish a folder to Brand Portal, follow these steps:
Adobe recommends installing AEM 6.2 SP1-CFP5, AEM CFP 184.108.40.206, and later releases to utilize multiple replication agents for high-speed parallel publishing.
Adobe recommends staggered publishing, preferably during non-peak hours, so that the AEM author does not occupy excess resources.
To publish the selected assets to Brand Portal, do either of the following:
- From the toolbar, select Quick Publish. Then from the menu, select Publish to Brand Portal.
- From the toolbar, select Manage Publication. Then from the Actions, select Publish to Brand Portal and select Next.
Once on Manage Publication page, confirm your selection and tap/ click Publish to Brand Portal.
A confirmation message appears when the folder is successfully published on the Brand Portal Interface.