Get Started: Active Directory Integration (ADI)

JumpCloud is an open directory platform that allows you to manage and secure user identities across multiple protocols, devices, and resources. JumpCloud can integrate with Active Directory Domain Services (AD) using the JumpCloud Active Directory Integration (ADI). ADI enables the syncing of users, groups, and passwords between JumpCloud and on-premise or off-premise AD in flexible configurations to support your specific use case, goals, and AD environment.

This article series presents the different configurations, workflows, and frameworks for leveraging the ADI and JumpCloud 

ADI Configurations and Use Cases

ADI can be configured to support a variety of use cases.  The three (3) most common use cases for ADI are:

  • Extending your AD instance to support additional capabilities in the cloud and great flexibility.
  • Minimizing your AD footprint without replacing your current implementation.
  • Migrating away from AD completely.

There are three (3) possible ADI configurations for syncing data between AD and JumpCloud.  

There is also an Active Directory Migration Utility (ADMU) for migrating device management from AD to JumpCloud.

JumpCloud Terminology & Glossary

Active Directory Integration (ADI)

The full integration that enables the syncing of users, groups, and passwords between JumpCloud and AD. The integration consists of two agents; the Import Agent and Sync Agent. The integration can be configured to use one or both of the agents. Your use case determines which agents are required, the direction of the sync, and which system is the authority.

Active Directory Migration Utility (ADMU)

The JumpCloud Active Directory Migration Utility (ADMU) is a tool that automates the migration of AD domain users to JumpCloud managed users. The utility converts a Windows non-local domain user profile to a local profile, simultaneously leaving the domain and installing JumpCloud.

Import Agent

JumpCloud’s lightweight agent imports user identities and certain security groups from AD to JumpCloud.  It can also be configured to import passwords if installed on DCs.  It can be installed on all the DCs or one or more member servers. t. This agent pushes or sends all user, group, and, if applicable, password changes that have occurred in AD since the last sync to JumpCloud every 90 seconds.

Note:

There may be references to an older term, AD Bridge Agent, in some configurations and logs.

Sync Agent

JumpCloud’s lightweight agent that  pulls user identities, user groups, and passwords from JumpCloud to AD. It can be installed on one or more Domain Controllers (DCs) or member servers within an AD environment that. This agent communicates to JumpCloud from the server(s) every 90 seconds to get all changes that have occurred in JumpCloud since the last sync, for any users and user groups connected to the ADI in JumpCloud.

Primary Identity Provider (IdP)

The directory will be considered as the source-of-truth or the primary or authoritative directory for credentials and user identities.

Forest

A stand–alone instance of AD that contains a collection of one or more domains and acts as the security boundary within an AD environment.

Domain

A single AD domain within a forest that contains a collection of users, security groups, and other AD objects that share a domain name.

Multiple/Sub Domains

Two or more AD domains within a single forest. 

Organizational Unit (OU)

Containers of objects within AD's logical structure in which security groups and users reside and can be nested. OUs are important within the ADI configuration as they are the search base used by the JumpCloud Import and Sync Agents. 

ADI Security Group

The Security Group created by you during the ADI Import installation process and used by the JumpCloud Import Agent to determine which users and groups to sync from AD to JumpCloud. This Security Group will be created in the Configuration article’s instructions.  Only members of this group are synced between AD and JumpCloud.

Root User Container

The main container or path for which all of your target users you’d like to integrate with JumpCloud reside. This can be a top-level OU, a sub-level OU, or the default “Users” container within AD. JumpCloud’s ADI is configured to reference this as the Root User Container for which all users integrated with JumpCloud should reside. The AD Import and Sync agents use this Root User Container as a search base by default. If users are outside of the root User container, or its sub-level OUs, but are bound to the JumpCloud ADI Security Group, then user identity or credential issues may arise between JumpCloud and AD.

Learn More

Ready to Configure?

Check out the next article in this document series, Configure the Active Directory Integration (ADI), to get an overview of the implementation steps for the use case you want to implement within your AD Domain and environment and links to the configuration articles for each use case. 

Want additional assistance from JumpCloud? 

If you’re having issues with getting JumpCloud’s ADI working, try the Troubleshoot: ADI.

JumpCloud now offers myriad professional services offerings to assist customers with implementing and configuring JumpCloud. If you’re looking for assistance with Migrating from AD, or to integrate AD with JumpCloud, we recommend you reach out to JumpCloud’s Professional Services team on the following page: Professional Services - JumpCloud.

Want more information?

Back to Top

Still Have Questions?

If you cannot find an answer to your question in our FAQ, you can always contact us.

Submit a Case