Synchronize Active Directory Groups to Yeastar P-Series Software Edition
This topic describes how to customize the synchronization rule based on Active Directory (AD) groups, so as to synchronize desired AD groups to the PBX extension groups.
Limitation
The number of AD groups that can be synced depends on the extension groups that PBX system can create (up to 63 extension groups).Prerequisites
You have integrated Yeastar P-Series Software Edition with Active Directory .
Procedure
- Log in to PBX web portal, go to .
- Scroll down to the Group Synchronization section, turn on the switch.
- In the Synchronize for field, specify the AD groups
that you want to synchronize to PBX.
Table 1. Option Description All Groups Synchronize all AD groups within the connected directory to PBX. Specific Group Type Synchronize the specified type(s) of AD groups to PBX.
You can select the desired type(s) of AD groups from the Type drop-down list.- Security Group: All security groups in the Active Directory.
- Distribution Group: All distribution groups in the Active Directory.
Groups Searched by Filter Synchronize the AD groups that match the search filter to PBX. You can specify the LDAP search criteria in the Search Filter for Group field to locate specific groups.
For example, enter (&(objectCategory=group)(cn=sales*)) to search groups with the name starting with "sales".
Note: In future use, if you change the range of AD groups to be synced, you can decide how to deal with the extension groups that are no longer synced from the AD groups via the Auto delete the Extension Groups no longer in sync option.- If selected, the extension groups will be deleted during the next synchronization.
- If unselected, the extension groups will be retained and fully managed by the PBX.
- Click Save.Note:
- If it is the FIRST time you save the synchronization-related settings, PBX will perform the initial synchronization immediately.
- Otherwise, you can manually perform a directory synchronization or wait for the automatic directory synchronization.
Result
You have created your custom synchronization rule for AD groups.
During a synchronization process, PBX system performs LDAP queries within the Active Directory based on the rule, and synchronize the desired AD groups as well as the updated information to PBX. After the synchronization, the followings can be implemented:
- You can check the synchronization result in the Group Synchronization section.
- The extension groups associated with AD groups come with a label , and can NOT be deleted.
- You can NOT manually update the name and group member of the extension
groups associated with AD groups.Note: The information can only be modified within the Active Directory and updated to the PBX during a synchronization.