My1Login Migration Tool

My1Login Migration Tool

The migration tool allows admins to map users' bookmarks to users in a different My1Login account, within an account to a child account, or from users who are AD joined to users who are Entra joined. 

The migration tool allow admins to create migration keys and carry out the bookmark transfer process in bulk by uploading a CSV file. The bookmarks are copied rather than completely transferred so a copy will remain in the original account until deleted. 
For simplicity, in the example below we will call the original account containing bookmarks Account A, and the second account that bookmarks are to be copied to Account B. 
My1Login will guide you through the migration process. The below gives you the information you need to know what to expect. 

Enabling the Migration Tool

In order to start a migration, My1Login will need to activate this on your account(s). Please contact your CSM or support@my1login.com to make this request. 

Migration Keys

Description

A migration key is generated by one account to be shared to a second account. This grants the second account permission to copy bookmarks to the original account.

Migration keys are only needed to migrate bookmarks to a different account. If a user plans to migrate bookmarks in bulk to users in the same account, the entire migration key section can be skipped.

Generating Key

Logged in as the admin of Account B, click Migration Tool → Generate Migration Keys.

On the Generate Migration Keys screen, click the Generate Migration Key button.



Enter the Account Identifier of Account A. This can be found by logging into the admin dashboard of Account A, then clicking Security → API Key Management.

Confirm that the account is correct by selecting the account from the dropdown below the text box, and select how long the key is valid for.


Click generate and the key should appear in the list. The key value should be available to copy or view.


Enter Generated Key on Second Account

Logged in as the admin of Account A, click Migration Tool → Managed Received Keys, and click the Enter Migration Key button.





Enter the generated key and click Submit.


The key will now be activated and will show in the list.


This now allows Account A to select Account B when migrating bookmarks, either via the bulk migration tool or via the Transfer Bookmarks screen within the User Management menu.

Account B now appears in list of valid accounts on Transfer Bookmarks screen

Bulk CSV Upload

Download CSV Template with user list

Logged in as the admin of Account A, click Migration Tool → Bulk Migration Tool

Click “Download CSV Template” to download a template CSV containing usernames and user types.



Fill in the CSV:

When uploading, the web application will limit the migration to 500 users at most, if you plan to migrate more than 500 users you will need to separate the users into extra copies of the template.

  • In the receiving_username and receiving_user_type fields, fill on the respective user to migrate bookmarks to.

  • in the remaining columns, fill in “yes” or “no” to indicate which types of bookmarks should be migrated

  • if the all_applications column is marked “yes”, then the remaining columns are disregarded,as the user has indicated that all applications should be migrated regardless of their type.


The format of the template CSV
The populated CSV template, now ready for upload

Upload CSV

Logged in as the admin of Account A, click Migration Tool → Bulk Migration Tool

Select Account B from the dropdown and upload the CSV file. Click Upload.


CSV Validation

The CSV will then be validated. If any errors are found, then the migration will not be able to proceed.

Possible errors include:

  • user not found

  • random text entered into the bookmark type fields (should be “yes/no”, “y/n”, “t/f” or “true/false”)

  • unknown user type specified (should be “Web”, “AD” or “Entra”)

Rows containing errors will be shown by default. To see successfully validated rows as well, click the “Show All” button.

An example of a validation error
The “Show All” box can be checked to show validated rows with no errors

Once all rows have been successfully validated with no errors, click Proceed.


Follow Migration Progress

Logged in as the admin of Account A, click Migration Tool → Migration Progress

A list of migration tool jobs will be displayed, along with their status. This screen can be used to follow migration progress.

Migration job progress can be viewed from the Migration Progress screen

Once a job has succeeded for a user, the bookmarks should appear in their vault.

Each migration job represents a single user migration, and each job has a max limit of 200 bookmarks. If a migration is attempting to migrate more than 200 bookmarks, then the bookmarks will be split into several jobs. For example, if a user has 530 bookmarks to be migrated, then three jobs will be created, each containing 200, 200, and 130 bookmarks respectively.


    • Related Articles

    • Troubleshooting: A user is unable to login to My1Login

      If a user is unable to login to My1Login, below are a simple set of checks to troubleshoot. Valid User: Check the user is registered with an account associated with your company. This could be either an email account or an Active Directory account. ...

    • SSL Certificates - Windows Certificate Service

      To allow a seamless SSO experience (via a hidden SAML login to My1Login) it is necessary for the ADC to have an HTTPS binding on its internal endpoint. This is because the SAML login to My1Login must communicate with the ADC from the user’s browser ...

    • Single Sign On with Entra into My1Login

      There are a few different ways you can initiate Single Sign On (SSO) with Entra depending on how the customer environment is set up. My1Login can give advice on which option will suit you best. User initiated SSO The user browses to their whitelabel ...

    • Entra Directory Sync (EDS)

      The Entra Directory Sync (EDS) is the application which syncs users in an Entra ID Directory with My1Login. Prerequisite: This guide assumes you have already registered the EDS application in Azure. If you haven’t please follow the guide below first: ...

    • How the Active Directory Connector (ADC) works

      How the Active Directory Connector (ADC) works The My1Login Active Directory Connector (ADC) extends your AD domain into the My1Login cloud Identity registry enabling seamless single sign on to the My1Login system. The ADC supports bi-directional ...