The User Mapping Tool uses an API that allows it to look up Adobe Identity Management System (IMS) users by email and return their IMS IDs. This API requires the user to create a Client ID for their organization, a Client Secret, and an Access or Bearer Token.
Follow the steps below to set this up:
The User Mapping Tool is integrated into the Content Transfer Tool. You can download the Content Transfer Tool from Software Distribution Portal. For more details on the latest version, refer to the Current Release Notes.
Select the Adobe Experience Manager and navigate to tools -> Operations -> Content Migration.
Click on User Mapping card.
Click on Create User Mapping Config.
If you skip this step, users and groups mapping will be skipped during the Extraction phase.
Populate the fields in User Management API Configuration, as described below.
Org ID: Enter the Adobe Identity Management System (IMS) Org ID for the organization the users are being migrated.
To get the Org ID, log into the Admin Console and choose your organization (in the top right area) if you belong to more than one. The Org ID will be in the URL of that page, in the format like
xx@AdobeOrg, where xx is the IMS Org ID. Alternately, you can find the Org ID in the Adobe Developer Console page where you generate the Access Token.
Client ID: Enter the Client ID that you saved from the Setup step.
Access Token: Enter the Access Token that you saved from the Setup step.
The Access Token expires every 24 hours and a new one needs to be created. To create a new token, go back into Adobe Developer Console, choose your project, click on User Management API and paste the same private key into the box.
After populating the fields, click on Test Configuration to test the connection to the User Management API service. If the connection is successful, you will be able to click on Save to save the configuration.
After saving the configuration, select the configuration and click on Start User Mapping.
Click on Start from the the dialog box to start the User Mapping process.
It displays the Status as RUNNING.
Once User Mapping is complete, click on Results to view the summary.
If the User Mapping process is stopped due to any of the following reasons:
The user selected Stop User Mapping
the access token expired during the process or,
some other reason
The progress is saved from where the process stopped.
Follow the steps below to resume the User Mapping process:
Click on View Log to review the User Mapping log to check the saved progress.
Click on the Start User Mapping button again to resume from where it left off.
Ensure before restarting that the access token is still valid or has been refreshed.
Click on Start from the the dialog box to resume the User Mapping process.
Once the User Mapping process completes, you will view the Status as FINISHED for that specific configuration.