Skip to content

Integrate Yeastar Workplace with Active Directory

This topic describes how to integrate Yeastar Workplace with Active Directory (AD) using Lightweight Directory Access Protocol (LDAP).


  • Operating System: Windows Server 2008 / 2008 R2 / 2012 / 2012 R2 / 2016 / 2019 / 2022

  • Yeastar Workplace: Pro Plan

Network Scenario

This topic describes how to integrate Yeastar Workplace and Active Directory from different networks, for example, you are using the SaaS version of Yeastar Workplace and the Active Directory is on-premise deployed.

In this case, you need to configure port forwarding on the network where the Active Directory locates to ensure Yeastar Workplace can communicate with your Active Directory (AD) via LDAP protocol.

We provide a diagram to help you understand the integration in a better manner:


For on-premise deployment versions of Yeasatr Workplace that are deployed in the same network as the Active Directory. See Integrate Yeastar Workplace and Active Directory in the same network.


Configure your network

  • Make sure that Yeastar Workplace can access the Active Directory.
  • Forward the following port(s) as needed on the router to pass LDAP(S) requests from Yeastar Workplace to Active Directory.

Gather the following information from Active Directory


  1. Log in to Yeastar Workplace management portal, and go to Integration.

  2. In the Directory Sync section, click Connect beside the Active Directory (AD).

  3. In the Connect to Server section, fill in the following information.

    Settings Description
    Host Enter the public IP address of the Active Directory.

    Specify the communication protocol.

    • LDAP: Unencrypted LDAP communication.
    • LDAPS: Encrypted LDAP communication with SSL.

    Enter the mapped port which is used to pass LDAP(S) request from Yeastar Workplace to Active Directory.

    Base DN Enter the distinguished name of the base entry as the root for LDAP query in Active Directory.

  4. In the Account Verification section, enter the credential of an AD domain account.

    • User Name: Enter the logon name of an AD domain account.
    • Password: Enter the password associated with the user name.
  5. Click OK.


The Integration page displays Connected, indicating that Yeastar Workplace is successfully connected to Active Directory.

The details of the connection are also displayed on this page.

What to do next

Set up synchronization rules to synchronize the desired AD users, organizational units, and groups to Yeastar Workplace. For more information, see Sync AD Users, Ous, or Groups to Yeastar workplace.

Last update: December 9, 2022
Created: November 21, 2022