在此文章中
dropdown icon
跨域身份管理系统 (SCIM)
    Entra ID 向导应用程序
从 Azure 应用程序库中添加 Webex
在 Entra ID 中为应用程序分配群组/用户
授权 Entra ID 让用户与您的 Control Hub 组织同步
将用户属性从 Entra ID 映射到 Webex
支持的同步对象
使用 Cisco Webex Entra ID 图库应用程序配置传统 SCIM
list-menu在此文章中
list-menu反馈?

使用微软 Entra ID 中预建的 Cisco Webex 企业应用程序,将分配的用户与旧版 SCIM 配置集成同步到 Control Hub。此选项适用于已经使用 Cisco Webex 图库应用程序的组织。

跨域身份管理系统 (SCIM)

目录用户与控制中心之间的集成使用 跨域身份管理系统 (SCIM) API。 SCIM 是一种开放标准,用于自动在身份域或 IT 系统之间交换 用户身份信息。 SCIM 旨在 更轻松地管理基于云的应用程序和服务中的用户身份。 SCIM 通过 REST 使用 标准化 API。

SCIM 同步不需要本地基础设施或连接器。 每当在 Entra ID 中创建、更新用户或从 应用程序中删除用户时,此集成都会 使您的用户列表保持同步。

Entra ID 不会同步空值。 如果将某个属性值设置为 NULL,则不会在 Webex 中将其删除 或使用空值进行修补。 如果此限制影响您的用户,请与 Microsoft 联系以获得支持。

从 Azure 应用程序库中添加 Webex

在配置 Control Hub 以使用 Entra ID 进行自动用户配置之前,需要将 Azure 应用程序库中的 Webex 添加到托管应用程序列表中。

以下过程使用了较早的 SCIM 1.1 协议。 在 Entra ID 中使用自定义 Webex 应用程序前往 SCIM 2.0 配置,查看设置新的 SCIM 2.0 协议的过程。

有关不同 Entra ID 同步方法范围的信息,请参阅支持的同步对象。

1

使用你的管理员凭据登录 Azure 门户,网址为 https://portal.azure.com。

2

转到您的组织的 Entra ID。

3

转到企业应用程序,然后单击添加 > 从图库中添加应用程序。

4

在搜索框中键入Cisco Webex。

5

在结果窗格中,选择 Cisco Webex,然后单击 “ 添加” 以添加应用程序。

An example of the Add an application screen with the Cisco Webex application highlighted.

出现一条消息,说应用程序已成功添加。

6

要确保您为同步添加的 Webex 应用程序不显示 在用户门户中,请打开新应用程序,转到 “属性”,然后将 “对用户可见?” 改为 No。

A screen of the properties page highlighting the location of the Visible to users toggle. It can be found towards the bottom of the screen, just above the Notes field.

在 Entra ID 中为应用程序分配群组/用户

此过程允许您选择要同步到 Webex 云的用户。

Entra ID 使用一个名为 “分配” 的概念来确定哪些用户应该获得对 所选应用程序的访问权限。 在自动用户配置的背景下,只有在 Entra ID 中 “分配” 应用程序 的用户和/或用户组才会同步到 Control Hub。

使用 Control Hub 中的 Entra ID 向导应用程序同步 Entra ID 组中的用户和单个群组对象。 Webex 无法同步 Entra ID 向导应用程序之外的各个群组。

如果您是首次配置集成,我们建议您分配一个用户进行测试,然后在成功测试后添加其他用户和群组。

1

在 Entra ID 门户中打开 Webex 应用程序,然后转到用户和群组。

2

单击 “添加任务”。

3

找到要添加到应用程序的用户/群组:

  • 查找要分配给应用程序的个人用户。
  • 查找一组要分配给应用程序的用户。
4

单击 “选择”,然后单击 “分配”。

重复这些步骤,直到您拥有所有要与 Webex 同步的群组和用户。

授权 Entra ID 让用户与您的 Control Hub 组织同步

使用此过程从 Entra ID 设置配置,并为您的组织获取不记名令牌。 这些步骤涵盖必要和 推荐的管理设置。

如果您的组织强制所有用户都必须拥有经过验证的网域,则将来的 同步不允许为未经验证的域创建用户。 大多数Webex需要经过验证的域。

准备工作

在 Control Hub 中从客户视图中获取您的组织 ID。 在左下角单击您的组织名称,然后将 组织 ID 复制到文本文件中。 输入租户 URL 时需要此值。 在本文中,我们使用这个值作为示例: a35bfbc6-ccbd-4a17-a488-72gf46c5420c

