本文描述了如何在 Webex for Cisco BroadWorks 中部署目录同步。 本文适用于合作伙伴组织的服务商管理员。
目录同步概述
目录同步可确保Cisco BroadWorks 版 Webex 用户可以使用 Webex 目录(通过 Webex 应用程序)来呼叫 BroadWorks 服务器上的任何呼叫实体。 此功能将用户预配置中不包含的 BroadWorks 呼叫信息同步到 Webex 目录。
Webex for Cisco BroadWorks 用户设置将使用 Webex for Cisco BroadWorks 用户的呼叫详细信息(主电话号码、移动电话号码、分机)更新 Webex 目录,但省略外部呼叫记录。 但是,启用目录同步后,该功能还会将以下呼叫记录同步到 Webex 目录。
纯 BroadWorks 呼叫用户(未载入 Webex)
非用户呼叫实体(例如,会议室电话、传真机、寻线组号码)
BroadWorks 电话列表条目
下表总结了 BroadWorks 呼叫记录,并显示了它们如何添加到 Webex 目录中。
BroadWorks 呼叫记录 |
描述 |
已通过以下方式添加到 Webex 目录... |
---|---|---|
适用于Cisco BroadWorks 用户的 Webex |
已为用户启用 Webex for Cisco BroadWorks |
用户预配置(例如,流式预配置) |
纯 BroadWorks 呼叫用户 |
呼叫以下用户:不已在线加入 Webex |
目录同步 |
非用户主叫实体 |
例如,会议室电话、传真机、寻线组号码 |
目录同步 |
BroadWorks 电话列表 |
BroadWorks 电话列表条目:
|
目录同步(电话列表同步) |
有关用户设置的更多详细信息,请参阅Webex for Cisco BroadWorks 解决方案指南。
|
目录同步条件
合作伙伴管理员必须在合作伙伴级别启用该功能。 合作伙伴管理员可以在一次操作中为多个客户组织开启或关闭此功能。
缺省情况下,初始同步会在启用同步后的下一周执行(所选的同步开始时间是随机的)。 但是,客户组织可以使用立即同步为给定的客户组织跳过一周的等待期并触发立即同步的选项。
缺省情况下,每个客户的目录同步每周运行一次。 每次同步都在最后一次同步之后的一周发生,无论最后一次同步是安排还是手动触发立即同步。
每个 BroadWorks 群集最大数量可同时进行两个同步: 一个预定同步和一个按需同步(通过 API 或 Partner Hub GUI)。 但是,管理员不能从同一个 BroadWorks 同时运行两个按需同步。 无论是通过 API 还是通过立即同步Partner Hub 中的选项。 此外,Webex 不会安排两个已安排的同步从同一个 BroadWorks 同时运行。
如果发生同步失败,Webex 每 24 小时自动重新尝试一次同步,直至下次安排的同步。
同步将忽略没有电话号码的用户。
在 Partner Hub 中,您可以查看给定客户的同步状态信息。 此外,您还可以将上次同步的详细信息导出为 CSV 记录。 CSV 记录提供比 Control Hub 显示更多的详细信息,有助于进行故障排除、分析和审核。
Webex 以加密格式存储用户联系人。 只有拥有联系人的用户才能访问解密密钥。
对于纯 BroadWorks 呼叫用户和非用户呼叫实体,此功能从 BroadWorks 同步以下电话号码类型:
主要电话号码
移动电话号码
分机号
但是,如果主电话号码或分机都不存在,同步会从同步中排除纯 BroadWorks 呼叫用户和非用户呼叫实体。
BroadWorks 电话列表和联系人最大值
目录同步还会将 BroadWorks 电话列表条目同步到 Webex 联系人。 同步的条目将添加到以下联系人类型之一:
组织联系人 - Webex 针对组织存储这些联系人。 每个用户都可以访问其组织的组织联系人。 最大值为 30000 个联系人。
用户联系人 - Webex 存储用户联系人。 只有拥有联系人的用户可以访问联系人条目。 最大值为 2000 个联系人(1500 个同步联系人 + 500 个手动输入联系人)。
只有电话列表条目会添加到 Webex 联系人。 目录同步中包含的纯 BroadWorks 呼叫用户和非用户呼叫实体不会添加到联系人,除非 Webex 用户手动将其添加到联系人。
|
下表将 Webex 联系人类型与联系人源(从 BroadWorks 电话列表同步或手动添加)映射:
Webex 联系人类型 |
联系人来源 |
最大值 |
从 BroadWorks 同步... |
用于同步的 API |
---|---|---|---|---|
组织联系人 |
目录同步 |
30000 个联系人 |
企业通用电话列表 |
|
组通用电话列表(对于服务商组)** |
|
|||
用户联系人 |
目录同步 |
1500 名联系人 |
个人电话列表 |
/directories/personal |
由用户手动添加 |
500 名联系人 |
不适用 |
不适用 |
|
群组联系人 |
目录同步 |
每组 30000 个联系人 |
组通用电话列表(对于企业组)** |
/directories/groupcommon |
**组通用电话列表条目同步取决于 BroadWorks 处于企业模式还是服务商模式。 参数值(true 或 false)
|
以下条件适用于目录同步处理联系人上限的方式:
如果组织超出同步允许的最大联系人数(每组 30000 个组织联系人或 30000 个组公共联系人),目录同步将排除高于最大阈值的条目。 没有特定的顺序应用于同步或省略的联系人。
如果您的一个客户超过任一类别中允许的最大联系人数,我们建议您向Cisco提出案例,将该组织从目录同步中排除。
手动联系人是用户在 Webex App 上手动添加的联系人。 一个用户最多可以添加 500 个手动联系人。 手动联系属于 Webex 上较大的用户联系类别,但不包含在同步中。
组织联系 (30000) 和组联系 (每个组 30000) 的总组合限制为 200000。
更新
以下是 Webex 目录处理更新的方式:
如果 BroadWorks 上的联系人姓名发生更改,则将从 Webex 目录中删除现有联系人并创建新联系人。
如果 BroadWorks 上的联系人号码发生变化,Webex 将使用新号码更新 Webex 目录中的现有联系人。
当管理员在 BroadWorks 上更新联系人后,以下情况概述了更新何时显示在用户的 Webex 应用程序中:
如果更新是针对纯 BroadWorks 呼叫用户或非用户呼叫实体,则更新会在后续目录同步后立即显示在用户的 Webex 应用程序中。
如果更新是 BroadWorks 电话列表条目:
对于用户联系人 - 更新在后续目录同步后立即显示在用户的 Webex 应用程序中。
对于组联系人 - 更新在后续目录同步后立即显示在用户 Webex 应用程序中。
对于组织联系人 - Webex 目录会在后续目录同步时更新,但用户要等到重新启动 Webex 应用程序或本地 72 小时缓存计时器到期时,才会在 Webex 应用程序中看到更改。
Webex for Cisco BroadWorks用户信息更新将作为设置过程的一部分进行处理。
|
Control Hub 包含一个选项,用于在 Control Hub 中通过CSV 文件添加或编辑组织级别的联系人。 合作伙伴管理员和具有 Control Hub 访问权限的客户管理员可以访问此选项。 但是,Webex for Cisco BroadWorks 不支持通过 Control Hub 更新联系人。 Control Hub 中应用的联系人更新不会同步回 BroadWorks,并且不可用于座机的目录搜索。
|
目录同步先决条件
我们建议您使用以下设置:
以下示例假定您使用的是 XSP 服务器。 对于 ADP 服务器,将 (XSP_CLI) 替换为 (ADP_CLI)。
|
速率限制值—设置以下 OverloadControl 系统属性 (XSP_CLI/Applications/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit—设置为空值。
globalDirectoryTransactionLimit—设置为空值。
建议您将 userDirectoryTransactionLimit 和 globalDirectoryTransactionLimit 设置为空值。 但是,如果您决定分配值,则每个值都必须设置为至少五倍于 transactionLimitPeriodSeconds 的值(应该是 1)。交易限制—设置以下值 (XSP_CLI/System/CommunicationUtility/DefaultSettings):
userTransactionLimit - 设为至少 100。
transactionLimitPeriodSecs - 设为 1。
寻呼值—设置寻呼系统属性 (XSP_CLI/Applications/Xsi-Actions/Paging):
defaultPageSize—设为 50
availableUserMaxLimit—设为 100
CTI 接口—确保将 Webex CA 证书上传到 CTI 接口信任库,并启用 CTI 接口上的客户端验证。
此外,在启用此功能前,我们建议根据您的 BroadWorks 发行版对 BroadWorks 部署应用以下系统补丁:
对于 R22:
AP.as.22.0.1123.ap368517
对于 R23:
AP.as.23.0.1075.ap368517
对于 R24: 无需任何补丁
启用目录同步(新模板)
合作伙伴管理员可以在创建新模板时为客户模板启用目录同步。 任何分配到该模板的新客户组织都将启用目录同步。 有关详细信息,请参阅在 Partner Hub 中配置合作伙伴组织(位于 Webex for Cisco BroadWorks 的解决方案指南中)中的“配置客户模板”。
后续步骤
确保您的用户知道必须至少单击一次 Webex 应用程序上的联系人标签页才能在 Webex 应用程序上开启此功能。 只需完成一次。
启用目录同步(现有模板)
1 | 登录 Partner Hub,然后选择设置。 |
||
2 | 滚动到 BroadWorks Calling,然后单击查看模板。 |
||
3 | 选择相应的客户模板,然后滚动到 BroadWorks 目录同步。 |
||
4 | 要在缺省情况下为使用该模板的新客户组织启用目录同步:
|
||
5 | 要为使用该模板的现有客户组织启用目录同步:
|
下一步
确保您的用户知道必须至少单击一次 Webex 应用程序上的联系人标签页才能在 Webex 应用程序上开启此功能。 只需完成一次。
触发立即同步
1 | 登录 Partner Hub (http://admin.webex.com),然后选择设置。 |
2 | 滚动到 BroadWorks Calling,然后单击查看模板。 |
3 | 选择相应的客户模板,然后滚动到 BroadWorks 目录同步。 |
4 | 单击显示客户同步状态列表。 |
5 | 对于要同步的客户组织,请单击最右边的三个圆点,然后选择立即同步。 |
6 | 单击刷新查看同步结果。 |
将“同步记录”导出为 CSV
1 | 登录 Partner Hub (http://admin.webex.com),然后选择设置。 |
2 | 滚动到 BroadWorks Calling,然后单击查看模板。 |
3 | 选择相应的客户模板,然后滚动到 BroadWorks 目录同步。 |
4 | 单击显示客户同步状态列表。 |
5 | 选中要导出的各个组织旁边的复选框。 |
6 | 单击导出结果。 |
用于目录同步的公共 API
developer.webex.com 上提供了公共 API,允许合作伙伴管理员执行以下操作:更新其管理的客户组织的目录同步设置、触发即时同步,或者获取同步状态信息。 目录同步方法归类为BroadWorks 企业:
列出 BroadWorks 企业 - 使用此 API 方法可获取给定服务商下的企业列表,以及各个企业
id
。 您必须输入spEnterpriseId
(预配置时指定)。更新 BroadWorks 企业的目录同步 - 输入企业
id
以更新该企业的目录同步状态,从而启用或禁用目录同步。触发企业的目录同步 - 如果要为给定企业触发即时同步,请使用此 API 方法
id
。 对于syncStatus
,请输入SYNC_NOW
。获取企业的目录同步状态 - 输入企业
id
并运行,以获取最新同步的状态和trackingId
。 您可以使用trackingID
通过 Kibana 和 Grafana 等工具运行其他分析。
此外,管理员还可以使用为单个用户触发目录同步用于为单个用户触发按需目录同步的 API。
有关 API 文档的详细信息,请参阅 https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide。
您需要登录到 https://developer.webex.com/docs/api/v1/broadworks-subscribers 以阅读 API 规范。
将多个企业与 API 同步
|
1 | 运行列出 BroadWorks 企业 API,生成要同步的企业的列表。
|
2 | 对列表中的第一个企业运行触发企业的目录同步 API。 |
3 | 等待几秒钟,然后运行获取目录同步状态 API 以获得同步状态。
|
4 | 同步完成后,对列表中的下一个企业完成步骤 2 到 4。 重复这些步骤,直至同步整个列表。 |
目录同步错误代码
以下错误代码适用于目录同步。
错误代码 |
错误消息 |
---|---|
600000 |
发生 Broadworks 外部目录用户同步意外错误。 |
600001 |
Broadworks 外部目录用户同步失败。 |
600002 |
Broadworks 外部目录用户同步尚未完成,但必须终止。 |
600003 |
Broadworks 外部目录用户同步仅部分成功。 部分客户组织同步失败。 |
600004 |
没有为配置集启用 Broadworks 外部目录用户同步。 |
600005 |
正在进行配置集的 Broadworks 外部目录用户同步。 |
600006 |
Broadworks 外部目录用户同步线程正忙或已关闭,因此不会接受其他同步请求,请稍后重试。 |
600007 |
找不到客户配置的身份组织。 |
600008 |
在合作伙伴组织中找不到客户配置。 |
600009 |
无法运行 Broadworks 外部目录用户同步,因为与客户配置关联的 Broadworks 集群正忙 |
600010 |
无法运行 Broadworks 外部目录用户同步,因为没有任何 Broadworks 集群与客户配置关联。 |
600011 |
没有为客户配置启用 Broadworks 外部目录用户同步。 |
600012 |
无法运行 Broadworks 外部目录用户同步,因为已为客户配置启用混合目录同步。 |
600013 |
Broadworks 外部目录用户同步无法将用户和计算机帐户添加到身份存储库。 |
600014 |
尝试连接到 Broadworks 集群时,Broadworks 外部目录用户同步失败。 Broadworks 发生错误 - %s。 |
600015 |
Broadworks 外部目录用户同步在身份存储库中找不到任何匹配的用户。 |
600017 |
BroadWorks 电话列表同步无法同步所有用户和企业/组织联系人。 |
600018 |
对于企业/组织中的用户,BroadWorks 电话列表同步失败。 |
600019 |
BroadWorks 电话列表同步无法同步企业/组织联系人。 |
600020 |
无法禁用 BroadWorks 外部目录用户同步,因为客户配置同步进行中。 |
600022 |
无法进行 BroadWorks 外部目录单用户同步,因为企业没有预配置的用户。 |
600023 |
无法进行 BroadWorks 外部目录单用户同步,因为该用户已存在于此组织中。 |
600024 |
无法进行 BroadWorks 外部目录单用户同步,因为在 BroadWorks 中找不到匹配的用户。 |
600025 |
BroadWorks 外部目录用户同步更新 CI 中的用户帐户失败。 |
600026 |
BroadWorks 外部目录用户同步无法在 CI 中更新机器帐户。 |
600027 |
无法进行 BroadWorks 外部目录单用户同步,因为在 BroadWorks 中发现了多个用户。 |
600028 |
无法进行 BroadWorks 外部目录单用户同步,因为至少应该完成一个企业目录同步。 |
600029 |
BroadWorks 外部目录用户同步失败,因为企业没有预配置的用户。 |
更改历史记录
下表对本文的更新进行了总结。
日期 |
Revision |
---|---|
2023 年 2 月 14 日 |
已更新目录同步最大值和源部分。 |
2022 年 12 月 10 日 |
更新了检索词完成即时同步到触发目录同步 |
2022 年 7 月 19 日 |
对概述信息的澄清和更正:
|
2022 年 5 月 9 日 |
|
2022 年 4 月 7 日 |
|
2022 年 3 月 28 日 |
|
2022 年 3 月 24 日 |
已添加同步的电话号码类型列表,以目录同步条件。 同步现在包括移动电话号码。 |
2022 年 3 月 16 日 |
|
2021 年 12 月 17 日 |
|
2021 年 12 月 16 日 |
|
2021 年 12 月 8 日 |
|