AD Connect software
USS AD Connector is a service, that can be installed on a Windows server in your local network in order to synchronize selected AD objects (users, groups and OUs) to the CensorNet USS Cloud Service.
The following operating systems are supported:
- Windows Server 2008 R2 (x64)
- Windows Server 2012 (x64)
- Windows Server 2012 R2 (x64)
- Windows Server 2016 (x64)
The following issues are known in version 2.6 of the USS AD Connector:
- “Primary group” memberships are not synchronized to the USS account
Version 2.6 - USS AD Connector (6 Mb)
Version 2.6 and above supports an automated update system. A notification will be displayed when an upgrade is available and this can be installed using the Upgrade option in the tray icon.
For older versions, you can simply run the latest MSI installer and it will upgrade the existing version.
- Log on to the Windows server using a user account with local administrator rights.
- Copy the USS AD Connector installer (
UssAdConnector-xxx.msi) to a local path on the server.
- Start the installation by double-clicking the MSI setup file.
- A Welcome dialog appears. Click the Next button.
- A dialog with Terms and Conditions of Use appears. Please read the terms carefully. If you accept them:
- Select I accept the terms.
- Click the Next button.
- A dialog appears, for selecting the installation folder. It is recommended to use the proposed default installation folder. In case you want to change the path, click the Change button and select a new path. Click the Next button.
You are now ready to perform the installation per the choices you have made.
- Click the Install button.
A dialog appears showing the progress of the installation.
The dialog below appears when the installation has completed. Click the Finish button.
If you leave the checkbox Launch AD Connector Setup Tool selected, the USS AD Connector Setup Tool will start automatically after the installer is closed.
The USS AD Connector Setup Tool is automatically installed as part of the USS AD Connector installation. By default, it will automatically start after the installation has completed. Additionally, you can always relaunch the tool later, in case you need to do any reconfiguration. The tool is located in the Windows Start menu as USS AD Connector Setup Tool:
The first time the tool is started, it will show an empty list of USS accounts:
In order to initiate synchronizations from your local Active Directory to your USS account(s), you need to enter valid credentials for each USS account(s) you wish to sync with. To do so, follow the procedure below:
- In the Add new account group box, enter Username and Password for your USS account, then click the Add button.
The credentials entered will appear as an entry in the listbox:
The USS AD Connector background service will download the available Local Sync configuration(s) and immediately start synchronizing AD objects, according to the Local Sync configuration defined in the account that you entered the credentials for.
- If you want to synchronize AD objects for several USS accounts, please repeat the process above to add credentials for additional USS accounts.
REG ADD "HKLM\SOFTWARE\CENSORNET\USS\AdConnector" /v "UsersSyncInterval" /t REG_DWORD /d 60(change 60 to any unit of seconds for the interval you require). You must restart the "CensorNet USS AD Connect" service after adding the registry key.
The Connector Setup Tool provides two options to assist with troubleshooting:
By default, the USS AD Connector Service will check for new or updated Domain Settings in USS every 30 minutes. Click this button to force an immediate refresh of the USS Domain Settings
Click this button to verify the connection to the CensorNet USS Cloud Service, and validate (all) credentials entered in the Setup Tool. Useful for troubleshooting.
If neither of these options help to resolve the problem, you should check that the AD Connector service is running and look for any entries in the Event View for further information, by following the steps below.
The USS AD Connector runs as a Windows background service. To verify whether it is executing successfully, you can make use of the Services management console and the Event Viewer management console.
When opening the Services management console (
services.msc), the USS AD Connector will appear as CensorNet USS AD Connector Service:
As with any other background service, you can start and stop the service, and inspect its current state in the Status column.
When opening the Event Viewer management console (
eventvwr.msc), please look for the USS AD Connector event container below the Applications and Services Logs node:
This event container contains entries with relevant information for troubleshooting the USS AD Connector background service. You can inspect these event entries to verify whether AD synchronizations are completing successfully or failing. In case of failures, please inspect the information in the event entries for further details.
For further assistance please contact your Service Provider.