1

登录 Azure 门户,然后转到 > 企业应用程序 > 所有应用程序。

2

Cisco Webex从您的企业应用程序列表中选择。

3

转至 “配置”,然后将 “配置 模式” 更改为 “自动”。

Cisco Webex provisioning screen in Entra ID. Click the Provisioning Mode drop-down menu to select Automatic.

Webex 应用程序包括 Entra ID 用户属性和 Webex 用户属性之间的一些默认映射。 这些属性足以创建 用户,但您可以添加更多属性,如本文后面所述。

4

输入租户 URL。

下表显示了您的 Webex 优惠的网址。 OrgId 替换为您的特定值。

表 1Webex 的租户网址
Webex 优惠要使用的租户 URL
Webex(默认) https://api.ciscospark.com/v1/scim/OrgId
适用于政府的 Webex https://api-usgov.webex.com/v1/scim/OrgId

例如,您的租户网址可能如下所示: https://api.ciscospark.com/v1/scim/a35bfbc6-ccbd-4a17-a488-72gf46c5420c。

5

仅执行以下任一操作即可获得 秘密代币的持有者代币值:

  • 在 Control Hub 中自动生成新令牌。

    在 Control Hub 中,转到应用程序 > 服务应用程序,选择应用程序,然后单击获取令牌 > 授权获取令牌。

  • 使用以下步骤手动生成新代币:

  1. 复制以下 URL 并在隐身浏览器选项卡中运行它:. https://idbroker.webex.com/idb/oauth2/v1/authorize?response_type=token&client_id=C4ca14fe00b0e51efb414ebd45aa88c1858c3bfb949b2405dba10b0ca4bc37402&redirect_uri=http%3A%2F%2Flocalhost%3A3000%2Fauth%2Fcode&scope=spark%3Apeople_read%20spark%3Apeople_write%20Identity%3ASCIM&state=this-should-be-a-random-string-for-security-purpose

    以上网址适用于默认 Webex ID 代理。 如果您使用的是 Webex 政府版,请使用以下 URL 获取不记名代币:

    https://idbroker-f.webex.com/idb/oauth2/v1/authorize?response_type=token&client_id=C4ca14fe00b0e51efb414ebd45aa88c1858c3bfb949b2405dba10b0ca4bc37402&redirect_uri=http%3A%2F%2Flocalhost%3A3000%2Fauth%2Fcode&scope=spark%3Apeople_read%20spark%3Apeople_write%20Identity%3ASCIM&state=this-should-be-a-random-string-for-security-purpose

    隐身浏览器对于确保您使用正确的管理员 凭据登录非常重要。 如果您已经以无法创建 用户的权限较低的用户身份登录,则您返回的持有者令牌无法创建用户。

  2. 在出现的 Webex 登录页面上,使用组织的完整管理员帐户登录。

    出现一个错误页面,提示无法访问该站点,但这是正常现象。

    错误页面的 URL 包含生成的持有者令牌。 该令牌的有效期为 365 天(之后过期)。

    An example of the error page url with the generated bearer token highlighted. Copy your bearer token value found between "access_token=" and "&token_type=Bearer".

  3. 从浏览器地址栏的 URL 中,复制介于 access_token=和 &token_type=Bearer之间的不记名令牌值。

    例如,此网址突出显示了令牌值: http://localhost:3000/auth/code # access_token = {sample_token} & token_type =Bearer& =3887999&state= expires_in this-应该是出于安全目的的随机字符串。

    我们建议您将此值作为令牌记录保存在文本文件中,以 防该 URL 不再可用。

6

返回门户并将令牌值粘贴到秘密 令牌中。

7

单击 “测试连接” 确保 Entra ID 可以识别组织和令牌。

成功的结果表明证书已获得授权以启用用户 配置。

8

输入通知电子邮件并选中复选框以在出现配置错误时 收到电子邮件。

9

单击保存。

此时,您已成功授权 Entra ID 来配置和同步 Webex 用户,并完成了设置同步的步骤。

下一步

如果您想将更多 Entra ID 用户属性映射到 Webex 属性,请继续阅读下一节。

有关对同步组织进行更改的信息,请参阅 “管理同步条 目 ID 用户” 帮助文章。

将用户属性从 Entra ID 映射到 Webex

按照此步骤将其他用户属性从 Entra ID 映射到 Webex,或更改现有的用户属性映射。

