- 主页
- /
- 文章
在此文章中如果您在Microsoft Entra ID中管理用户和组，请使用Control Hub中的Entra ID (Azure )向导应用程序将用户和组与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 ID | 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 |
如果要从Webex删除同意协议，请在 删除Azure AD实例？页面中选择撤销Azure AD管理员同意。 如选择该选项，必须输入凭证并再次授予权限。 
|
| 5 |
单击删除。 |
为用户预配置Webex随需会议
您可以立即将用户预配置到Webex，而不受Entra ID同步的影响，并立即检查结果。 这有助于对设置期间的问题进行疑难解答。
| 1 | |
| 2 |
转至组织设置并向下滚动至目录同步部分。 |
| 3 |
单击按需预配置用户。
|
| 4 |
搜索并选择您要预配置的用户，然后单击预配置。 |
| 5 |
完成后将显示以下结果之一：
|
| 6 |
如果用户跳过或失败，单击“重新尝试”以再次预配置同一用户。 |
| 7 |
单击预配置其他用户以返回预配置页面。 |
| 8 |
完成后单击完成(Done)。 |
将入口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，使其显示姓氏和 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 |
我们建议使用Usagel 映射到地址[type eq "work"]。country。 如果选择其他属性，应确保属性值符合标准。 比如，美国应该是美国。 中国应该是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标识中。 如果“否”，则忽略用户的Manager属性。 如果有经理属性，则必须满足两个条件才能使该属性显示在用户的名片上：
当用户的身份验证令牌过期时，这些条件会检查用户的经理属性更新。
|
||
常见问题解答
如何从Cisco目录连接器配置迁移到Entra ID (Azure AD)向导应用程序？
在设置期间，向导应用程序会检测您的组织是否使用目录连接器。 如果启用，将显示一个对话框，您可以在其中选择使用Entra ID并阻止目录连接器。 单击阻止以确认您要继续Entra ID (Azure AD)向导应用程序配置。
您还可以在配置向导应用程序之前选择禁用目录连接器。 配置完成后，向导应用程序将管理用户档案。 但是，向导应用程序仅管理添加到同步范围的用户；您无法使用向导应用程序管理不属于同步范围的目录连接器同步的用户。
可以使用Microsoft Entra配置单点登录吗？
您可以在Control Hub客户组织与使用Microsoft Entra ID作为身份提供程序的部署之间 单点登录(SSO)集成 。
用户头像何时在Webex中更新？
在Webex 中创建用户时，用户头像会同步到Webex。 此更新依赖于在Entra ID中更新用户的头像。 然后，向导应用程序从Entra ID检索新头像。
