探花大神

The 探花大神 Active Directory Integration (ADI) enables the syncing of users, groups, and passwords between 探花大神 and on-premise or off-premise AD. As covered in Get Started with the Active Directory Integration, the ADI uses two agents: an Import Agent and a Sync Agent that can be installed in three (3) configurations which are based on where you want to manage users, groups, and passwords.

1. Manage users, groups, and passwords in AD.
2. Manage users, groups, and passwords in 探花大神.
3. Manage users and passwords in either system, or both.

This article provides a step-by-step guide for configuring ADI to manage users, security groups, and passwords in 探花大神. This configuration supports organizations looking to have 探花大神 be their Identity Provider to minimize their AD footprint or migrate away from AD completely. 

Deployment Configuration Overview

• Use ADI sync agent only
• Install agents on either domain controllers (DCs) or member servers
• Assign users and user groups to the AD instance in 探花大神

To explore the use cases and benefits of this configuration see Manage user, groups, passwords in 探花大神 in the Configure Active Directory Integration (ADI) help center article.

Workflows

探花大神 Sync Only 鈥� Single Domain Workflow

探花大神 Sync Only 鈥� Multiple Domain Workflow

To learn more about the general user identity workflow and expected behavior for any user, group, and password change after the AD Sync agents have been configured, read Use and Manage the Active Directory Integration (ADI) . 

System Requirements

• 64-bit Windows Server (versions 2012, 2016, 2019, 2022)
  • Server Core installation is also supported for Windows Server versions 2016, 2019, and 2022. You will need to include the /msiexec parameter when running the agent installer
• 15MB disk space
• 10MB RAM

Considerations

• We strongly recommend installing and using LDAPS for the ADI. Configuring and using LDAPS on the Domain Controller that the 探花大神 ADI agents will connect to secures any sensitive information that is exchanged between the 探花大神 agents and the Domain Controller and protects against malicious users.
• Connect Keys are one-time use keys required for installing the sync agent on a new AD server. They are not required when upgrading an existing installation.

• When updating an existing agent installation, only minimal installation screens are shown:
  • Directory for where the installation should occur
  • Finish screen
• Demoting a DC installation to a member server and promoting a member server installation to a DC aren鈥檛 supported. The agent(s) must be uninstalled first and then installed on the other type of server
• Non-standard ASCII characters are not supported in the Root User DN
• The AD Domain and Root User container DN needs to match the Domain and Root User container configured for AD Sync
• The 探花大神 AD sync agent services use TLS for all communication. If no network connectivity exists to 探花大神, the ADI won鈥檛 work properly 
• When multiple AD sync agents are installed, one is designated as the primary agent by the ADI service. All create and change requests are sent to that agent. If that agent becomes unavailable, another active sync agent is automatically designated as the primary
• Password complexity requirements in AD and 探花大神 should be as closely aligned as possible to avoid passwords being rejected and failing to sync due to not meeting the complexity requirements
• The user attributes that sync are:
  • First Name
  • Last Name
  • Username
  • Email
• Groups sync automatically from 探花大神 to AD when one or more sync agents are installed. This sync cannot be disabled
• The passwords for the server accounts used by the integration (e.g., jcimport and jcsync) should be rotated periodically for security reasons
• As of ADI sync agent version 4.x, the following changes were made:
  • The default location for all agent related installation, configuration, and log files is C:\Program Files\探花大神\AD Integration\
  • The ADI sync agent can be installed independently of the ADI import agent
  • The ADI sync agent connect key is encrypted and the value in the registry is replaced with the encrypted value when the agent starts
• Managing , such as Domain Admins, in AD from 探花大神 isn鈥檛 supported.
  • AD flags privileged accounts with 鈥渁dminCount=1鈥� in the directory, which results in any inherited permissions granted to the 探花大神 AD agent services to be removed. This prevents 探花大神 from being able to effectively manage those privileged accounts

Installation Steps Overview

The main steps you will take to install and configure AD for this use case are:

1. Complete the Prerequisite Checklist.
2. Determine the Root User container in AD.
3. Create the AD Sync Service Account.
4. Delegate control for the AD Sync Service Account.
5. Create an AD domain instance in 探花大神.
6. Select your configuration and download the agent.
7. [Optional] Perform a one-time import of users from AD to 探花大神.
8. Run the AD Sync Agent Installation Wizard on AD servers.
9. Verify AD sync.

