Synchronize Azure AD Users to Yeastar P-Series Cloud Edition

This topic describes how to customize synchronization rule based on Azure AD users, PBX will create extensions for the Azure AD users specified to be synced accordingly, and keep the extensions up-to-date with changes from the Azure AD users.

Limitation

The number of Azure AD users that can be synced depends on the number of extensions that PBX system can create.

Prerequisites

You have integrated Yeastar P-Series Cloud Edition with Azure Active Directory.

Procedure

  1. Log in to PBX web portal, go to Integrations > Collaboration.
  2. In the User Synchronization section, turn on the switch.

  3. Complete the following synchronization settings according to your need.
    1. In the User Range for Extension Auto Creation drop-down list, specify the Azure AD users that you want to synchronize to PBX and create extensions for them.

      Table 1.
      Option Description
      All Users Synchronize all Azure AD users to PBX and create extensions for them.
      Users of Specific Type Synchronize the specified type(s) of Azure AD users to PBX and create extensions for them.

      You can select the desired user type(s) in the User Type drop-down list.

      • Member: All member users in your organization's directory.
      • Guest: All guest users in your organization's directory.
      Users in Specific Group Synchronize the Azure AD users within the specified group(s) to PBX and create extensions for them.

      You can select the desired group(s) in the Group drop-down list.
      Note: In future use, if you change the range of Azure AD users to be synced, you can decide how to deal with the extensions that are no longer synced from the Azure AD users via the Auto delete the Extensions no longer in sync option.

      • If selected, the extensions will be deleted during the next synchronization.
      • If unselected, the extensions will be retained and fully managed by the PBX.
    2. In the User's Extension Number drop-down list, configure the extension number assignment rule.

      Table 2.
      Option Description
      Assign Automatically

      Assign extension numbers from a specific starting number.

      You can specify the starting number in the Start Extension Number from field.
      Read Specific Property Value

      Assign extension numbers based on users' property value. This can be used in the scenario that Azure AD users already have phone extensions assigned, and you want to keep their extension numbers instead of assigning new ones.

      You can specify the property where the Azure AD users' extension numbers are stored (e.g. businessPhones) in the Property Name field.

      Tip: Refer to Microsoft User Properties for the property name.
    3. In the Delete the Extension when its associated user account is drop-down list, select the Azure AD user account status(es) at which PBX will stop syncing from the Azure AD users, and delete the associated extensions.

      Table 3.
      Option Description
      Disabled If an Azure AD user account is disabled, PBX will stop syncing from the Azure AD user and delete the associated extension.
      Deleted If an Azure AD user account is deleted, PBX will stop syncing from the Azure AD user and delete the associated extension.
    4. On the Auto associate Extensions with the Users that share the same email address option, decide whether to sync Azure AD users to PBX when the users have the same email addresses with existing extensions.
      • If selected, the Azure AD users with same mailboxes will be synced to PBX and associated with the existing extensions, the extensions' user information will then be overwritten by that of the Azure AD users.
      • If unselected, the Azure AD users with same mailboxes will not be synced to PBX as the PBX system does not allow duplicated email addresses.
    5. If you want to send Linkus Welcome Email to the synced Azure AD users, select the checkbox of Send Welcome Email automatically after an extension is created.

  4. Click Save.

    Note:

Result

You have created your custom synchronization rule for Azure AD users.

During a synchronization process, PBX system performs queries within the Azure Active Directory based on the rule, and synchronize the desired Azure AD users as well as the updated information to PBX. After the synchronization, the followings can be implemented:

  • You can check the synchronization result in the User Synchronization section.

  • The PBX extensions associated with Azure AD users come with a label , and can not be manually deleted on PBX.
  • You can NOT manually update the following information of the PBX extensions associated with Azure AD users.
    Note: The information can only be modified within the Azure Active Directory and updated to the PBX during a synchronization.
    • Last name
    • First name
    • Email Address
    • Mobile Number
    • Job Title

What to do next

If you want to allow the synced Azure AD users to log in to Linkus Web Client and Mobile Client using their Microsoft accounts, you need to configure the Single Sign-on (SSO) feature. For more information, see Allow Users to Log in to Linkus UC Clients with SSO.