Configure the Commerce Admin Integration with Adobe ID

Adobe Commerce feature Exclusive feature only in Adobe Commerce (Learn more)

This integration supports Commerce merchants with Admin users who have an Adobe ID and who want to streamline login to Adobe Commerce and Adobe Business products. It is optional and is enabled on a per-instance basis. Only Admin user workflows are affected when enabled.

Prerequisites

The administrator who configures this integration needs the following credentials during module enablement:

  • Organization ID (obtained from Adobe Admin Console), which must be at least 24 characters in length. The authenticated user must belong to this IMS organization. For information about finding your organization ID, see Organizations in Experience Cloud.
  • 2FA should be enforced on the Organization level in Adobe Admin Console to enable the module. Check the documentation
  • Client ID
  • Client secret
  • Client ID and client secret are available after retrieving API keys in the Adobe Developer Console.

Commerce Admin users must create an account with an Adobe ID to log in.

General steps

  • Get Adobe Org ID from the Adobe Admin Console
  • Generate a new project, IMS API keys, and secret from the Adobe Developer Console
  • Enable the AdminAdobeIms module
  • Configure Adobe Commerce users in the Adobe Admin Console.

A successful integration requires that all Adobe Commerce users have Admin user accounts with the same name and primary email address. If a matching Admin user account does not exist, a user with the required permissions (typically assigned the Administrator role) must manually create the Admin user account with the same name and email.

Configure the integration

After the followings steps are completed by an administrator or developer with system access, the Sign into Adobe Commerce with Adobe IMS button is displayed in the Commerce Admin login page for all Admin users.

Step 1: Get Adobe Org ID

Membership in at least one IMS organization is required to enable this feature. If you have an Adobe ID, you belong to at least one Adobe organization by default. Log in to the Adobe Admin Console to retrieve your organization ID.

Step 2: Generate a new project, IMS API keys, and secret

You must have an Adobe account to generate a new project and register it in IMS.

  1. Log in to Adobe Developer Console.

  2. Go to the Projects tab (adobe.io/projects) and click Create a new project.

  3. Click Add API on the newly created Project page.

  4. Select Adobe Services > Adobe Commerce with Adobe ID.

  5. Select Oauth 2.0 Web.

  6. Specify the Redirect URI: https://<hostname>/<backend_frontname>/adobe_ims/oauth/callback/

  7. Specify the Redirect URI pattern: https://<hostname>/<backend_frontname>/adobe_ims/oauth/callback/.*

    Escape any dots in the hostname by preceding the dots with \\. Adding a wildcard to the end of the URL supports the Adobe Commerce Admin secret key.

  8. Click Save configured API.

  9. Copy the Client ID and Client Secret keys from the created project.

Step 3: Enable the AdminAdobeIms module

The AdminAdobeIms module is responsible for the Adobe Commerce/Adobe IMS integration. After setting up the new project and copying your organization ID, client ID, and client secret, you can enable the AdminAdobeIms module.

Enter bin/magento admin:adobe-ims:enable. You are prompted to enter the following parameters. Use the values that were generated during project creation.

  • Organization ID
  • Client ID
  • Client secret
  • 2FA enabled

Adobe Commerce displays a message to report that enablement succeeded or failed.

After successfully enabling this feature, you can transition other Adobe Commerce user accounts to Adobe IMS accounts. Adobe Commerce users must belong to the configured Adobe organization to log in using an Adobe ID.

Step 4: Configure Adobe Commerce users in the Adobe Admin Console

After successfully enabling this feature, you can transition other Adobe Commerce user accounts to Adobe IMS accounts. Adobe Commerce users must belong to at least one Adobe organization to log in using an Adobe ID.

  1. In the Admin Console, navigate to Users > Users.

  2. Click Add User.

  3. Enter the email address of the user.

    If applicable, the recommended ID Type is populated automatically. You can change this setting to one of the product IDs in the list, which is based on your organization’s purchase plan.

    You can add up to ten users at one time. To add more, repeat the preceding steps after saving your changes.

  4. Click Save.

The user is added and displayed in the Users list.

On this page