Prerequisite Checklist

Before installing the ADI sync agent, we recommend completing each item in the following checklist before continuing:

1. Know your AD Domain Admin credentials.
2. Decide whether you want to install the sync agents on your AD domain鈥檚 non-DC Domain Member Servers or Domain Controllers (DCs).
   • If installing on DCs, we recommend that you install the AD Sync agent on your Primary DC and any DC impacted by extended replication delays
3. Verify you have access to all DCs or non-DC Domain Member Servers in the AD domain.
4. Ensure your DCs or non-DC Domain Member Servers are running on a 探花大神 supported 64-bit Windows Server version (2012, 2016, 2019, 2022).
5. Verify DCs or non-DC Domain Member Servers have networking access to the internet and are able to communicate outbound to console.jumpcoud.com over HTTPS port 443. 
6. Create a dedicated Administrator account in 探花大神 that is specifically for the ADI.

7. Verify all users to be synced from 探花大神 to AD have a value for first name and last name in 探花大神.
8. Align password complexity requirements between AD and 探花大神 as closely as possible. Otherwise, passwords may not replicate if they鈥檙e rejected by the destination directory鈥檚 complexity requirements.
9. [Strongly recommended] Install LDAPS.

Prepare for Installing the Agent

To export and update user attributes, passwords and security groups from 探花大神 to AD, you鈥檒l need to install a 探花大神 AD sync agent on your AD domain鈥檚 non-DC Domain Member Servers (member servers) or Domain Controllers (DCs).  Complete the steps below to prepare for installing the agents on your server(s).

Determine the Root User Container in AD

You must specify the Root User Container during the 探花大神 AD sync agent installation. AD鈥檚 default 鈥楿sers鈥� container (CN=Users) is pre-populated in the AD Users and Computers (ADUC) interface and labeled as 鈥淯sers鈥� as shown in the following image. 

If you want to use AD鈥檚 default Root User container, the value you will need to enter during the AD sync agent installation is:

• CN=Users;DC=example;DC=com

If AD鈥檚 default Root User container (CN=Users) isn鈥檛 the Root User Container you want to use for your AD integration, follow the steps below to get the distinguishedName value you will need to enter during the AD sync agent installation. 

1. Verify the full LDAP path for the chosen Root user container you have selected in ADUC:
   1. From the ADUC panel鈥檚 View menu, enable Advanced Features. 
   2. Right-click the container and select Properties. 
   3. Select the Attribute Editor tab. 
   4. Select the 鈥渄istinguishedName鈥� attribute, then click View.
   5. Note the value.  It will need to be entered during the AD sync agent installation. 

Create the AD Sync Service Account in AD

After you identify the Root User Container (鈥楻oot user DN鈥�)  that you want to use with your 探花大神 AD integration, create a new AD-based service account (standard user account) that allows the 探花大神 AD sync agent to manage users and groups.

1. Open the ADUC Menu.
   1. Click start button and type 鈥渄sa鈥� and click the Active Directory Users and Computers icon.
   2. Right click on the container and click New > User.

3. Enter the following values for the 探花大神 Import Service Account user:
   1. First Name - JumpCloud
   2. Last Name - Sync
   3. User logon name - jcsync

4. Click Next
5. Enter a password for the jcsync user and ensure that it is set to Never Expire since this will be a service account for the Sync Agent.

6. Click Save.

Delegate control for the AD Sync Service Account in AD

1. Navigate to the Root User Container in ADUC that you have selected, right-click the container and select Delegate Control. This launches the Delegation of Control Wizard.
2. Click Next.
3. Add the newly created service account user to the Delegation of Control Wizard.

4. Click Next, then select the following tasks:
   • Create, delete, and manage user accounts
   • Reset user passwords and force password change at next logon
   • Read all user information
   • Create, delete, and manage groups
   • Modify the membership of a group

5. Click Next, and then Finish.

Install the AD Sync Agent

Create an ADI instance in 探花大神

Create a new ADI domain instance in 探花大神 if one does not already exist:

1. Log in to the .
2. Navigate to Directory Integrations > Active Directory.

3. Click ( + Add ADI Domain ).
4. Select Manage users and passwords in 探花大神.

5. Enter the name of an Active Directory domain that you want to integrate with your 探花大神 tenant. For example, 鈥�DC=example;DC=com鈥�.

