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

将 Webex 添加到 Microsoft Entra ID,然后将目录中的用户同步到 Control Hub 中管理的组织。同步不需要本地基础设施或连接器。此集成 可使用户列表在 Entra ID 中创建、更新或删除用户时保持同步。

跨域身份管理系统 (SCIM)

目录用户与 Control Hub 的集成使用跨域身份管理系统 ( SCIM) API。SCIM 是一个开放标准,用于自动在标识域或 IT 系统之间交换用户标识信息。SCIM 的设计目的是简化在基于云的应用程序和服务中管理用户身份的过程。SCIM 通过 REST 使用标准化的 API。

Entra ID 不会同步空值。如果您将属性值设置为 NULL,将不会删除或修补值为空值Webex。如果此限制影响您的用户,请联系 Microsoft 联系支持人员。

Entra ID Wizard 应用程序

使用 Control Hub 中的 Entra ID Wizard 应用程序,简化用户和组与 Webex 的同步。Wizard App 可让您轻松配置要同步的属性、用户和组,并决定是否将用户的头像同步到 Webex。请参阅 在 Control Hub 中设置 Entra ID Wizard 应用程序 以了解有关使用该向导的更多好处。

从 Azure 应用程序库添加 Webex

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

如果 您已经将 Control Hub 与 Entra ID 集成以实现单点登录 (SSO ),则 Webex 已添加到您的企业应用程序中,您可以跳过此过程。

1

使用您的管理员证书登录到 Azure 门户https://portal.azure.com

2

请前往 Entra ID 获取您组织的 ID。

3

转到 “企业应用程序 ”,然后单击 “新建应用程序 ”。 > 创建您自己的应用程序

4

输入新应用程序的名称,然后选择 集成您在库中找不到的任何其他应用程序(非库)

5

单击创建

6

打开新应用程序,转到 配置 > 模式 并选择, 自动

7

为了确保您添加的用于同步的 Webex 应用程序并未在用户门户中显示,请打开新应用程序,转至属性,将对用户可见?设置为

分配 groups/users 在Entra ID中申请

在此过程中,您可以选择要同步到 Webex 云的用户。

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

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

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

1

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

2

单击添加分配

3

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

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

单击选择,然后单击分配

重复这些步骤,直到将所有需要的组和用户同步到 Webex。

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

使用此程序从 Entra ID 设置配置并为您的组织获取持有者令牌。这些步骤涵盖了必要和推荐的管理设置。

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

准备工作

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

1

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

2

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

3

转至预配置,然后将预配置模式更改为自动

Entra ID 中的 Cisco Webex 配置屏幕。点击“配置模式”下拉菜单,选择“自动”。

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

4

输入租户 URL

下表显示您的 Webex 产品的 URL。将 OrgId 替换为您的具体值。

表1。 Webex 的租户 URL
Webex 产品要使用的租户 URL
Webex(缺省值)

https://webexapis.com/identity/scim/OrgId/v2

Webex申请 https://api-usgov.webex.com/identity/scim/OrgId/v2

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

5

