> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/zh/guan-li-yuan-zhuan-qu/account-and-endpoint-management/sso-field-guide.md).

# SSO 现场指南

## 简介

将单点登录（SSO）与 Zoom 集成可为管理员提供用户管理和安全选项，从而简化账户管理。配置完成后，用户会使用公司凭据针对贵公司的身份提供商进行身份验证，而不是通过第三方应用使用 OAuth 等其他身份验证方式，或直接使用 Zoom 的用户名和密码。

本文档对 Zoom 中的 SSO 配置和设置进行了全面概述，并提供故障排除和安全信息。

## 配置 SSO

#### <mark style="color:蓝色;">SSO 需要实名网址才能开始</mark>

账户必须先拥有获批的实名网址，才能配置 SSO。实名网址获批后，Zoom 管理员可以通过 Web 门户中的高级选项子菜单访问 [SSO 配置](https://zoom.us/account/sso) 页面。有关更多信息，请参阅我们的支持文章： [实名网址](https://support.zoom.us/hc/en-us/articles/215062646-Guidelines-for-Vanity-URL-requests) 。

#### <mark style="color:蓝色;">Zoom SSO 可与任何 SAML 2.0 或 OIDC 身份提供商配合使用</mark>

Zoom 可以与任何支持安全断言标记语言 (SAML) 2.0 或 OpenID Connect (OIDC) 身份验证的身份提供方集成。

#### <mark style="color:蓝色;">Zoom 管理员可以通过响应映射或 SCIM 集成来管理用户配置文件信息和许可</mark>

管理员可以根据身份提供方提供的在线功能，通过响应映射或跨域身份管理系统 (SCIM) 应用程序编程接口 (API) 请求来管理用户配置文件信息和许可。两种用户管理方法在配置文件信息映射和许可管理方面提供几乎相同的功能，但某些 SCIM 映射需要手动配置。

如需 SCIM 功能的完整列表，请参阅我们的 [SCIM API 文档](https://developers.zoom.us/docs/api/?ampDeviceId=157cfe5d-7f7a-45eb-afb0-efde5a7d3feb\&ampSessionId=1778697171616).

#### <mark style="color:蓝色;">Zoom 管理员可以通过 SCIM 管理用户账户状态，但不能通过 SAML 或 OIDC</mark>

由于 SCIM 允许身份提供商随时直接与 Zoom 通信，用户账户可以 *激活*, *停用*, *已创建*，或 *已删除* 通过 SCIM 集成自动执行。例如，如果用户在 Active Directory 中的账户被禁用，或者用户被取消分配该应用程序，SCIM 可以在 Zoom 中为该用户的账户自动发送停用请求。此功能取决于身份提供商的 SCIM 应用程序所具备的功能，不同提供商支持的功能可能有所不同。

#### <mark style="color:蓝色;">仅有少数身份提供商为 Zoom 提供 SCIM</mark>

许多身份提供商并未将针对 Zoom 的 SCIM 集成作为其服务的一部分内置。使用不支持与 Zoom 的 SCIM 的身份提供商的账户必须使用响应映射来实现自动化用户管理。

#### <mark style="color:蓝色;">SCIM 需要一个关联域才能自动为用户进行预配</mark>

使用 SCIM 管理和配置 SSO 用户的账户 **必须** 将电子邮件域名与 Zoom 关联。未能关联该域名将导致用户配置失败。请参阅我们的支持文章，了解 [关联域](https://support.zoom.us/hc/en-us/articles/203395207) 有关该流程的更多信息。

### SAML 配置指南

以下链接包含用于使用 SAML 配置 SSO 的指南。

{% hint style="success" %}
**Zoom 提示**

点击 Provider 或 Zoom Documentation 列中的 ✔，以在新窗口中打开说明。
{% endhint %}

<table><thead><tr><th width="211.5616455078125"></th><th align="center">提供商文档</th><th align="center">Zoom 文档</th><th align="center">支持 SCIM</th></tr></thead><tbody><tr><td>auth0</td><td align="center"><a href="https://marketplace.auth0.com/integrations/zoom-sso">✔</a></td><td align="center"><br></td><td align="center"><br></td></tr><tr><td>ADFS</td><td align="center"><br></td><td align="center"><a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0062700">✔</a></td><td align="center">AD 同步工具</td></tr><tr><td>Clever</td><td align="center"><a href="https://support.clever.com/hc/s/articles/360040481852">✔</a></td><td align="center"><br></td><td align="center"><br></td></tr><tr><td>CyberArk</td><td align="center"><a href="https://docs.cyberark.com/Product-Doc/OnlineHelp/Idaptive/Latest/en/Content/Applications/AppsWeb/Zoom.htm">✔</a></td><td align="center"><br></td><td align="center"><br></td></tr><tr><td>Duo</td><td align="center"><a href="https://duo.com/docs/sso-zoom">✔</a></td><td align="center"><br></td><td align="center"><br></td></tr><tr><td>Entra ID（原 Azure）</td><td align="center"><a href="https://docs.microsoft.com/en-us/azure/active-directory/saas-apps/zoom-tutorial">✔</a></td><td align="center"><a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0064121">✔</a></td><td align="center">✔</td></tr><tr><td>Google</td><td align="center"><a href="https://support.google.com/a/answer/7577316?hl=en">✔</a></td><td align="center"><a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0066144">✔</a></td><td align="center"><br></td></tr><tr><td>JumpCloud</td><td align="center"><a href="https://support.jumpcloud.com/support/s/article/single-sign-on-sso-with-zoom1-2019-08-21-10-36-47">✔</a></td><td align="center"><br></td><td align="center">✔</td></tr><tr><td>miniOrange</td><td align="center"><a href="https://www.miniorange.com/iam/integrations/zoom-single-sign-on-sso">✔</a></td><td align="center"><br></td><td align="center"><br></td></tr><tr><td>Okta</td><td align="center"><a href="https://saml-doc.okta.com/SAML_Docs/How-to-Configure-SAML-2.0-for-Zoom.us.html">✔</a></td><td align="center"><a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0063256">✔</a></td><td align="center">✔</td></tr><tr><td>OneLogin</td><td align="center"><a href="https://onelogin.service-now.com/support?id=kb_article&#x26;sys_id=a10d1e2f87bf6850247f4156cebb35d5">✔</a></td><td align="center"></td><td align="center">✔</td></tr><tr><td>Ping Identity</td><td align="center"><a href="https://docs.pingidentity.com/integrations/zoom/setup/pf_zoom_connector_configuring_single_sign_on_in_zoom.html">✔</a></td><td align="center"><br></td><td align="center">✔</td></tr></tbody></table>

如果您的企业使用的身份提供商未列在上方，我们建议您在该提供商的知识库中搜索 Zoom 专用集成指南。如果没有可用的指南，您仍然可以通过在 Zoom 的 SSO 配置屏幕中匹配 IdP 的关键标识符来配置 SSO。有关更多信息，请参阅 Zoom 支持中心中的 [SSO 快速入门指南](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) 以及完成此流程需要哪些信息。

### OIDC 配置指南

Zoom 支持 OIDC 发现，可自动填充常见的身份提供商详细信息，如发行方、授权端点、令牌端点和签名密钥。由于 OIDC 依赖标准化的配置值，通常不需要特定提供商的 Zoom 文档；当发现功能不可用时，可手动输入所需的值。

因此，即使没有针对特定身份提供方的集成指南，通常也可以将符合标准的 OIDC 身份提供方配置为与 Zoom 配合使用。有关更多信息，请参阅 Zoom 的支持中心，了解 [配置 OIDC 单点登录](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0083701).

### 其他配置选项

#### <mark style="color:蓝色;">Zoom 可支持多个实名网址和/或多个身份提供商应用程序</mark>

Zoom 账户可支持多个实名网址、多个身份提供商（IdP）配置，或两者的组合。支持的配置包括：

* 多个共享同一 IdP 配置的实名网址。
* 多个实名网址，每个都具有独立的 IdP 配置。
* 一个关联多个 IdP 配置的实名网址。

这些配置由 Zoom 支持启用，不通过标准 SSO 管理界面进行配置。请提交 [支持请求](https://support.zoom.com/hc/en/contact?id=contact_us) 以启用此功能/特性，并提供所需的实名网址、IdP 配置以及预期的身份验证结果。

{% hint style="info" %}
**注意**

OIDC 身份验证目前不支持多个 Vanity URL 或 IdP。如果您不确定此情况是否适用于您，请联系您的 Zoom 账户团队以获取更多信息。
{% endhint %}

#### <mark style="color:蓝色;">本地部署的 Active Directory 可以使用 AD 同步工具，而不是 SCIM</mark>

希望通过 SCIM 自动执行用户配置，但没有基于云的身份提供商的账户，可以使用 Zoom 开发的 Active Directory (AD) Sync Tool 应用程序来管理其用户。此应用程序在 Oracle JDK 8 上运行，并通过使用 API 命令管理用户来模拟 SCIM 配置。请参阅我们关于 [AD 同步工具](https://support.zoom.us/hc/en-us/articles/115005865543-Managing-the-AD-Sync-Tool) 了解更多信息。

{% hint style="success" %}
**Zoom 建议**

AD 同步工具需要对用户管理进行精确配置。在全面实施之前，必须对该工具的配置进行彻底测试和审查，以避免服务中断。
{% endhint %}

#### <mark style="color:蓝色;">身份提供商甚至可以对没有 Zoom 账户的会议参会者进行身份验证</mark>

希望要求用户验证其身份、但不希望提供 Zoom 账户的账户，可以通过其身份提供商配置外部身份验证配置文件。为会议启用此功能后，尝试加入的用户必须通过身份提供商验证其登录凭据，才能获得访问权限。这是学校常见的配置方式：学校不会为所有学生提供账户，但要求学生通过身份验证才能加入课堂。更多信息，请参阅我们的支持文章： [配置外部身份验证](https://support.zoom.us/hc/en-us/articles/360053351051-Configuring-external-authentication-for-K-12-schools) 。

#### <mark style="color:蓝色;">更改身份提供商需要在 Zoom 中重新配置 SSO</mark>

正在更改身份提供商的账户必须在 Zoom 中重新执行其 SSO 配置。这包括更新配置页面中的所有字段，以匹配其新的身份提供商。建议账户确认在新的身份提供商下响应映射不会更改。

假设没有进一步更改，则不应需要额外的配置或更改。

#### <mark style="color:蓝色;">拥有子账户的客户可以从主账户或子账户配置 SSO</mark>

拥有子账户的客户有两种配置 SSO 的选项：

1. 所有用户都使用主账户的实名网址进行身份验证，并通过高级响应映射自动登录子账户（[部分映射存在限制](#mapping-users-to-a-sub-account-will-only-apply-a-meeting-license-and-add-ons))
2. 每个子账户都有唯一的实名网址和独立的 SSO 配置，仅供该子账户的成员使用

每种配置都提供独特优势，其中第二种选项最具灵活性。考虑实施任一配置的客户应与其账户团队讨论哪种配置最适合其需求。

## 预配方式

#### <mark style="color:蓝色;">预配模式和 SCIM 是两种不同的机制，它们可以一起使用</mark>

预配 *登录时* 和 *登录前* 是同一项 SSO 设置的两个可选值。它们决定 Zoom 是在用户完成身份验证时为其创建账户，还是要求该账户必须已存在。SCIM 不是该设置的第三个选项，而是一种独立的、由 API 驱动的机制，可在身份验证之外预配用户，并与所选的预配模式配合运行。

| 预配方式                                  | 工作原理                           | 前提条件                            | 创建账户             | 停用账户             |
| ------------------------------------- | ------------------------------ | ------------------------------- | ---------------- | ---------------- |
| <p><strong>登录时</strong><br>（即时）</p>   | 在用户首次进行身份验证时创建账户               | 无                               | 是                | 否                |
| <p><strong>登录前</strong><br>（预先配置）</p> | 验证用户已获授权可通过 SSO 登录             | 具有 SSO 登录类型的账户。通常与 SCIM 预配一起使用。 | 否，但通常与 SCIM 一起使用 | 否，但通常与 SCIM 一起使用 |
| **SCIM**                              | 通过 API 按其自身安排/定时发送从身份提供商同步用户数据 | IdP SCIM 支持以及一个关联域              | 是                | 是的，如果 IdP 支持     |

### 登录时

#### <mark style="color:蓝色;">登录时配置会在一步中创建账户和 SSO 登录类型</mark>

使用 *登录时* 设置（也称为即时配置）时，在身份提供商中获分配 Zoom 应用程序且获得任何受支持的 Zoom 许可证的用户，首次进行身份验证时会自动创建账户。此前无需在 Zoom 中创建任何内容。因此，这是最简单的部署选项，也是首次为账户配置 SSO 时推荐使用此选项的原因。

登录时配置也与 SCIM 兼容——两者可以同时运行。不过在实践中，SCIM 通常会使其变得不再必要，因为当用户第一次进行身份验证时，账户通常已经存在。

### 登录前

#### <mark style="color:蓝色;">登录前配置取决于其他内容先创建了账户或登录类型</mark>

该 *登录前* 设置（也称为预先配置）不会自动配置任何内容。相反，它会强制执行一项条件：用户只有在其 Zoom 账户已存在且登录类型为 SSO 时才能进行身份验证。因此，必须由其他机制负责创建这些账户，实际可行的方式有两种。

* **SCIM 配置**，当用户被分配到应用程序时，它会自动从身份提供商创建账户。
* **批量上传 CSV** 并选择 *SSO 用户* 选项，即可在一次导入中创建账户并应用 SSO 登录类型。

这就是预配置和 SCIM 经常配合使用的原因。预配置规定了一项要求；SCIM 是大规模满足该要求的机制。

Zoom 管理员可以在 Web 门户的 [用户管理](https://zoom.us/account/user#/) 页面查看用户账户，并检查用户电子邮件地址下方是否显示“SSO”图标，以确认该账户是否采用 SSO 登录类型。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcreMLZApFm8ejVa0ka9Z8eqYuNxu79PNBLNRQMSXiYuhd7i_yVll8yuREcJto4NqP1PWcodZJcONRGl97_uQx7fIg7XIaESAtwqFmtg94DGrwzWgJJSPITSivg8XydSZEJPGMY7Q?key=ug1dFE_WGWGnyMfD5tJnNw" alt="A user profile showing an SSO login type" width="375"><figcaption><p>用户电子邮件下方 SSO 图标的位置。</p></figcaption></figure></div>

如果图标显示，则该用户已配置 SSO；如果图标缺失，则在添加该图标之前，只要启用了预配置，该用户将无法通过 SSO 登录。Zoom 管理员可以通过 CSV 文件批量添加用户并选择“SSO 用户”选项来添加此登录类型，或者让用户在启用“登录时配置”时进行身份验证。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcoPrIr5MH76SjZUpz7giqvgeI20rLRN6ZRT__7ltUhhuaWNyH4nM0EePcE7V3aFx1tbMqPICLZ_9dHs7Gc3_tXWOGZ4KOKQzPCdb4meMTpRxcBvNOJ2QwQmAisWT-KtWUzl_B1gQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>示例展示了用于批量上传的 SSO 用户选项。</p></figcaption></figure></div>

### SCIM

#### <mark style="color:蓝色;">SCIM 通过 API 为用户预配，并且从不使用 SAML 或 OIDC 之类的身份值进行断言</mark>

SCIM 与响应映射有所不同，这一点值得明确说明。响应映射（通过 SAML 断言或 OIDC 声明）会携带用户信息 *作为身份验证事件的一部分*。在用户登录之前，不会应用任何内容，相关信息会包含在断言中传递。

SCIM 完全不携带任何断言或声明。身份提供方会按照其自身的安排/定时发送，直接调用 Zoom 的 API，发送用户信息，无论用户是否曾登录过都是如此。这正是 SCIM 能够在无需用户参与的情况下创建、更新、停用和删除账户的原因，也是 SCIM 能管理账户状态而响应映射却不能的原因。

SCIM 与任一种预配模式兼容，而且最常与预配置一起部署。

请参阅 [适用于 Entra ID 和 Okta 的 SCIM 现场指南](https://library.zoom.com/technical-library/zh/guan-li-yuan-zhuan-qu/account-and-endpoint-management/scim-guide.md) ，了解如何为 Entra ID 或 Okta 账户配置 SCIM。

{% hint style="success" %}
**Zoom 建议**

在新账户上同时配置 SSO 和 SCIM 时，请先启用 *登录时配置* 。这样有助于确保在验证 SCIM 集成期间，用户仍能进行身份验证。确认 SCIM 创建的账户已应用 SSO 登录类型后，切换为 *登录前配置* 如果需要更严格的控制。
{% endhint %}

## 安全设置

#### <mark style="color:蓝色;">Zoom 管理员可以在设定的时间后强制自动注销</mark>

Zoom 管理员可以配置 Zoom，使其在设定的时间后自动将用户从有效会话中注销，时间可自定义为 15 分钟到 180 天。此过程会在令牌生成后，将 Zoom 访问令牌设置为在预定时长后过期。该令牌与身份提供商无关，并且仅适用于 Zoom。

#### <mark style="color:蓝色;">必须关联并管理域，才能强制执行 SSO 身份验证</mark>

Zoom 管理员可以强制执行 SSO 身份验证 *仅* 如果电子邮件域名已关联并由 Zoom 管理。启用此选项后，所有使用贵公司的域名进行身份验证的用户都将自动重定向到身份提供商的身份验证页面，无论使用哪个平台。

域名获批并纳入管理后，Zoom 管理员可以通过您账户的 [安全页面](https://zoom.us/account/setting/security) 在……下方 **登录方式**。请参阅我们的支持文章，了解 [关联域](https://support.zoom.us/hc/en-us/articles/203395207) 如需详细了解如何关联和管理域名。

#### <mark style="color:蓝色;">指定用户可以免于强制 SSO 身份验证</mark>

Zoom 管理员可以将特定用户排除在强制执行的 SSO 身份验证之外。如果 SSO 配置出现问题，将特定用户（例如管理员账户）排除在外可能会很有用，这样账户管理员便可以通过非 SSO 方式访问 Zoom 账户。获得豁免的管理员可以随时登录 admin.zoom.us，以应对账户锁定或 SSO 配置损坏等事件 & 活动 &直播（用户必须拥有标准 **管理员** 角色）。如果 Zoom 管理员无法访问账户，必须联系 Zoom 支持寻求帮助。

要启用用户例外，请打开 [管理中心](https://zoom.com/account) → [安全与信任](https://zoom.com/account/setting/security) → [常规](https://zoom.com/account/setting/security)，找到强制执行的域名列表，然后通过编辑列表添加例外。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe23kx3YxMdjE3_CZSecp2CF3HA42tOP80rwvDJo5JApEYW3sPKjo4p2qyJFQ912BHysKjQ51M5p04hb_ODjApxTyL3bh9-PooZZ1lrf1odC8z1n8xtOcDjROAjCO-45Idn5nVglw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>SSO 的域列表示例。</p></figcaption></figure></div>

#### <mark style="color:蓝色;">可配置移动端和桌面客户端，要求用户使用 SSO 身份验证</mark>

可预先配置 Zoom 客户端，以通过组策略、移动设备管理（MDM）服务和批量部署客户端来自动化 SSO 功能，包括自动登录、自动注销、在设备上的仅 SSO 身份验证等更多功能。

如需查看完整的配置选项列表，请参阅我们的 [群组策略](https://support.zoom.us/hc/en-us/articles/360039100051), [iOS](https://support.zoom.us/hc/en-us/articles/360022302612-Using-MDM-to-configure-Zoom-on-iOS), [Android](https://support.zoom.us/hc/en-us/articles/360031913292-Using-MDM-to-configure-Zoom-on-Android), [Mac](https://support.zoom.us/hc/en-us/articles/115001799006-Mass-deploying-preconfigured-settings-for-Mac) 和 [Windows](https://support.zoom.us/hc/en-us/articles/201362163-Mass-deployment-with-preconfigured-settings-for-Windows).

#### <mark style="color:蓝色;">Office 365 用户可使用 SSO 凭据自动登录适用于 Outlook 的 Zoom 插件</mark>

使用 Office 365 的客户可以使用 SSO 凭据自动将用户登录到适用于 Outlook 的 Zoom 插件。此功能可与 [自定义插件清单](https://support.zoom.us/hc/en-us/articles/360041403311) 搭配使用，该清单会预先填入账户的实名网址，为用户带来无缝的身份验证体验。此功能会在用户的 SSO 会议令牌有效时使用该令牌；如果未找到有效会议，则会提示用户通过身份提供商进行新的身份验证。

Zoom 管理员可在账户的 [安全页面启用此设置](https://zoom.us/account/setting/security) 在 **高级** 菜单下。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfEdymeE4sK16jjdIFscCwWJFRXrCOOa_JUC8l0P7qxR3mXD4HFeDP9V3SUEsJCFMFqn41oKdwmS2Rk7Ilu-NgPfaPj0IpVnYxYUCPYdtcVCU63p7GfceHm5GrhvgdFEPC67hpP?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>Outlook 加载项的 SSO 管理员设置示例。</p></figcaption></figure></div>

## 响应映射

在响应映射中， **属性** 是由 **值**定义的数据类别，用于将信息从身份提供商传递给 Zoom 等服务提供商。映射属性和值对于自动填充用户个人资料信息和管理用户许可证至关重要。

Zoom 响应映射分为两部分： *基础版* 和 *高级版*。基础映射用于映射基本个人资料信息，包括姓名、电话号码、部门等；高级映射用于管理动态许可证分配、分配用户组、用户角色等。

本节涵盖基础版和高级响应映射的基础知识，并突出显示某些功能/特性所需的特殊条件。

#### <mark style="color:蓝色;">Zoom 支持通过 SAML 和 OIDC 进行响应映射</mark>

Zoom 可以通过 SAML 或 OIDC 配置响应映射。SAML 身份信息通过 XML 格式的断言交换，而 OIDC 身份信息则通过 JSON Web Key 集（JWKs）提供。在任一情况下，Zoom 都可以使用从身份提供商收到的属性或声明来映射用户个人资料信息、许可证、组以及其他受支持的账户设置。

#### <mark style="color:蓝色;">基础知识：属性和值</mark>

大多数身份提供商使用普通的属性名称和值传递基本资料信息。例如，员工的部门可能会通过属性 department 和值 Human Resources 传递。下表演示了在向用户传递信息时属性和值之间的关系。

| 属性   | 值                              |
| ---- | ------------------------------ |
| 名    | John                           |
| 姓    | Smith                          |
| 电子邮件 | <john.smith@companydomain.com> |
| 部门   | 人力资源                           |

通过将属性正确分配到响应映射，用户信息可以自动应用到用户个人资料中，从而简化账户创建和管理过程。

### 基础版映射：个人资料信息

基础映射用于将目录中的个人资料信息（例如名字、姓氏、部门、电话号码、成本中心和位置）应用到用户的个人资料中。许多类别的含义一目了然，配置也很简单；不过，某些类别需要进一步说明，以便正确配置，避免出现意外后果或应用程序错误。以下部分重点介绍基础映射中特有的映射选项和配置设置。有关支持属性的完整列表，请参阅我们的 [基础映射文章](https://support.zoom.us/hc/en-us/articles/115005888686-Setting-up-basic-SAML-mapping) 。

#### <mark style="color:蓝色;">默认许可证类型仅适用于</mark> *<mark style="color:蓝色;">全新用户</mark>*

默认许可证类型选项会将指定的许可证分配给所有 *全新* 通过首次身份验证在账户中预配的用户。不适用于第二次进行身份验证的用户、从先前账户合并到该账户的用户、通过 SCIM 预配的用户或手动邀请的用户。

有关 *更新* 用户通过身份验证获得许可证的信息，请参阅 [高级映射](#advanced-mapping-licenses-add-ons-and-access).

#### <mark style="color:蓝色;">默认许可证类型为</mark> *<mark style="color:蓝色;">无</mark>* <mark style="color:蓝色;">将不允许新用户进行身份验证，除非已配置高级映射来分配许可证</mark>

Zoom 用户必须分配有许可证类型（例如，未分配、未分配 Zoom Meetings 基础版、Zoom Workplace 等），才能登录 Zoom 服务。如果选择的默认许可证类型为“无”，新用户将无法登录或创建新账户，除非他们通过 [高级映射](#advanced-mapping-licenses-add-ons-and-access).

#### <mark style="color:蓝色;">除非另有说明，大多数基础版映射将在登录时重新应用</mark>

默认情况下，大多数基本映射会在用户每次登录时更新， *但* *以下映射除外：* 名字、姓氏、显示名称和电话号码。默认情况下，这四种映射仅在用户首次通过身份验证时应用一次，之后不会再次应用，即使用户或管理员更改了这些信息也是如此。Zoom 管理员可以在响应映射页面启用 **每次 SSO 登录时更新** 选项来更改此行为。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdgxB7nSeT9EXKL47NDJoqfiLnUAkydR2-yPdvgvQW178LJscVd-Jo8TfyuPBb2sez6c5cRwwK0FwoEhCwG8TlOfZV1MzpWoZxXOYHu1WCcPZYBryituG7Fyq-T88isb7-ofUn_MQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>“在每次 SSO 登录时更新”选项示例。</p></figcaption></figure></div>

#### <mark style="color:蓝色;">如果不在美国境内，电话号码映射应包含国家/地区代码和区号</mark>

通过断言映射的电话号码应尽可能包含用户的国家/地区代码和区号。如果未定义，Zoom 默认将假定国家/地区代码为 +1。

如果账户的目录中未保留国家/地区代码，可在其身份提供商中编辑断言，以便在必要时自动包含这些代码。

#### <mark style="color:蓝色;">每位用户最多可将三个电话号码和一个传真号码映射到其个人资料</mark>

Zoom 管理员可为每位用户配置最多三个独立的电话号码映射和一个传真号码映射。每个电话号码必须唯一，且不得与其他字段的值重复。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdYCqP1aO_ELJdgruJRApKiNSEQ96i1dThBbMwG0rH-XT4P64DcgadLpi_4dFm4tybOmAkUaH22Jg0Qs6WMhyanQ7FrFSHu7DFMJv6FzABVhdz6NvN_E0pX26mymjGHe5UjUcxRNg?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>每位用户的电话号码选项示例。</p></figcaption></figure></div>

#### <mark style="color:蓝色;">个人资料图片必须映射自可公开访问的 URL，或使用 Base64 编码</mark>

希望从目录映射个人资料图片的账户必须使用可公开访问的 URL 映射图像，或者在进行断言时使用 Base64 对图像进行编码。

### 员工唯一 ID

<mark style="color:蓝色;">**员工唯一 ID 会更改 Zoom 用于识别用户的主标识符，并有助于在电子邮件更改后阻止重复的用户账户**</mark>

“ *员工唯一 ID* ”是 Zoom 提供的一项功能/特性，可帮助进行身份管理。默认情况下，Zoom 用户的主要身份标识是其 **电子邮件** **地址**。这意味着，如果工作电子邮件登录类型为 **<john.smith@company.com>**，那么 Zoom 始终会通过此电子邮件地址识别该用户。此标识符使 SSO 或 Facebook 和 Google OAuth 账户等集成能够将该用户关联到同一个 Zoom 账户。

不过，如果用户的姓名或电子邮件发生更改，这种识别流程可能会带来问题。例如，如果 **<john.smith@company.com>** 的电子邮件更改为 **<jonathan.smith@company.com>**，Zoom 就无法可靠地判定这两者是同一个人（因为基础标识符已不同），因此 Zoom 会在该用户首次 **<jonathan.smith@company.com>** 登录时创建一个新账户。

为简化此问题，Zoom 提供了“唯一员工 ID”功能，可将用户的主要标识符从电子邮件地址更改为已确立的唯一 ID。 *这不会更改用户的 Zoom 用户名*，而是提供另一种标识属性。如果满足以下条件，此更改可让 Zoom 在 Zoom 中动态更新用户的电子邮件地址：

* 一个 *新的* 电子邮件地址同时附有已知的唯一员工 ID；并且
* 受影响用户的电子邮件域已在 Zoom 中关联

例如，如果 **<john.smith@company.com>** 通过身份验证，并为“员工唯一 ID”属性提供值 12345（其员工编号），Zoom 现在就会根据所声明的值在账户中识别该用户。如果 John 再次使用电子邮件地址 **<jonathan.smith@company.com>** 同时继续传递员工唯一 ID 12345，Zoom 将识别出 <john.smith@company.com> 现在 **<jonathan.smith@company.com>** 并在域名已关联的情况下，动态更新账户中的用户电子邮件地址。

身份管理员应 *确保* 在为此类别建立映射之前，没有两个用户使用相同的员工唯一 ID 值。如果另一个用户通过身份验证并传递相同的值，电子邮件地址将再次更新为新用户的地址，这可能会严重影响用户服务和体验。

<mark style="color:蓝色;">**员工唯一 ID 功能要求关联域才能更改用户的电子邮件**</mark>

除非电子邮件域名已正式关联到您的账户信息，否则员工唯一 ID 功能无法更新用户的电子邮件地址。请参阅我们的支持文章 [关联域](https://support.zoom.us/hc/en-us/articles/203395207) ，了解更多信息。

<mark style="color:蓝色;">**管理员和所有者无法通过员工唯一 ID 更新其电子邮件**</mark>

Zoom 中管理员和所有者的电子邮件无法通过员工唯一 ID 功能更新。此举旨在作为一项安全措施，以阻止未经授权的访问。管理员和所有者必须通过其个人资料页面更改电子邮件。

<mark style="color:蓝色;">**用户电子邮件只能通过员工唯一 ID 每天更新一次**</mark>

用户电子邮件只能通过员工唯一 ID 功能每 24 小时更新一次。用户必须从上次更新起等待完整的一个日历日，才能再次通过 SSO 更新其电子邮件。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXct3ljK0YW8k8R82DXpS2__Hf8KB0qkleCQ_il6l4GcgeuhekPfPn55csfETIAauFfPQkmW7VBQOTDd2C9o39lzcTWDnMXZMW9FixnWOhCxraDttTdnKbXXF4aU1TrSOrh-9U388A?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>更新用户电子邮件的示例流程图。</p></figcaption></figure></div>

<mark style="color:蓝色;">**将该属性设置为 \<NameID> 将使用用户断言的 NameID**</mark>

将员工唯一 ID 属性映射到 **\<NameID>** 将自动使用用户断言的 NameID 值作为其唯一标识符。如果身份提供商断言的 NameID 不是用户的电子邮件地址，而是用户主体名称 (UPN) 或其他不会更改的类似值，这会是一个有益的工具。如果用户的 NameID 与其电子邮件地址相同，请勿使用此值。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfc-LwwficUxnJVa6raeHY3XwO_bRUnOo3Px-FpVWxCXKTEVRI2zoCRbp9Mjzsj1gyiTVmPy-gHryvIjpBuxrM8Me38KvWu0gf-mrPrnwxnaK9tk_hsywxF25Slq3Yh99iKINVPmw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>&#x3C;NameID> 管理员设置示例。</p></figcaption></figure></div>

### 高级映射：许可证和附加组件

“高级信息映射”部分可在用户进行身份验证时，动态地为用户分配许可证（包括 Zoom Phone）、附加组件和用户访问组。与基础映射不同，高级映射有许多细节需要注意；配置时所需的谨慎程度取决于环境的复杂性。本部分重点介绍配置高级响应映射时需要注意的细节。有关受支持属性的完整列表，请参阅我们的 [高级映射文章](https://support.zoom.us/hc/en-us/articles/115005081403-Setting-up-advanced-SAML-mapping) 。

#### <mark style="color:蓝色;">高级映射会在用户每次进行身份验证时应用</mark>

与某些类别具有可选更新的基础映射不同，根据自上而下的应用程序顺序，高级映射配置将在用户每次进行身份验证时应用。

例如，如果用户拥有基础版许可证，然后通过 SSO 进行身份验证并传递一个属性和值，该属性和值映射为授予完整许可证，那么用户将立即获得完整许可证。如果随后在身份提供商中更改用户的配置文件，将其移回基础版许可证，那么当他们在 Zoom 中重新进行身份验证时，将重新分配基础版许可证。

#### <mark style="color:蓝色;">高级映射允许每个类别使用多个属性和值</mark>

与基础映射不同，基础映射每个类别只允许一个属性，而高级映射可以支持每个类别的多个属性和值。这使得在通过身份提供商中的安全组管理用户许可证和访问时具有很大的灵活性，如下面的配置所示。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcw0QbtEMEhc4KtDF3LZsfAIgir_-AB2XGFaJ6qWplazLgxbyRSunevolbVjRFe196QBnWeqwA8dPSnvGbyhg-TSH1yJ2iZvElnIDPU6j1wRuka_5MndC3rAjXADRJIqPmoeESo?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>高级属性映射示例。</p></figcaption></figure></div>

{% hint style="success" %}
**Zoom 提示**

属性因身份提供商而异，尤其是安全组相关属性。请向身份提供商确认，或通过 [响应日志](#response-logs-tell-you-which-saml-values-and-attributes-are-being-asserted) 了解属性是如何被断言的。
{% endhint %}

#### <mark style="color:蓝色;">当声明了多个属性时，高级映射会自上而下应用许可证</mark>

如果用户传递了为高级映射配置的多个属性或值，Zoom 将自上而下映射许可证。请参见以下示例：

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd6ejdpzRIK8EUzyzdyomoHNChq-XkoS85btacDjLOAKyBQVwIQ15dzUKqsE_l8iFDOJiYGUjh4W7XaTRapGaZp5tx7R2J06yvpbwSna1YVjR9_ms8nn1haaJiNxaaL6wQ7XdC1QA?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>管理员 设置中的许可证类型选择示例。</p></figcaption></figure></div>

根据上述配置，如果用户同时传递了以下两项的属性： **global\_users** 和 **营销**，因为 **营销** 在配置中的优先级最高，因此此属性将应用于用户，其余符合条件的属性将被忽略。

或者，如果配置设置为 **global\_users** 具有最高优先级（如下方截图所示），如果用户的断言中包含 **global\_users**, **营销**, **人类** **资源**，以及 **信息技术**，因为 **global\_users** 具有最高优先级，只会声明基础版许可证。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfdQrc0QA5GFNzFVBIa9y1HH0GdkDMzeSomo4GdhE8xHCQzwozv2CXWRkdedXemhuAoZ81rfa21kPlO_0DalY2oasz6XDJkLD88NaNQiH686EX9Rfuxb-mje5go5uep9Fp3RBQuKw?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>调整优先级顺序的示例</p></figcaption></figure></div>

Zoom 管理员可以在编辑映射值时，使用编辑器中的 ↑↓ 箭头调整应用程序顺序。

{% hint style="success" %}
**Zoom 建议**

按从最具体到最通用的顺序配置高级配置，以阻止许可证误用。
{% endhint %}

#### <mark style="color:蓝色;">网络研讨会和大型会议映射可以共享一个公共值，以应用这两个添加组件</mark>

为简化应用程序流程，Zoom 管理员可以配置两次相同的属性和值，以便为用户同时应用网络研讨会和大型会议附加组件，如下图所示： **global\_users** 值。如果需要，也可以独立配置这些附加组件，如下所示： **网络研讨会\_only** 和 **large\_会议\_only** 值。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdY6Py9Rb7L7iKsez3UXpg9ZwL-gxgmpO5QjLDXdeZC42EJDCHEw82ghcAm4m5Rb8fZ8GQvT5rd47j-p4JeR6DUUAujw7ARMynCsLKPLrJVGjlkiEp2YtRk-sOZNaQPUQWYRRTsmQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>大型会议_only 和 网络研讨会_only 的属性示例。</p></figcaption></figure></div>

#### <mark style="color:蓝色;">指定用户和用户组可以免于特定映射</mark>

“高级映射”下的每个选项都可以配置为将特定用户和用户组从映射行为中豁免。这对于防止 VIP 用户因许可的潜在更改而导致服务中断很有帮助。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXftnv80dtlXFIYqMKvlB0mecwcoX7_IEQIFXed3x-9szHtQv3X-h_aLv5gkJ4_9q0wIJI3YlxNdPS3aR--_TOt3Xv8_ZGfv2Fqrv9hSSAEvaY4e69nEPQIpVGHMk6fTbKareeawww?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>用户豁免示例。</p></figcaption></figure></div>

#### <mark style="color:蓝色;">Zoom 支持最多八个自定义属性</mark>

Zoom 管理员最多可以配置 *八个* 自定义属性，以便在其 Zoom 个人资料中添加用户数据，位置在 [高级用户管理](https://zoom.us/account/user#/advanced) 页面。添加自定义字段后，Zoom 管理员可以在 [响应映射](https://zoom.us/account/sso/mapping) 页面上配置映射。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcxmWWYpKRYP078q0iwYdK9tfmcmAHLuwZtoSn7VoUeeRbdki2udbiF0Yh7pUczEG_rXqZGS1zBbDl4-OODAZYMFEkISb4L55mahN_6hAqt87dCo8fT4Yj7aQVw1ivuZtzksdmhQg?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>自定义属性示例</p></figcaption></figure></div>

#### <mark style="color:蓝色;">将用户映射到子账户</mark> *<mark style="color:蓝色;">仅</mark>* <mark style="color:蓝色;">应用会议许可证和附加组件</mark>

将用户映射到子账户只会将用户的会议许可证和附加组件（如网络研讨会和大型会议）应用到子账户。用户群组、IM 群组、用户角色等不会应用，必须在子账户中配置。

对于需要通过子账户进行响应映射并获得更高灵活性的客户，将需要一个唯一的实名网址和在子账户内进行新的 SSO 配置。

### 高级映射：用户和联系人群组分配

用户群组和联系人群组分配是高级映射中以两种不同模式运行的部分： *标准映射* 和 *多重映射*.

* **标准映射** 只应用单个匹配项。管理员可以配置许多属性和值对，但用户进行身份验证时，只有第一个匹配项生效，其余匹配项将被忽略。因此，要实现特定结果，必须进行精准配置。这是所有账户的默认行为。
* **多重映射** 是一种可选模式，可应用所有匹配项。一次身份验证可以同时匹配多个属性和值，从而一次性将用户分配到多个群组。这非常适合群组结构复杂、用户分布在各种用户群组和联系人群组中的账户。必须通过 Zoom 支持启用多重映射。

#### <mark style="color:蓝色;">**标准映射会将用户分配到第一个匹配的用户群组或联系人群组**</mark>

在标准映射下，当用户的断言在用户群组或联系人群组类别中匹配多个已配置值时，Zoom 只会应用配置中最上方的匹配项。条目按自上而下的顺序进行评估，并应用第一个匹配项。该类别中的其余匹配项都将被忽略。

例如，在一个包含二十组映射到不同用户群组的属性和值对的配置中，某个用户的断言若匹配其中多个配对，则只会被放入与最高匹配条目相关联的群组中。

#### <mark style="color:蓝色;">一个值可将用户添加到多个群组中，且第一个被添加的群组将成为主群组</mark>

Zoom 管理员可以配置用户群组映射，以便使用一个值将用户添加到多个群组中。这种行为在标准映射和多重映射中都适用。

添加的第一个用户群组将设为用户的主要群组，并决定用户的默认设置 *除非底层群组锁定了某项设置*。有关用户群组的更多信息，请参阅我们的 [支持文章](https://support.zoom.us/hc/en-us/articles/204519819-Managing-user-groups-and-settings).

在下图中，如果用户提供了以下值： **领导层**, **人力资源**和 **受监管**，则用户只会被分配到 **领导层**对应的群组，因为这是第一个匹配项，后续匹配项均不适用。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdER0NnN7GSalp5YpVpM9EW068VLrDgdHOJty4Hm6blWIOEghH5Woj7B8s7io1X2U3ywZEiyvU5cJE4pEcCJtSrlhAsaPnzLK44CVAlU_k1Igqt4y8ejYfFAw-ILkKulqXUGqohrg?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>标准用户群组映射示例。</p></figcaption></figure></div>

#### <mark style="color:蓝色;">多重映射会将用户分配到每个匹配的用户群组和联系人群组，最多可匹配 50 条规则</mark>

启用多重映射后，Zoom 会应用 *所有* 用户群组和联系人群组类别中的匹配项，而不只是最靠前的匹配项。同一属性最多可以配置五十次；每个与断言相匹配的已配置值都会将用户分配到对应的群组。

这意味着，一个属性若带有五十个不同的值，并且每个值映射到不同的群组，就可以在一次身份验证中将用户放入全部五十个群组。这使身份提供商的安全群组与 Zoom 群组之间建立一对一关系成为可能，因此，在身份提供商中将用户添加到某个安全群组时，会在他们下次身份验证时将其分配到相应的 Zoom 群组。

在下图中，如果用户提供了以下值： **领导层**, **测试**, **AI**和 **人力资源** 并且启用了多重映射，用户将被分配到所有用户群组，因为启用多重映射后，Zoom 会应用前 50 条规则匹配项。

<div data-with-frame="true"><figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2F1BU0JBMg5uBirl6FGTX4%2FScreenshot%202026-08-19%20at%2012.17.26%E2%80%AFPM.png?alt=media&amp;token=cd1aba57-b23c-4989-a24d-e2dc37cf9785" alt="" width="563"><figcaption><p>多重映射用户群组示例</p></figcaption></figure></div>

主群组的指定不受映射模式影响。在标准映射和多重映射中，首个匹配并被添加的群组都会成为用户的主群组，除非底层群组有已锁定的设置。

#### <mark style="color:蓝色;">多重映射可简化大型企业版环境中的群组分配</mark>

多重映射降低了将用户分配到多个用户群组或联系人群组所需的配置精确度。在标准映射下，将用户放入多个群组依赖于自上而下的精确配置，并且必须在一次评估中正确解析。多重映射通过一次应用所有匹配条目消除了这一限制，这支持用户属于许多群组的环境，以及在单次处理过程中难以执行逐属性、逐值配置的环境。

#### <mark style="color:蓝色;">多重映射需要通过 Zoom 支持启用</mark>

无法通过标准 SSO 管理界面启用多重映射。要启用此功能，必须向 Zoom 提交 [支持请求](https://support.zoom.com/hc/en/contact?id=contact_us) 并请求为该账户激活多重映射。在请求处理完成之前，用户群组和联系人群组分配仍采用标准的首个匹配项行为。

### 高级映射：自动映射

#### <mark style="color:蓝色;">自动映射作为一种后备机制，在没有明确规则匹配时，会将用户分配到一个以其断言值命名的用户、频道或 IM 群组</mark>

自动映射可用于将用户自动分配到一个以其断言值命名的用户群组、频道和 IM 群组。与其他可配置为基于值将用户分配到任意群组的高级映射组件不同，自动映射始终会根据精确值将用户分配到群组。如果该群组之前不存在，则会自动创建。

自动映射作为后备机制，仅在用户的断言与上述高级映射部分中配置的任何明确规则都不匹配时才会应用。如果用户已经通过明确规则被分配到某个群组——例如，基于身份提供商安全群组成员资格被放入某个用户群组——则该明确分配具有优先级，相应的自动映射规则将被忽略。在同一示例中，由用户部门值自动映射的用户群组将不会应用，因为明确的用户群组规则已经匹配。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcleVut-f8Pq1AdmwMk0CU5uE4MYhIFAdSPSxxVbyoMyS2e24V3RL9AD_VhcVCTtoh0PFswB_8JTwlOMYm_TCTKria2nIAOVtg7iI3rlKdsWAwpe5UlM-AfuthKuAnG8_mu71VPcw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>自动映射配置示例。</p></figcaption></figure></div>

例如，如果自动映射设置为根据部门将用户映射到各群组，而用户没有匹配该类别的明确规则，那么如果其部门值尚未为用户群组、频道或 IM 群组定义，系统会自动将用户分配到一个与其部门名称匹配的群组中，如下表所示：

| 属性 | 值    | Zoom 群组是否已存在？ | 结果                |
| -- | ---- | ------------- | ----------------- |
| 部门 | 人力资源 | 是             | 用户被添加到人力资源群组      |
| 部门 | 市场营销 | 是             | 用户被添加到市场营销群组      |
| 部门 | 销售   | 否             | 创建销售群组，用户被添加到销售群组 |

## SSO 故障排除

#### <mark style="color:蓝色;">可保存响应日志以便故障排除</mark>

Zoom 可以将身份验证尝试的响应日志保存七天。这些响应日志不仅有助于排查响应映射配置问题，也是排查配置和用户错误的宝贵工具。有关更多信息，请参阅 [使用响应日志排查错误](#using-saml-response-logs-to-troubleshoot) 部分。

{% hint style="success" %}
**Zoom 建议**

启用保存响应日志可让故障排除更轻松。
{% endhint %}

#### <mark style="color:蓝色;">使用响应日志进行故障排除</mark>

保存的响应日志不仅有助于排查响应映射配置问题，也是排查配置和用户错误的宝贵工具。如果您将 Zoom SSO 配置为保存响应日志，可以通过高级设置中 SSO 配置页面里的 [响应日志](https://zoom.us/account/sso/saml_logs) 选项卡访问这些日志。要查看响应日志，请点击身份验证尝试旁边的 **查看详细信息** 。

#### <mark style="color:蓝色;">大多数身份验证都会显示在响应日志中</mark>

大多数失败或未成功的身份验证尝试都会显示在响应日志页面上。如果某次身份验证尝试未显示，最有可能的原因是 Zoom 未从您的身份提供商接收到断言，或者已禁用保存响应日志。

#### <mark style="color:蓝色;">响应日志可以告诉您配置是否有误或证书是否已过期</mark>

启用保存响应日志后，身份提供商的信息会被断言给 Zoom，以对各方的身份进行身份验证。如果某个被断言的设置或信息字符串（如 X509 证书或颁发者 ID）与 Zoom 当前配置不同，就会出现错误，提示该信息“与当前 SSO 设置不匹配”。如果这些被断言的值是正确的，Zoom 管理员可以更新 SSO 配置使其与之匹配，以解决该错误。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe5ElE9oAkqrfuutEG32SjtnF-aPpSu_MbRIy3h6oRhTiHnBC3okBRHk57sWwuJgg3a8_WD_mYoK_Wd5bJ1zMkLScazjdXshmBUZyXvBVtmyQO75Rl7ox_MCgT6X-AzcA?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>配置错误警告示例。</p></figcaption></figure></div>

#### <mark style="color:蓝色;">响应日志会告诉您哪些值和属性正在被断言</mark>

查看响应日志有助于通过验证用户在身份验证时被断言的属性和值来解决响应映射配置问题。这些内容可以与配置进行比较，以确保属性和值相匹配。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe-BD98pFvpYplXC-sVB4KKlUFDc0dOzjv-VzEOyH5tOBQbt-yiK8e82nkLGC7FmBJIekP-VVqEBVnullP173ydJLkNDFh6nCcOfup1UHlTTYl2l0DDitymKeid4NO7ZZYaw6J3sQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>身份提供商服务正在断言的信息示例。</p></figcaption></figure></div>

如果属性或值缺失，则说明身份提供商服务并未断言该信息。遇到此问题的用户建议联系其身份提供商支持服务以获取更多帮助。

#### <mark style="color:蓝色;">响应日志在失败时包含错误代码和简要说明</mark>

如果用户无法身份验证或收到错误，响应日志会包含错误代码和该错误的简要说明。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcUxXpQNQM4ZUpgIHUF2s__t4s3fM4sjWqXqv5y4i4oop4ygRKYcxxdeC7pIX7_O8sgxFmbrkPd6PrlLam4zptYZNKleBKEXFEUd0o97IvJZvRfZi81sSfKr6wwvfxemuzg_UDi?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>错误代码和说明示例。</p></figcaption></figure></div>

大多数问题都可以通过这些错误消息识别并解决。如果您无法解决该错误，请联系 Zoom 支持以获得进一步帮助。

#### <mark style="color:蓝色;">Web 跟踪 ID 错误</mark>

如果用户在 SSO 身份验证中失败，他们将收到一个 WEB 跟踪 ID 错误代码。这些代码并不是与特定失败相关的错误消息，而是一个唯一的日志 ID，可在响应映射中查看以识别身份验证问题。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdg3Btc3wYZ71fAL7VX5G0OiLOQ-YKOAmt1-fytPE2xDRktbVLQqw_r2rURYLExtZ2rSfIIqelDEM8oZ47-gFBKdn2Ze9V6kx5nB_kuxZlYIKP2Hy24Ot0SXrobSdLg4BfudOs_?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>带有 WEB 跟踪 ID 错误代码的用户端错误示例。</p></figcaption></figure></div>

若要识别错误（前提是已启用响应日志记录），请前往 [响应日志](https://zoom.us/account/sso/saml_logs) 选项卡，该选项卡位于“高级设置”中的 SSO 配置页面内。然后，在“跟踪 ID”字段中输入 WEB 跟踪 ID 并进行搜索，以填充响应日志

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcbDm_F5qgN7TwBk0PiItomqHcaoFUFU8VAmTECFtzogW1sjvlJiIYaK2pXniGKDIEUnEZOg1-xHYrpteg6foFyec_SlpRVjqjUmrNa1lbPvdCEwnuZtOU1yvqfuGYh-enXmq5f?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>使用前述 WEB 跟踪 ID 错误代码搜索响应日志的示例。</p></figcaption></figure></div>

响应日志应显示收到的断言，以及响应底部的错误代码和消息，可用于进一步故障排除。

### SCIM 故障排除

### 错误

#### <mark style="color:蓝色;">用户不存在或不属于此账户</mark>

当目标用户的电子邮件地址因账户已存在而无法进行预配时，就会发生此错误。建议 Zoom 管理员直接联系该用户，并手动邀请其加入账户。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>预配错误示例。</p></figcaption></figure></div>

#### <mark style="color:蓝色;">无法添加付费用户</mark>

当 SCIM 尝试预配用户，但账户许可证不足时，就会发生此错误。要解决此错误，必须将该用户预配为基础版用户，或者为预配提供可用许可证。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>预配错误示例。</p></figcaption></figure></div>

### 使用 SCIM 日志排查用户预配问题

Zoom 在 [Zoom Marketplace](https://marketplace.zoom.us/)中提供最近 100 条 API 请求日志。Zoom 管理员可以使用这些日志，确认通过预配 API 发送和接收的信息。要访问这些日志，请以 Zoom 管理员身份登录 Zoom Marketplace，然后点击 **管理**。在下一页中，选择 **呼叫日志** 下方的 **个人应用管理**。然后，点击某条记录以展开 API 日志并查看其内容。

下图展示了 SCIM 用户预配请求示例，并突出显示了用户的身份和许可证属性，供参考。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcIxosFPBR8E4f1hj0vZQ7_nxnRd_isIqJYhKTQbocw4UfXlCBCkscqx8bGvY8JwuazgtRROPJm9PCZfZ4hJ5GQBqBzJA-PgS-mXkptGa0xq82SMXjl9Ip-faCDk3OQuLUXK0iobQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>SCIM 用户预配请求示例。</p></figcaption></figure></div>

与响应映射一样，Zoom 只能应用身份提供商在预配请求中提交的信息。请使用这些日志确认身份提供商是否提交了用户身份和许可证属性。如果这些声明中缺少预期信息，请联系身份提供商以获得支持。

## 数据流和身份验证

#### <mark style="color:蓝色;">SAML 身份验证</mark>

下图详细说明了用户在通过 Zoom 发起单点登录会话时的 SAML 身份验证流程。

<div data-with-frame="true"><figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fn4Ai7NfBYzUEjqKsNoVv%2FArtboard%2044.png?alt=media&amp;token=e49cfac0-e0bb-4c8a-803d-21f47d429dd1" alt=""><figcaption><p>SAML 身份验证流程示意图。</p></figcaption></figure></div>

#### <mark style="color:蓝色;">OIDC 身份验证</mark>

下图详细说明了用户在通过 Zoom 发起单点登录会话时的 OIDC 身份验证流程。

<div data-with-frame="true"><figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2FcjmgOKsyrj2jyyoIawfb%2FArtboard%2045.png?alt=media&amp;token=91662b66-e166-41b1-a1ee-a9351ae9a348" alt="Diagram of an example SAML authentication flow."><figcaption><p>SAML 身份验证流程示意图。</p></figcaption></figure></div>

#### <mark style="color:蓝色;">SSO Web 登录令牌</mark>

用户通过身份验证后，其会议会在浏览器中建立，默认有效期为两小时。如果用户继续主动使用 Zoom 网页，会议将会刷新；但是，如果用户两小时内未使用网页，令牌将过期，用户必须重新进行身份验证。Zoom 管理员可以在以下位置配置此有效会议时长： [安全性](https://zoom.us/account/setting/security) 页面中的“用户在一段时间不活动后需要重新登录”设置，以及 **设置网页不活动时长（分钟）**.

#### <mark style="color:蓝色;">客户端登录令牌</mark>

当用户尝试通过客户端中的 SSO 进行身份验证时，用户的设备会打开一个网页浏览器并重定向到身份提供商的登录页面。用户身份验证后，其浏览器将收到一个 Zoom 客户端启动令牌。一旦用户点击“打开”或“启动”按钮，浏览器就会使用 URL 方案和启动令牌来打开 Zoom 客户端。

Zoom 客户端将使用启动令牌从 Zoom 服务器获取访问令牌和刷新令牌。客户端每次使用访问令牌的时长为两小时；令牌过期后，客户端将使用刷新令牌获取一组新令牌，并将其存储在客户端的本地数据库中。默认情况下，此刷新过程不受限制，会不断循环使用令牌，直到用户登出或令牌过期。Zoom 管理员可以在以下位置自定义会议时长： [SSO 设置](https://zoom.us/account/sso) 页面中的 [*强制自动登出*](#zoom-administrators-can-enforce-automatic-logout-after-a-defined-length-of-time).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/zh/guan-li-yuan-zhuan-qu/account-and-endpoint-management/sso-field-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