6. Click Save.

Download the Sync agent

1. Click Download Sync Agent.

2. The Sync Agent installer will automatically save to your local Downloads folder.
3. The Install Sync Agent modal appears and you will be presented with the AD Sync Agent Installation Connect Key. This is the unique one-time use key that is required to connect the Sync Agent to your 探花大神 Org and this AD domain Integration within 探花大神. You will input this key during the AD Sync Agent install in the steps below. Click Copy and save it to a password manager for later use.

7. Click Close.
8. Click Configure ADI.
9. A Details page will appear.

10. Click Save.

Perform a one-time import of users from AD to 探花大神 (Optional)

If you need to import all your users or a subset of users from AD to 探花大神, there are two options:

1. Import users using a CSV
2. Install the AD import agent and sync users

Option 1: Import users using a CSV

1. Export all users you want created in 探花大神 to a .csv file
2. Follow the instructions in Import Users from CSV with the PowerShell Module.

Option 2: Install the AD import agent and sync users

1. From the Details tab of the Active Directory Domain instance you create above, expand the Manage users and passwords in either system, or both section.
2. Click the checkbox for This is my use case.
3. Click Download Import Agent.
4. Follow the instructions in Configure ADI to Manage Users, Security Groups, and Passwords in AD.
5. Add all users you want imported into 探花大神 into the ADI security group you created.
6. Verify that the users were created in 探花大神.
7. Open Start > Control Panel > Programs > Programs and Features in AD.
8. Uninstall the 探花大神 AD Import Agent.
9. Click the Domain Agents tab in the Active Directory Domain instance in 探花大神.
10. Verify that all rows are in yellow(i.e no longer active).
11. Click the delete button for each import agent.

Run the AD Sync Agent Installation Wizard

Now you are ready to install the 探花大神 Sync Agent on one or more member servers or your Primary DC and any DC within the domain impacted by extended replication delays.

1. Browse to where you saved the AD Integration Sync installer file on your DC. 
2. Right-click the file, then select Run as administrator.
3. Once the Installer Wizard appears, click Next.
4. On the Destination Folder screen, click Next.

5. Select the type of server on which you are installing the agent, DC or non-DC member server, then click Next.

6. If you chose Domain Controller, skip to step 10.
7. If you chose Member Server as your server type, enter the information for the DC to which the member server should connect to sync data from 探花大神 to AD. We recommend using the FQDN for your DC.

8. Confirm your LDAP connection type and decide if you want to allow the use of LDAP if the connection using secure LDAP fails.

9. If you checked Allow insecure connection (LDAP) to a Domain Controller, if secure connection fails, you must confirm that you understand the risk before you can proceed.

10. Enter in the Root User Container you noted in the  Determine the Root User Container in AD section above. If you鈥檙e using the default AD Root User Container, the value will be CN=Users;DC=company;DC=com. If you鈥檝e chosen another Root User Container, enter the value you noted.
    • In this example, we鈥檝e modified the Root User Container. The value is: OU=Corporate Users;DC=example;DC=com.

11. Enter the AD Sync Agent鈥檚 Service Account you鈥檝e created. This should be the jcsync User Account you created in the Create the AD Sync Service Account section above. Then click Next.

12. Enter the Connect Key that was presented to you within the 探花大神 Admin Portal after downloading the AD Sync Agent. Then click Next.

13. Finally, click the Install button to install the AD Sync Agent. This could take up to 3 minutes. 

Verify AD Sync

Once you鈥檝e installed and configured AD Sync within your AD environment. You can easily verify that the 探花大神 AD Sync Agent is working. Please ensure the following are present and visible: 

• The 探花大神 AD Sync Agent should be shown as green and active within the Admin Portal under Directory Integrations > Active Directory > Domain Integration > Domain Agents tab.

Next Steps

Please read the Use and Manage the Active Directory Integration article next.

Want additional assistance from 探花大神? 

If you鈥檙e having issues with getting 探花大神鈥檚 ADI working, try the Troubleshooting Guide.

探花大神 now offers myriad professional services offerings to assist customers with implementing and configuring 探花大神. If you鈥檙e looking for assistance with Migrating from AD, or to integrate AD with 探花大神, we recommend you reach out to 探花大神鈥檚 Professional Services team on the following page: Professional Services - 探花大神.