请按照以下步骤生成新令牌:

  1. 复制以下网址并在隐身浏览器标签页中运行: https://idbroker.webex.com/idb/saml2/jsp/doSSO.jsp?type=login&goto=https%3A%2F%2Fidbroker.webex.com%2Fidb%2Foauth2%2Fv1%2Fauthorize%3Fresponse_type%3Dtoken%26client_id%3DC4ca14fe00b0e51efb414ebd45aa88c1858c3bfb949b2405dba10b0ca4bc37402%26redirect_uri%3Dhttp%253A%2f%2flocalhost%253A3000%2fauth%2fcode%26scope%3Dspark%253Apeople_read%2520spark%253Apeople_write%2520Identity%253ASCIM%26state%3Dthis-should-be-a-random-string-for-security-purpose

    上述 URL 适用于缺省 Webex ID 代理。如果您正将令牌Webex,请使用以下 URL 获取不记名令牌:

    https://idbroker-f.webex.com/idb/saml2/jsp/doSSO.jsp?type=login&goto=https%3A%2F%2Fidbroker.webex.com%2Fidb%2Foauth2%2Fv1%2Fauthorize%3Fresponse_type%3Dtoken%26client_id%3DC4ca14fe00b0e51efb414ebd45aa88c1858c3bfb949b2405dba10b0ca4bc37402%26redirect_uri%3Dhttp%253A%2f%2flocalhost%253A3000%2fauth%2fcode%26scope%3Dspark%253Apeople_read%2520spark%253Apeople_write%2520Identity%253ASCIM%26state%3Dthis-should-be-a-random-string-for-security-purpose

    必须使用匿名浏览器,以确保使用正确的管理员凭证登录。如果您已经以权限较低、无法创建用户的用户登录,您返回的不记名令牌将无法创建用户。

  2. 在出现的 Webex 登录页面中,使用组织的完全权限管理员帐户登录。

    会出现错误页面,说明无法联系到站点,但这是正常的。

    错误页面的 URL 包含生成的不记名令牌。此令牌的有效期为 365 天(之后将过期)。

    错误页面 URL 示例,其中生成的 bearer token 已高亮显示。复制“access_token”之间的 bearer token 值 =" 和 "& amp;token_type=Bearer".

  3. 从浏览器地址栏中的 URL 中,复制 access_token=&token_type=Bearer之间的 bearer token 值。

    例如,此 URL 突出显示了令牌值:http://localhost:3000/auth/code#access_token={}sample_token&token_type=不记名&expires_in=3887999&state=this-should-be-a-random-string-for-security-purpose。

    我们建议您将此值保存为令牌的记录,以防 URL 不可用。

6

返回门户并将令牌值粘贴到 Secret Token中。

7

点击 测试连接 以确保 Entra ID 能够识别组织和令牌。

成功的结果表明凭证获得授权,可启用用户预配置。

8

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

9

单击保存

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

下一步

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

有关更改同步组织的信息,请参阅 管理同步的 Entra ID 用户 帮助文章。

将 Entra ID 中的用户属性映射到 Webex

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

Entra ID 与 Webex 的映射并不能同步每个用户的详细信息。用户数据的某些方面没有同步:

  • 头像

  • 聊天室

  • 下表中未列出的属性

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

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

准备工作

您已将 Cisco Webex 应用添加到您的 Entra ID 并进行了配置,并测试了连接。

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

1

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

2

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

3

前往 配置 > 映射 并单击 配置 Entra ID 用户

4

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

5

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

6

点击 保存 > 是的 表示确认。

“属性映射”页面随即打开,您可以将 Entra ID 用户属性映射到您选择的 Webex 用户属性。

7

在页面底部附近单击添加新映射

8

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

表 2. Entra ID 到 Webex 映射

入口 ID 属性(来源)

Webex 用户属性(目标)

默认填充属性

userPrincipalName

userName

Switch([IsSoftd], , "False", "True", "True", "False")

active

displayName

displayName

surname

name.familyName

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

employeeid

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

department

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

Manager

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

9

重复前两步,直到已添加或修改所有需要的映射,然后单击保存以确认新映射。

如果要重新开始,可以恢复缺省映射

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

支持的同步对象

以下表格显示了 Entra ID 企业应用商店同步、Entra ID 控制中心向导应用和 Entra ID SCIM 2.0 实现之间的差异。

表 3. 您可以同步的内容

对象

Entra ID SCIM 1.1

Entra ID Wizard 应用程序

Entra ID SCIM 2.0

用户

群组

支持*

支持

会议室

支持*

头像

支持*

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

表 4. 支持的用户属性

属性

Entra ID SCIM 1.1

Entra ID Wizard 应用程序

SCIM 2.0

userName

displayName

name.familyName

name.givenName

外部ID

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

员工编号

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