Note: This migration guide contains out-of-date information. We’re in the process of updating it with the latest approach to migrating from Active Directory®. For now, you can reach out to a technical specialist at JumpCloud for a 1:1 demo or visit our Knowledge Base.

Ready to Replace Active Directory?

You are on the verge of implementing JumpCloud, but moving away from Active Directory is no trivial task. You have questions! This short guide will walk you through the process and help answer those burning questions such as “How do I start the process of migrating my users identities out of Active Directory and into JumpCloud? What’s involved, who’s involved, and how long will it take?”

Preparing to Migrate

Directories are the core of your network. They are the technology responsible for authenticating and then authorizing your employees with the resources they need to access.

Because the directory is so critical, it is important to educate your user base on the forthcoming changes to your new JumpCloud Directory. We offer pre-made email templates that make it easy to keep your users informed.

Replacing Active Directory may seem daunting, but it’s a process we help organizations complete successfully every day. You can do this. Let’s begin.

Migrating to JumpCloud Directory-as-a-Service in 5 Steps

Migrating user accounts from Active Directory to JumpCloud

Identities are at the core of JumpCloud’s directory service. In order to simplify the re-creation of your identities currently managed in Active Directory, Jumpcloud can import user accounts and associated information into its directory. This will enable you to begin running certain authentication chores with selected resources nearly immediately. Here’s how:

A. Exporting AD Users to CSV

AD users can be exported to CSV using this code:

  • PS C:\Users\Administrator> import-module activedirectory
  • PS C:\Users\Administrator> Get-ADUser -filter * -Properties GivenName,Surname,SamAccountName,userPrincipalName | Select GivenName,Surname,SamAccountName,userPrincipalName | Export-CSV c:\Windows\temp\userlist.csv

This will result in a CSV that will have the first four fields populated. In order to be imported into JumpCloud via our CSVImporter, you will need to have a total of nine fields. You can simply add five additional blank fields:

Or use the remaining fields to continue building user data, including User ID (UID), Group ID (GID), admin privileges, and tagging users to systems:

B. Importing CSV into JumpCloud

JumpCloud provides an importer utility to streamline this process. You can download the latest API Utility rollup on GitHub and use the CSVImporter_os_arch file. Here is the code for importing users on a Windows machine:

  • PS C:\Users\Administrator\Downloads> .\CSVImporter_windows_amd64.exe
  • Usage of ./CSVImporter:
  •  -csv=””: -csv=<filename>
  •  -key=””: -key=<API-key-value>
  • PS C:\Users\Administrator\Downloads> .\CSVImporter_windows_amd64.exe -csv=”PATH_TO_CSV” -key=”YOUR_API_KEY”

With that, you’ve imported your users into JumpCloud. But keep in mind that this will have no effect on existing accounts until the user is associated with a resource (Step 3).

Questions? We’re Here to Help

Every infrastructure is unique. We’re always available to answer any questions about your Active Directory migration. Here’s what you can do to keep moving forward:

If you want more in-depth instructions, you can dive into the full Migration Strategy and Implementation Guide (pdf).