> 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-tw/guan-li-yuan-zhuan-qu/account-and-endpoint-management/sso-field-guide.md).

# 單一登入實用指南

## 簡介

將單一登入（SSO）與 Zoom 整合，可為管理員提供使用者管理與安全性選項，簡化帳戶管理。設定完成後，使用者會使用公司憑證向貴公司的身分識別提供者進行驗證，而不是使用其他驗證方式，例如透過第三方應用程式使用 Oauth，或直接使用 Zoom 的使用者名稱和密碼登入。

本文提供 Zoom 中 SSO 設定與選項的完整概覽，以及疑難排解與安全性資訊。

## 設定 SSO

#### <mark style="color:藍色;">開始前需要先有 Vanity URL 才能使用 SSO</mark>

帳戶必須先取得已核准的自訂 URL，才能設定 SSO。自訂 URL 核准後，Zoom 管理員即可透過網頁入口網站的進階選項子選單前往 [SSO 設定](https://zoom.us/account/sso) 頁面。如需詳細資訊，請參閱我們的支援文章： [自訂 URL](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 可與任何支援 Security Assertion Markup Language（SAML）2.0 或 OpenID Connect（OIDC）驗證的身分識別提供者整合。

#### <mark style="color:藍色;">Zoom 管理員可透過回應對應或 SCIM 整合管理使用者個人資料資訊與授權</mark>

管理員可依據身分識別提供者所提供的功能，透過回應對應或 System for Cross-Domain Identity Management（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 提示**

按一下供應商或 Zoom 文件欄中的 ✔，即可在新視窗中開啟說明。
{% 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 Sync Tool</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 SSO](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0083701).

### 其他設定選項

#### <mark style="color:藍色;">Zoom 可支援多個 Vanity URL 與／或多個身分識別提供者應用程式</mark>

Zoom 帳戶可支援多個 Vanity URL、多個身分識別提供者（IdP）設定，或兩者的組合。支援的設定包括：

* 多個共用同一 IdP 設定的 Vanity URL。
* 多個 Vanity URL，每個都有獨立的 IdP 設定。
* 單一 Vanity URL 連結至多個 IdP 設定。

這些設定由 Zoom 支援團隊啟用，無法透過標準的 SSO 管理介面設定。請提交 [支援要求](https://support.zoom.com/hc/en/contact?id=contact_us) 以啟用此功能，並提供所需的自訂 URL、IdP 設定，以及預期的驗證結果。

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

OIDC 驗證目前不支援多個 Vanity URL 或 IdP。若您不確定此情況是否適用於您，請與您的 Zoom 帳戶團隊聯絡以取得更多資訊。
{% endhint %}

#### <mark style="color:藍色;">內部部署的 Active Directory 可改用 AD Sync Tool，而非 SCIM</mark>

若帳戶希望透過 SCIM 自動佈建使用者，但沒有雲端式身分識別提供者，可使用 Zoom 開發的 Active Directory (AD) Sync Tool 應用程式來管理使用者。此應用程式在 Oracle JDK 8 上執行，並透過 API 指令管理使用者，以模擬 SCIM 佈建。如需詳細資訊，請參閱我們的支援文章： [AD Sync Tool](https://support.zoom.us/hc/en-us/articles/115005865543-Managing-the-AD-Sync-Tool) 。

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

AD Sync Tool 需要精確設定才能進行使用者管理。在全面導入前，必須徹底測試並檢閱此工具的設定，以避免服務中斷。
{% 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. 所有使用者都會使用主帳戶的自訂 URL 進行驗證，並透過進階回應對應自動登入子帳戶（[部分對應功能有所限制](#mapping-users-to-a-sub-account-will-only-apply-a-meeting-license-and-add-ons))
2. 每個子帳戶都有獨立的 Vanity URL 和獨立的 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 管理員可以在網頁入口網站的 [使用者管理](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 assertion 或 OIDC claim）會在 *驗證事件中*傳遞使用者資訊。使用者登入前不會套用任何設定，而資訊則會包含在 assertion 中。

SCIM 完全不傳遞任何斷言或聲明。身分識別提供者依照自己的排程直接呼叫 Zoom 的 API，無論使用者是否曾登入，都會傳送使用者資訊。這使 SCIM 能在沒有使用者介入的情況下建立、更新、停用與刪除帳戶，也因此 SCIM 能管理帳戶狀態，而回應對應則無法做到。

SCIM 可與任一佈建模式相容，且最常與預先佈建一起部署。

如需瞭解如何為您的帳戶設定 SCIM（適用於 Entra ID 或 Okta），請參閱 [Entra ID 與 Okta 的 SCIM 實用指南](https://library.zoom.com/technical-library/zh-tw/guan-li-yuan-zhuan-qu/account-and-endpoint-management/scim-guide.md) 。

{% 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 管理員只有在電子郵件網域已與 Zoom 關聯並由 Zoom 管理時，才能強制使用者 *一律* 使用 SSO 驗證。啟用此功能後，所有使用公司網域進行驗證的使用者，都會自動重新導向至身分識別提供者的驗證頁面，不受平台限制。

網域核准並納入管理後，Zoom 管理員即可在帳戶的 [安全性頁面](https://zoom.us/account/setting/security) 之下的 **登入方式**中強制使用 SSO 驗證。如需瞭解如何關聯及管理網域，請參閱我們的支援文章： [關聯的網域](https://support.zoom.us/hc/en-us/articles/203395207) 。

#### <mark style="color:藍色;">指定使用者可豁免於強制 SSO 驗證</mark>

Zoom 管理員可以將特定使用者排除在強制 SSO 驗證之外。如果 SSO 設定發生問題，帳戶管理員可能需要以非 SSO 方式存取 Zoom 帳戶，因此排除特定使用者（例如管理員帳戶）會很有幫助。獲豁免的管理員可在帳戶遭鎖定或 SSO 設定失效時隨時登入 admin.zoom.us（使用者必須具有標準的 **管理員** 角色）。如果 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 憑證自動登入 Zoom for Outlook 增益集</mark>

使用 Office 365 的客戶可以使用 SSO 憑證自動將使用者登入 Zoom for Outlook 增益集。此功能可搭配 [自訂增益集資訊清單](https://support.zoom.us/hc/en-us/articles/360041403311) 使用，預先填入帳戶的自訂 URL，讓使用者享有流暢的驗證體驗。如果使用者的 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 值傳入。下表說明在傳遞使用者資訊時，屬性與值之間的關係。

| 屬性         | 值                              |
| ---------- | ------------------------------ |
| firstName  | John                           |
| lastName   | Smith                          |
| email      | <john.smith@companydomain.com> |
| department | Human Resources                |

透過正確地將屬性指派給回應對應，使用者資訊可自動套用至使用者個人資料，簡化帳戶建立與管理流程。

### 基本對應：個人資料資訊

基本對應用於將目錄中的名字、姓氏、部門、電話號碼、成本中心和地點等個人資訊套用至使用者的個人資料。許多類別的用途顯而易見，也容易設定；但有些類別需要加以說明，才能正確設定，避免發生非預期的後果或應用程式錯誤。以下章節將重點介紹基本對應中的特殊對應選項和設定。如需支援的完整屬性清單，請參閱 [基本對應文章](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 Basic、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。

### 員工唯一識別碼

<mark style="color:藍色;">**員工唯一識別碼會變更 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>** ；如果該網域已與帳戶建立關聯，Zoom 便會在帳戶中動態更新使用者的電子郵件地址。

身分識別管理員應 *確認* 在為此類別建立對應之前，沒有兩位使用者會使用相同的員工唯一 ID 值。如果另一位使用者完成驗證並傳入相同的值，電子郵件地址就會再次更新為新使用者的地址，可能嚴重影響使用者服務與體驗。

<mark style="color:藍色;">**員工唯一識別碼功能需要關聯網域才能變更使用者電子郵件**</mark>

除非電子郵件網域已正式與您的帳戶設定檔建立關聯，否則員工唯一 ID 功能無法更新使用者的電子郵件地址。詳情請參閱我們的支援文章： [關聯的網域](https://support.zoom.us/hc/en-us/articles/203395207) 。

<mark style="color:藍色;">**管理員與擁有者無法透過員工唯一識別碼更新其電子郵件**</mark>

Zoom 中的管理員與擁有者電子郵件無法透過員工唯一識別碼功能更新。這是一項安全措施，旨在防止未經授權的存取。管理員與擁有者必須透過其個人資料頁面變更電子郵件。

<mark style="color:藍色;">**使用者電子郵件透過員工唯一識別碼一天只能更新一次**</mark>

使用者電子郵件透過員工唯一識別碼功能每 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** 和 **marketing**的屬性，由於 **marketing** 在設定中的優先順序最高，系統會將此屬性套用至使用者，並忽略其餘適用的屬性。

或者，如果設定將 **global\_users** 設為最高優先順序（如下方螢幕擷圖所示），而使用者提供的聲明包含 **global\_users**, **marketing**, **human** **resources**以及 **IT**，由於 **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:藍色;">Webinar 與大型會議對應可共用相同值來同時套用兩種附加功能</mark>

為了簡化套用流程，Zoom 管理員可以將相同的屬性和值設定兩次，讓使用者同時取得網路研討會和大型會議附加元件，如下圖中使用 **global\_users** 值的範例所示。您也可以視需要個別設定這些附加元件，如 **webinar\_only** 和 **large\_meeting\_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>large_meeting_only 與 webinar_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>

將使用者對應至子帳戶只會將該使用者的會議授權與附加元件（例如 Webinar 和大型會議）套用至子帳戶。使用者群組、即時訊息群組、使用者角色等不會套用，且必須在子帳戶中進行設定。

需要更高彈性的子帳戶回應對應客戶，將需要在子帳戶內使用獨特的 Vanity URL 以及新的 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).

在下圖中，如果使用者提供的值符合 **Leadership**, **Human Resources**和 **Regulated**，則使用者只會被加入 **Leadership**所屬的群組，因為這是第一個相符項目，且不會套用後續項目。

<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 群組。

在下圖中，如果使用者提供的值符合 **leadership**, **testing**, **AI**和 **human\_resources** ，且已啟用多重對應，使用者就會被加入所有使用者群組，因為啟用多重對應時，Zoom 會套用前 50 個符合規則的項目。

<div data-with-frame="true"><figure><img src="https://2668295848-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:藍色;">自動對應可作為備援機制，當沒有任何明確規則符合時，會將使用者指派到名稱與其宣告值相同的使用者、頻道或即時訊息群組</mark>

自動對應可用來自動將使用者指派到名稱與其宣告值相同的使用者群組、頻道與即時訊息群組。與其他可根據值將使用者指派到任意群組的進階對應元件不同，自動對應一律會根據精確值將使用者指派到群組。若該群組先前不存在，系統會自動建立。

自動對應作為備援機制，僅在使用者的斷言未符合上述進階對應區段中設定的任何明確規則時才會套用。若使用者已透過明確規則被指派到某個群組，例如依據身分識別提供者安全群組成員資格被放入某個使用者群組，則該明確指派具有優先順序，而對應的自動對應規則會被忽略。在同一個例子中，若根據使用者的部門值自動對應到某個使用者群組，則不會套用，因為明確的使用者群組規則已經符合。

<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>

例如，如果自動對應設定為依據使用者的部門將其對應到群組，而該使用者未符合該類別的明確規則，則若其部門值尚未為使用者群組、頻道或即時訊息群組定義，系統將會自動將使用者指派到與其部門名稱相符的群組，如下表所示：

| 屬性 | 值               | Zoom 群組是否已存在？ | 結果                 |
| -- | --------------- | ------------- | ------------------ |
| 部門 | Human Resources | 是             | 使用者已加入人力資源群組       |
| 部門 | 行銷              | 是             | 使用者已加入行銷群組         |
| 部門 | 業務              | 否             | 已建立業務群組，使用者已加入業務群組 |

## 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>

若已啟用回應記錄，請前往「進階設定」中 SSO 設定頁面的「 [回應記錄](https://zoom.us/account/sso/saml_logs) 」分頁以找出錯誤。接著，在「追蹤 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://2668295848-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://2668295848-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 網頁登入權杖</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-tw/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.