Entra ID 到 Webex 的映射无法同步每个用户的详细信息。 用户数据的某些方面不同步:

  • 头像

  • 房间

  • 下表中未列出的属性

除非绝对必要,否则我们建议您不要更改默认属性映射。 您映射为用户名的值特别重要。 Webex 使用用户的电子邮件地址作为其用户名。 默认情况下,我们会将 Azure AD 中的 U serPrincipalNam e (UPN) 映射到 Control Hub 中的电子邮件地址(用户名)。

如果 userPrincipalNam e 未映射到 Control Hub 中的电子邮件,则 用户将作为新用户配置到 Control Hub 中,而不是匹配现有用户。 如果你想使用另一个电子邮件地址格式的 Azure 用户属性而不是 UPN, 则必须将 Entra ID 中的默认映射从 userPrincipalName 更改为相应的 Entra ID 用户属性。

准备工作

您已将该Cisco Webex应用程序添加并配置到您的 Entra ID 中,并测试了连接。

在开始同步用户之前或之后,您可以修改用户属性映射。

1

登录 Azure 门户,然后转到企业应用程序 > 所有应用程序。

2

打开您在应用程序库中 添加或创建的 Webex 应用程序。

单击此处了解有关预建Cisco Webex应用程序或自定义 SCIM 2.0 应用程序 之间区别的更多信息。
3

转到 “配置” > “映射”,然后单击 “设置条目 ID 用户”。

4

选中 “显示高级选项” 复选框,然后单击 “ 编辑属性列表”。

5

从 Entra ID 用户属性中选择要填充的 Webex 属性。

6

单击 “保存” > “是” 进行确认。

属性映射页面打开,因此您可以将 Entra ID 用户属性映射到您选择的 Webex 用户属性。

7

在页面底部附近,单击 “添加新映射”。

8

选择直接映射。 选择源 属性(Entra 属性)和目标属性 (Webex 属性),然后单击 “确定”。

表 2. Entra ID 到 Webex 映射

入口 ID 属性(来源)

Webex 用户属性(目标)

默认填充属性

userPrincipalName

userName

开关([isSoftD]、“假”、“真”、“真”、“假”)

活跃

displayName

displayName

surname

姓名.姓氏

givenName

name.givenName

objectId

externalId

其他可用属性

jobTitle

title

usageLocation

addresses[type eq "work"].country

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

mobile

phoneNumbers[type eq "mobile"].value

facsimileTelephoneNumber

phoneNumbers[type eq "fax"].value

雇员 ID

urn: IETF: params: scim: schemas: 扩展:企业:2.0: 用户

department

urn: IETF: params: scim: schemas: 扩展:企业:2.0: 用户

Manager

urn: IETF: params: scim: schemas: 扩展:企业:2.0: 用户

9

重复前两个步骤,直到添加或修改了所需的所有映射,然后单击 “保存” 和 “是” 以确认新的映射。

如果你想重新开始,你可以恢复默认映射。

您的映射已完成,将在下次同步时创建或更新 Webex 用户。

支持的同步对象

下表显示了 Entra ID 的企业应用商店同步、控制中心的 Entra ID Wizard 应用程序和 Entra ID SCIM 2.0 实现之间的区别。

表 3你可以同步的内容

物体

条目 ID SCIM 1.1

Entra ID 向导应用程序

Entra ID SCIM 2.0

用户

是

是

是

群组

否

是的*

是

房间

否

是的*

否

头像

否

是的*

否

*—您只能通过 Entra ID Wizard 应用程序通过 Microsoft Graph API 将群组、房间和头像同步到 Control Hub。

表 4.支持的用户属性

属性

条目 ID SCIM 1.1

Entra ID 向导应用程序

SCIM 2.0

userName

是

是

是

displayName

是

是

是

姓名.姓氏

是

是

是

name.givenName

是

是

是

ExternalID

是

是

是

title

是

是

是

addresses[type eq "work"].country

是

是

是

addresses[type eq "work"].locality

是

是

是

addresses[type eq "work"].streetAddress

是

是

是

addresses[type eq "work"].region

是

是

是

addresses[type eq "work"].postalCode

是

是

是

phoneNumbers[type eq "work"].value

是

是

是

phoneNumbers[type eq "mobile"].value

是

是

是

phoneNumbers[type eq "fax"].value

是

是

是

Manager

否

是

否

department

否

否

是

员工 ID

否

否

是

这篇文章对您有帮助吗?
这篇文章对您有帮助吗?