18.12 Organizational Structure Synchronization

The organizational structure synchronization feature allows the AD domain structure to be synced to the AnySecura server. Computers and users in the AD domain that are not yet connected to the server can be pre-assigned to groups. When a client connects to the server, it is automatically placed into its designated group.

Select Tools -> Server Management -> Organizational Structure Synchronization to access the Organizational Structure Synchronization management interface.

18.12.1 Synchronization Configuration

Select Organizational Structure Synchronization -> Synchronization Configuration to add, modify, delete, or execute synchronization for AD or LDAP servers. You can also view the synchronization configuration details.

Icon	Description
	Add a synchronization configuration.
	Modify the selected synchronization configuration.
	Delete the selected synchronization configuration.
	Execute the selected synchronization configuration immediately.
	View the selected synchronization configuration to see its execution results; if none is selected, display results for all configurations.

Add Configuration

Click the icon or select Add Configuration from the right-click menu in the Synchronization Configuration interface to create a new synchronization configuration. When adding a configuration, you need to set the AD connection and specify the synchronization targets.

Parameter	Description
Connection Settings	Enter AD or LDAP server details so the server can connect and retrieve the organizational structure.
Configuration Name	Name of the configuration; if left blank, the domain name will be used by default.
Server Type	Select the server type: Domain Server or LDAP Server.
Domain Name	The domain name of the server to be synchronized.
Domain Server Address	The IP address of the server to synchronize. If LDAP Server is selected, click Advanced to configure the LDAP port, protocol version, SSL usage, and whether to use anonymous connection. If Anonymous Connection is not checked, manually enter the specified username and password. Username format: cn=xx,ou=xx,dc=xx,dc=xx Example: For LDAP domain Dep.com, with user userA in group Sales, to log in as userA, enter: cn=userA,ou=Sales,dc=Dep,dc=com Password: Enter the password corresponding to userA.
Login Account	If a Domain Server is selected, enter a domain user account authorized to access the AD structure.
Password	Password for the AD domain login account.
Enable Automatic Synchronization	Default is unchecked. Check this option and set the synchronization interval to enable automatic synchronization according to the specified interval.
Object Settings	Specify which domain objects (including domain computers and users) are synchronized to designated locations on the server. A single synchronization configuration can contain multiple object settings, enabling multiple synchronization relationships. Icons at the top-right of the Object Settings section allow Add, Modify, Delete, and Preview actions. Click the icon to add an object setting. Detailed parameter explanations are provided below.
Source Settings	Configure the source for the domain synchronization, specifying which organizational units (OUs) in the domain to synchronize.After configuring the connection settings, click Test Connection. Only when the connection succeeds can the source settings be selected.
Source Selection	Click the icon button to choose the groups to synchronize. Multiple selections are supported, but cross-level selection is not allowed.
Exclusion List	Click the icon button to select objects to exclude from synchronization. Excluded objects will not be synchronized. You can select one or more computers, users, or organizational units, including across levels.
Target Settings	Specify where the selected domain organizational units will be synchronized in the console. Supports synchronization to computer groups and user groups.
Computer Group	Click the icon button to select the target computer group in the console for synchronization. The selected source structure will sync to this target, and domain computers will be automatically assigned to the corresponding group after installing the client.When setting the computer group, a synchronization mode must be selected. See the Synchronization Mode section for details.
User Group	Click the icon button to select the target user group in the console for synchronization. All users in the selected source structure will be synchronized to this target location.
Other Settings	Miscellaneous settings
Do Not Import Empty OUs	If checked, OUs with no objects in the source will not be imported; if unchecked, all selected OUs will be imported. Checked by default.
Sync Only Source Computers	Only clients corresponding to computers in the source domain OUs are synced to the console’s computer groups.
Sync Only Source Users	Only clients corresponding to users in the source domain OUs are synced. When a client connects, the logged-in user is matched to the source users; if a match is found, the client is synced to that user’s group. If no match, the client is placed in “Ungrouped.”
Sync Source Computers and Users (User Priority)	Synchronize client machines to the console’s computer group based on both computers and users from the source domain organizational units.After a client installs the client software and connects to the server, the logged-in user on the client is first matched against the source users. If a match is found, the client is synced to that user’s group in the source; if no user match is found, the client computer is then matched against the source computers. If a computer match is found, the client is synced to that computer’s group in the source. If neither user nor computer matches, the client is assigned to the ungrouped category.
Sync Source Computers and Users (Computer Priority)	Synchronize client machines to the console’s computer group based on both computers and users from the source domain organizational units. After a client installs the client software and connects to the server, the client computer is first matched against the source computers. If a match is found, the client is synced to that computer’s group in the source; if no computer match is found, the logged-in user on the client is matched against the source users. If a user match is found, the client is synced to that user’s group in the source. If neither computer nor user matches, the client is assigned to the ungrouped category.

18.12.2 Synchronization Logs

Select Organization Structure Sync -> Synchronization Logs to view logs of organizational structure synchronization.

The synchronization log contains the following details:

Synchronization logs can be queried using the following criteria:

18.12.3 Exception Objects

For computers or users that need to be assigned to specific groups and should not follow the AD organizational structure, they can be set as exception objects. During manual or automatic synchronization, exception objects will not be synchronized.

Select "Organization Sync -> Exception Objects" to add, modify, or delete exception objects. Once the AD organizational structure has been synchronized to the server, manually moving a computer or user within the synchronized range in the console's structure tree will trigger a confirmation prompt. Confirming the move will automatically set these objects as exception objects.