从 Microsoft Entra ID 同步用户到 Yeastar P 系列 IPPBX

本文介绍如何自定义基于用户的同步规则。PBX 会根据此规则从 Microsoft Entra ID (Azure AD) 中同步指定的用户，为同步的用户创建 PBX 分机，并自动将同步用户的变更同步到 PBX 分机。

数量限制

可从 Microsoft Entra ID 中同步的用户数量取决于 PBX 系统支持创建的分机数量。

前提条件

你已完成 Yeastar P 系列 IPPBX 和 Microsoft Entra ID 的对接。

操作步骤

你可以批量同步指定范围内的 Microsoft Entra ID 用户并自动为其分配 PBX 分机，也可以同步指定用户并逐一为其分配分机。

根据你的需要，按照以下对应说明进行配置：
同步指定范围内的 Microsoft Entra ID 用户
  1. 登录 PBX 管理网页，进入 应用对接 > 协同办公平台集成。
  2. 在 用户同步 栏，打开开关。

  3. 在 同步用户范围 下拉列表，指定要将哪些用户从 Microsoft Entra ID 同步到 PBX，并为其创建分机。

    选项 说明
    所有用户 将所有用户同步到 PBX，并为其创建分机。
    指定类型的用户 将指定类型的用户同步到 PBX，并为其创建分机。

    可在 用户类型 下拉列表中选择想要的类型。

    • 成员：组织目录中的所有成员用户。
    • 来宾：组织目录中的所有来宾用户。
    指定组内的用户

    将指定组中的用户同步到 PBX，并为其创建分机。

    可在 组 下拉列表中选择想要的组。
    注： 在后续使用中，如果修改了要同步的用户范围，你可以通过 自动删除不再同步的分机 选项，决定如何处理不再从 Microsoft Entra ID 中的用户同步信息的 PBX 分机。

    • 若勾选此项，分机将在下一次同步中被删除。
    • 若不勾选此项，分机保留，且不再受目录同步影响，完全由 PBX 管理。
  4. 在 用户分机号 下拉列表，设置分机号码分配规则。

    选项 说明
    自动分配 从特定号码开始分配分机号。

    可在 起始分机号 字段中设置起始号码。
    读取指定属性值 根据用户属性的值分配分机号。这适用于 Microsoft Entra ID 中的用户已有分机且不想变更这些分机号码的情况。
    可在 属性名称 中指定存储了 Microsoft Entra ID 用户分机号码的属性，例如 businessPhones。
    提示： 属性值可参见 Microsoft 用户属性。
  5. 在 用户账户为以下状态时，自动删除分机 下拉列表，选择 Microsoft Entra ID 的用户账户状态。PBX 将停止从指定状态的 Microsoft Entra ID 用户中同步信息，并删除与之绑定的分机。

    、

    选项 说明
    禁用 如果用户账户在 Microsoft Entra ID 中被禁用，PBX 停止从该用户中同步信息，并删除绑定的分机。
    删除 如果用户账户在 Microsoft Entra ID 中被删除，PBX 停止从该用户中同步信息，并删除绑定的分机。
  6. 在 自动绑定邮箱一致的分机和用户 选项，决定在 Microsoft Entra ID 用户与现有分机具有相同邮箱时，是否将用户从 Microsoft Entra ID 同步到 PBX。
    • 若勾选此项，具有相同邮箱的 Microsoft Entra ID 用户将被同步到 PBX 并与现有分机绑定，分机的用户信息会被 Microsoft Entra ID 用户的信息覆盖。
    • 若未勾选此项，具有相同邮箱的 Microsoft Entra ID 用户不会被同步到 PBX，因为 PBX 系统不允许重复邮箱。
  7. 如果你想要系统自动给同步的 Microsoft Entra ID 用户发送 Linkus 欢迎邮件，勾选 分机创建后，自动发送欢迎邮件。
  8. 在 字段匹配 栏，选择并映射需要同步的用户信息对应的字段。
    注： 参考 Microsoft 用户属性 填写 Azure Active Directory 字段。

  9. 点击 保存。
    注：
同步指定的 Microsoft Entra ID 用户
  1. 登录 PBX 管理网页，进入 应用对接 > 协同办公平台集成。
  2. 在 用户同步 栏，打开开关。

  3. 在 同步用户范围 下拉列表，选择 指定用户。

  4. 在 搜索条件 下拉列表，设置 PBX 搜索 Microsoft Entra ID 用户的搜索范围。

  5. 点击 搜索用户。

    PBX 在指定范围内搜索 Microsoft Entra ID 用户，并显示在 搜索结果列表 中。

    提示： 你可以直接在右上角的 搜索 框中通过输入用户名快速定位到具体 Microsoft Entra ID 用户。
  6. 勾选想要同步的 Microsoft Entra ID 用户，然后点击 同步至PBX。

    所选 Microsoft Entra ID 用户被添加到 用户同步列表 中。

  7. 在 Microsoft Entra ID 用户右侧的 绑定分机 下拉列表中，选择要分配给 Microsoft Entra ID 用户的分机。

    提示： 要将此处同步的 Microsoft Entra ID 用户和 PBX 分机解绑，可选择所需的 Microsoft Entra ID 用户后点击列表顶部的 解除绑定关系。保存设置后，即可成功解绑 Microsoft Entra ID 用户与 PBX 分机。
  8. 在 用户账户为以下状态时，自动删除分机 下拉列表，选择 Microsoft Entra ID 的用户账户状态。PBX 将停止从指定状态的 Microsoft Entra ID 用户中同步信息，并删除与之绑定的分机。

    、

    选项 说明
    禁用 如果用户账户在 Microsoft Entra ID 中被禁用，PBX 停止从该用户中同步信息，并删除绑定的分机。
    删除 如果用户账户在 Microsoft Entra ID 中被删除，PBX 停止从该用户中同步信息，并删除绑定的分机。
  9. 如果你想要系统自动给同步的 Microsoft Entra ID 用户发送 Linkus 欢迎邮件，勾选 分机创建后，自动发送欢迎邮件。
  10. 在 字段匹配 栏，选择并映射需要同步的用户信息对应的字段。
    注： 参考 Microsoft 用户属性 填写 Azure Active Directory 字段。

  11. 点击 保存。
    注：

执行结果

你已自定义 Microsoft Entra ID 用户的同步规则。

在同步过程中，PBX 系统将根据设置的同步规则在 Microsoft Entra ID 中进行查询，并将指定的用户及其最新信息从 Microsoft Entra ID 同步到 PBX。同步完成后，实现如下：
  • 可在 用户同步 设置栏中查看同步的结果。

  • 与 Microsoft Entra ID 用户绑定的 PBX 分机带有 标识，且无法在 PBX 上手动删除。
  • 你无法手动变更与 Microsoft Entra ID 用户绑定的 PBX 分机的以下信息。
    注： 这些信息只能在 Microsoft Entra ID 中修改，并在同步中更新到 PBX 上。
    • 名字
    • 姓氏
    • 邮箱地址
    • 手机号码
    • 职位

后续操作

如果你想要允许同步的 Microsoft Entra ID 用户使用其 Microsoft 账户登录 Linkus UC 客户端，你需要配置单点登录 (SSO) 功能。更多信息，请参见 允许用户通过 SSO 登录 Linkus UC 客户端。