Skip to main content

Active Directory Integration

How to connect and setup Active Directory

Updated over a week ago

Active Directory integration

Active Directory (AD) integration allows you to seamlessly synchronize employee data into VMC. Once installed, VMC will:

  • Sync User Information – First name, last name, email, and mobile number.

  • Override Existing Data – If an email already exists, it will be updated with the latest information.

  • Password Reset for New Users – Newly synced users must reset their password before logging in.

  • Default User Roles & Notifications – Synced users are assigned the “User” role and inherit default notification settings.

System Requirements

  • Windows machine

  • PowerShell 3.0+ installed on your Windows PC

Install Active Directory:

1️⃣ Log in to VMC as an Administrator.
2️⃣ Click on your profile icon (bottom left) and go to Settings.
3️⃣ Navigate to Integrations.


4️⃣ Under the Employee Directory group, locate Active Directory and click Enable/Configure.


5️⃣ Follow the on-screen instructions to complete the setup.

Run Your Sync

1️⃣ Copy the CRON script and save it as go-ad-sync.ps1 on your Windows machine.
2️⃣ Configure the correct Organizational Units (OUs) and set where temporary files will be stored.
3️⃣ Run the script via Windows PowerShell to verify successful synchronization.
4️⃣ Check the Status tab in VMC for sync details.
5️⃣ Schedule the script to run automatically using Windows Task Scheduler.

  • Run the script via Windows Powershell to verify that the script is correctly syncing users with VMC. You should go to the Status tab to see details about your last sync run.

  • You can run the script as a Windows task by using Task Scheduler.

Troubleshooting

VMC supports TLS version 1.3 only. If you get the following error:

Failed: System.Net.WebException – The request was aborted: Could not create SSL/TLS secure channel

Please add the following code to your script just before the Invoke-RestMethod:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls13

As per the screenshot below:

Did this answer your question?