- 主页
- /
- 文章
如果您在Microsoft Entra ID中管理用户和组,请使用Control Hub中的Entra ID (Azure AD)向导应用程序将用户和组与Webex同步。
在Control Hub中启用输入标识
在Webex for 中,Entra ID (Azure AD)向导应用程序仅连接到Entra ID全局标识,该标识涵盖消费者/企业和GCC协调Entra ID (Azure AD)客户。 GCC高级客户必须使用Microsoft Enterprise Gallery中的Control Hub应用程序为Webex预配置用户和组。 在未来的Control Hub发行版中将提供支持GCC High的向导版本。 本文中介绍的某些功能尚无法供所有客户使用。 |
准备工作
1 | |||||||||||||
2 | 转至组织设置然后向下滚动至目录同步部分。 | ||||||||||||
3 | 单击设置以开始配置。 | ||||||||||||
4 | 验证您的Entra ID管理员帐户。
| ||||||||||||
5 | 查看权限,然后单击接受授予帐户授权,以访问您的Entra ID租户。 Cisco Webex Identity 是Entra ID中的Entra ID企业应用程序。 向导应用程序连接到此应用程序以访问Entra ID图形API。 访问所需的权限是支持和使用所需的最低权限。
| ||||||||||||
6 | 对于 SMB 客户,接受默认设置,方法是选中同步默认值复选框并单击继续。 对于企业客户,请转至下一步并继续配置。 如果您接受缺省设置,即表示您希望:
| ||||||||||||
7 | 对于企业客户(超过 1000 个用户)或想要手动配置设置的客户,单击属性选项卡,然后映射属性。 单击保存。 您可以将其他用户属性从Entra ID映射到Webex,或使用属性页面更改现有用户属性映射。 您可以通过确保正确配置映射来自定义映射。 映射为用户名的值很重要。 Webex 使用用户的电子邮件地址作为其用户名。 默认情况下,Entra ID中的userPrincipalName (UPN)会映射到Control Hub中的电子邮件地址(用户名)。
| ||||||||||||
8 | 将用户添加到同步范围,方法是单击用户标签页。 您可以输入用户名以在同步范围中搜索和添加用户。 您还可以通过单击右侧的回收站图标将用户从同步范围中删除。 单击保存。 如果要从Entra ID中选择所有用户,请选择选择所有用户。 如果选中它,则无需在范围中选择组,因为此选项会同时同步这些组。
单击保存。 | ||||||||||||
9 | 在组标签页上,您可以搜索单个组并将其添加到Webex。
单击保存。
| ||||||||||||
10 | 在更多信息标签页上,您可以配置一些高级同步选项:
| ||||||||||||
11 | 您可以决定是允许立即进行同步还是在稍后阶段进行同步。 如果您选择立即允许选项,它将所有设置应用于即将进行的同步。 如果您选择保存并允许稍后选项,则在您允许自动同步之前,同步不会开始。 | ||||||||||||
12 | 应用程序与Entra ID通信,以设置配置并安排同步。 |
- 活动: 同步成功。
- 隔离: 同步作业在多次失败后已在Entra ID中隔离。 详细信息请参阅Entra ID文档。
- 未运行: 此状态仅在首次设置后出现。 首次设置后服务尚未运行。
您还可以单击查看摘要要查看上次同步的时间和日期以及同步、跳过或失败的用户数量等其他信息:
用户
- 已同步: 显示成功同步到 Webex 的用户数量。
- 已跳过: 显示在上次同步中跳过的用户数。 例如,未添加到Entra ID (Azure AD)向导应用程序同步范围的Entra ID中的新用户。 这些用户未同步到 Webex;将它们添加到同步范围中以将其同步到 Webex。
- 失败: 显示同步失败的用户数。 查看Entra ID应用程序预配置审核日志,了解有关这些用户同步失败的更多信息。 如果您需要立即同步这些用户,可以按需部署用户。
组
- 已同步: 显示成功同步到 Webex 并在 Control Hub 中创建的组数。
- 要同步: 此状态表示尚未添加组中的所有用户。 用户必须先成功同步到 Webex。
将现有Cisco Webex企业应用程序配置迁移到Entra ID (Azure AD)向导应用程序
如果您已经在Entra ID中设置了Cisco Webex企业版应用程序,您可以自动将所有配置迁移到Entra ID (Azure AD)向导应用程序。 您可以在Control Hub中管理所有Entra ID,而不会丢失之前的任何配置。
1 | |||||||||||
2 | 转至组织设置然后向下滚动至目录同步部分。 | ||||||||||
3 | 单击设置以开始配置。 | ||||||||||
4 | 使用Entra ID配置验证Entra ID管理员帐户。 确保您使用的帐户具有下一步中所述的权限。 | ||||||||||
5 | 查看权限,然后单击接受授予帐户授权,以访问您的Entra ID租户。 Cisco Webex身份同步 是Entra ID中的Entra ID企业应用程序。 向导应用程序连接到此应用程序以访问Entra ID图形API。 访问所需的权限是支持和使用所需的最低权限。
| ||||||||||
6 | 选择迁移现有应用程序。 | ||||||||||
7 | 在接受其他只读权限请求后,选择要迁移到向导应用程序的现有应用程序,然后选择继续。
| ||||||||||
8 | 迁移完成后,我们建议您进行演习在启用自动同步之前,请确保没有任何错误。 |
执行演习
在启用自动同步之前,我们建议您先进行预演,以确保没有任何错误。 预演完成后,您可以下载预演报告以查看详细信息。 报告中可用的列如下:
列名称 | 描述 |
---|---|
对象类型 | Entra ID中对象的类型,例如用户或组。 |
操作类型 | 同步期间将对对象执行的操作类型。 可能的操作类型包括:
|
Azure 标识 | Entra ID中对象的ID。 |
Azure 名称 | Entra ID中对象的名称。 |
Webex 名称 | Webex 中对象的名称。 |
原因 | 同步期间将发生某种操作类型的原因。 |
1 | |
2 | 转至组织设置然后向下滚动至目录同步部分。 |
3 | 单击要同步的实例旁的三个垂直点,然后选择空运行。 |
4 | 演习完成后,单击下载摘要以将报告下载为CSV 文件。 |
启用或禁用自动同步
Entra ID (Azure AD)向导应用程序及其相应的后端服务会检查是否启用了自动同步,以确定何时将用户或组从EntrA ID同步到Webex。 启用自动同步以允许自动预配置用户和组同步。 禁用 同步 ,向导应用程序不会将任何内容同步到Webex,但保留现有配置。
通常,根据Microsoft策略每40分钟同步一次用户。 |
1 | 以具有完全权限的组织管理员身份登录 Control Hub。 |
2 | 转至组织设置然后向下滚动至目录同步部分。 |
3 | 将开关拨至右侧以启用自动同步。 通过切换自动同步向左切换。 |
编辑Entra ID (Azure AD)向导应用程序配置
1 | |||
2 | 转至组织设置然后向下滚动至目录同步部分。 | ||
3 | 单击编辑配置。 | ||
4 | 从源自Entra ID的左列中选择一个属性,自定义属性映射。 Webex Cloud中的目标属性位于右列中。 有关 属性的详细信息,请参阅Entra ID (Azure AD)向导应用程序属性映射 。 | ||
5 | 在用户和群组标签页,在同步范围中添加或删除用户和组。
| ||
6 | 在更多信息必要时更改首选项。 | ||
7 | 单击保存以保存修改的配置。
|
编辑 Webex 实例名称
更改Cisco Webex身份实例名称在Entra ID企业应用程序列表中的显示方式。
1 | |
2 | 转至组织设置然后向下滚动至目录同步部分。 |
3 | 单击编辑实例名称。 |
4 | 输入新实例名称,然后单击保存。 |
删除Entra ID (Azure AD)向导应用程序配置
删除Entra ID (Azure AD)向导应用程序后,将删除EntrA ID同步的配置。 Webex或Entra ID不保留该配置。 如果您想将来使用Entra ID同步,则需要进行完整的重新配置。
准备工作
1 | |
2 | 转至组织设置然后向下滚动至目录同步部分。 |
3 | 单击删除实例。 |
4 | 在删除 Azure AD 实例?页面,选择撤销 Azure AD 管理员同意如果您想从 Webex 删除同意协议。 如果选择此选项,则必须输入凭证并再次授予权限。 |
5 | 单击删除。 |
按需将用户预配置到 Webex
您可以立即将用户预配置到Webex,而不受Entra ID同步的影响,并立即检查结果。 这有助于对设置期间的问题进行疑难解答。
1 | |
2 | 转至组织设置并向下滚动至目录同步部分。 |
3 | 单击按需预配置用户。 |
4 | 搜索并选择要设置的用户,然后单击预配置。 |
5 | 完成后会显示以下结果之一:
|
6 | 单击请重新尝试以在同一用户跳过或失败后重新设置相同的用户。 |
7 | 单击预配置其他用户以返回设置页面。 |
8 | 单击完成完成后。 |
将入口ID已验证域导入到Control Hub
客户可能在Entra ID中验证了数百个域。 当他们与Control Hub集成时,如果他们想要将已验证域从Entra ID导入到Control Hub。 这可以节省维护或设置过程中的许多工作量。
1 | 转至域中的部分组织设置Control Hub 中的标签页。 |
2 | 单击添加(带输入ID)。 |
3 | 在添加已验证的域页面上,搜索并选择要添加的域。 |
4 | 单击添加。 已验证的域将显示在已验证的域列表中。
|
Entra ID (Azure AD)向导应用程序属性映射
Entra ID (Azure AD)向导应用程序可支持和同步对属性表达式所做的任何更改。 例如,在Entra ID中,您可以映射 displayName
以便同时显示 surname
和 givenName
属性。 这些更改会显示在向导应用程序中。
您可以在 Microsoft帮助站点上的Entra ID中找到有关映射属性表达式的更多信息。
下表包含特定Entra ID属性的信息。
Entra ID不同步null值。 如果在Entra ID中将属性值设置为null,则不会在Webex中删除该属性值或使用null值修补该属性值。 有关更多信息,请参阅 Microsoft帮助站点上的限制。 |
Entra ID属性(源) | Webex 用户属性(目标) | 描述 |
---|---|---|
userPrincipalName |
userName |
它是 Webex 中用户的唯一标识。 它是格式化的电子邮件。 |
displayName |
displayName |
显示在 Webex 应用程序上的用户名。 |
surname |
name.familyName |
|
givenName |
name.givenName |
|
objectId |
externalId |
它是Entra ID中用户的UID。 通常为 16 字节的字符串。 我们不建议您更改此映射。 |
jobTitle |
标题 |
|
usageLocation |
addresses[type eq "work"].country |
我们建议使用使用位置映射到地址 [type eq "work"].country。 如果选择其他属性,则应确保属性值符合标准。 例如,USA 应为 US。 中国应为 CN,依此类推。 |
city |
addresses[type eq "work"].locality |
|
streetAddress |
addresses[type eq "work"].streetAddress |
|
state |
addresses[type eq "work"].region |
|
postalCode |
addresses[type eq "work"].postalCode |
|
telephoneNumber |
phoneNumbers[type eq "work"].value |
|
移动设备 |
phoneNumbers[type eq "mobile"].value |
|
facsimileTelephoneNumber |
phoneNumbers[type eq "fax"].value |
|
Manager |
Manager |
将用户的经理信息同步到 Webex,以便用户始终可以看到用户联系人名片上的正确经理信息。 创建用户后,Entra ID将检查用户的经理对象是否在Webex标识中。 如果否,则忽略用户的经理属性。 如果存在经理属性,则必须满足两个条件才能在用户的联系人名片上显示该属性:
当用户的身份验证令牌过期时,这些条件会检查用户的经理属性更新。 |
常见问题解答
如何从Cisco目录连接器配置迁移到Entra ID (Azure AD)向导应用程序?
在设置期间,向导应用程序会检测您的组织是否使用 Directory Connector。 如果启用,将显示一个对话框,您可以在其中选择使用Entra ID并阻止目录连接器。 单击阻止以确认您要继续Entra ID (Azure AD)向导应用程序配置。
您还可以选择在配置向导应用程序之前禁用 Directory Connector。 配置完成后,向导应用程序将管理用户配置文件。 但是,向导应用程序仅管理添加到同步范围中的用户。您无法使用向导应用程序来管理通过 Directory Connector 同步的不属于同步范围的用户。
可以使用Microsoft Entra配置单点登录吗?
您可以在Control Hub客户组织与使用Microsoft Entra ID作为身份提供程序的部署之间 单点登录(SSO)集成 。
Webex 中的用户头像何时更新?
在 Webex 标识中创建用户时,用户头像会同步到 Webex。 此更新依赖于在Entra ID中更新用户的头像。 然后,向导应用程序从Entra ID检索新头像。