Using the User Mapping Tool (Legacy) using-user-mapping-tool
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.
Setting up the User Mapping Tool setting-up-user-mapping
Prerequisite: User mapping requires that each user to be mapped to its IMS ID has an email address in its profile in AEM, and in IMS. Even if the user uses an email address as a user ID for logging in, mapping does not work for that user unless the email address is also in the profile, and also in IMS.
Follow the steps below to set this up:
- Navigate to Adobe Developer Console using your Adobe ID.
- Create a project or open an existing project.
- Add an API - Click Add to Project and select API
- Choose User Management API. You must have System Administrator permissions to have this option available.
- Create a JWT credential.
- Generate a key pair, or Upload a public key (rsa is no good). There is a button, Generate a public/private keypair that creates this keypair for you. Make sure you save both the public and private keys.
- Navigate to the User Management API.
- Generate an access token (or bearer token) by pasting your private key content into the text box and clicking Generate Token.
- Save all this information such as Client ID, Client Secret, Technical Account ID, Technical Account Email, Org ID, and Access Token safely.
Accessing the User Interface for User Mapping Tool user-interface
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, see Current Release Notes.
-
Select the Adobe Experience Manager and navigate to tools > Operations > Content Migration.
-
Click the User Mapping card.
-
Click Create User Mapping Config.
note note NOTE If you skip this step, users and groups mapping is 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 that the users are being migrated.
note note NOTE To get the Org ID, log on to the Admin Console and choose your organization (in the upper-right area) if you belong to more than one. The Org ID is 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.
note note NOTE The Access Token expires every 24 hours and a new one must be created. To create a token, go back into Adobe Developer Console, choose your project, click User Management API, and paste the same private key into the box.
-
-
After populating the fields, click Test Configuration to test the connection to the User Management API service. If the connection is successful, you can click Save to save the configuration.
-
After saving the configuration, select the configuration and click Start User Mapping.
-
Click Start from the dialog box so you start the User Mapping process.
It displays the Status as RUNNING.
-
After User Mapping is complete, click Results to view the summary.
note important IMPORTANT - After User Mapping is complete, you can navigate back to Content Migration page using the breadcrumb. The User Mapping card displays the status and timestamp. Click Content Transfer so you can create a migration Set to run extraction. See Running the Content Transfer Tool for more details.
Resuming the User Mapping Process resume-user-mapping-process
If the User Mapping process is stopped due to any of the following reasons:
-
The option Stop User Mapping was selected by the user.
-
The access token expired during the process.
-
Or, some other reason.
note note NOTE The progress is saved from where the process stopped.
Follow the steps below to resume the User Mapping process:
-
Click View Log to review the User Mapping log so you can check the saved progress.
-
Click Start User Mapping button again to resume from where it left off.
note note NOTE Ensure before restarting that the access token is still valid or has been refreshed. 
-
Click Start from the dialog box so you resume the User Mapping process.
After the User Mapping process completes, you can view the Status as FINISHED for that specific configuration.
