> 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/scim-guide.md).

# Entra ID 與 Okta 的 SCIM 實用指南

用於建立 Entra ID 或 Okta 與 Zoom 之間自訂 SCIM 對應的指南

## 概覽

Zoom 的 SCIM2 API 提供了大量使用者屬性目錄，可控制授權、產品權益、角色、區域以及各項服務的設定。Microsoft Entra ID 與 Okta 的原生佈建整合只對應了其中一小部分——足以建立、更新與停用使用者，但不足以佈建 Zoom Phone 網站、Contact Center 套件、Revenue Accelerator 角色，或 Zoom 支援的其他數十種屬性。

本指南將說明一套可重複使用的方法，教您如何新增 *任何* Zoom SCIM 屬性至佈建設定。本文不會孤立地說明單一屬性，而是解釋其背後的模型，讓管理員能在 Zoom 的 SCIM2 API 參考資料中查找屬性，並自行設定，不必等待特定產品的文章發布。

### 如何使用本指南

請先閱讀以 [**了解 SCIM 屬性**](#understanding-scim-attributes) 開頭的「簡介」，以及後續章節，包括先決條件、目錄資料、參考案例和 Zoom 端驗證。無論您使用哪種身分識別提供者 (IdP)，這些內容都適用。接著，請依您使用的 IdP，閱讀 Microsoft Entra ID 或 Okta 章節。這兩個部分都從第一個設定步驟完整說明至驗證與實作範例；您不需要在兩者之間來回切換。

如需本指南所依據的 SSO 和 SCIM 基礎概念，請參閱 [SSO 實用指南](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide)、 [Entra ID 的 Zoom SSO 與佈建文章](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121)以及 [Okta 的 Zoom SSO 文章](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256).

{% hint style="danger" %}
**警告**

錯誤設定的佈建會影響既有使用者，包括移除已在使用中的授權。將每一項變更套用到正式環境之前，請先針對單一測試使用者進行驗證。
{% endhint %}

### **使用 SCIM 的前置條件**

本部分的所有內容都適用於任何身分識別提供者。請先閱讀本節，再進入你專屬的身分識別提供者操作說明。

#### 兩種身分識別提供者都通用的需求

* 已核准 [自訂 URL](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061540)
* 具備 Zoom 帳戶擁有者或管理員權限
* [單一登入](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) 的 Business、Education 或 Enterprise Zoom 帳戶
* 一個 [已驗證的相關網域](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) 位於 Zoom 帳戶中，且符合要佈建使用者的電子郵件網域
* 身分識別提供者與 Zoom 之間已建立 SCIM 佈建
* 被指派的 Zoom 授權、方案、附加元件或設定物件必須已存在，且可在 Zoom 帳戶中使用

各身分識別提供者特有的需求列在各自章節的開頭。

#### 兩種身分識別提供者都通用的限制

* SCIM 只能指派現有的權益，無法建立其所參照的物件。請參閱下方的「 [**進行進階對應前，Zoom 端必須先有 SCIM 可參照的物件**](#before-attempting-advanced-mapping-zoom-side-objects-must-exist-before-scim-can-reference-them) 」一節。
* 某些屬性每位使用者只能接受一個值。Zoom Phone 通話方案就是其中一例——像 Customer Engagement Pack 這類附加套件無法透過 SCIM 佈建。
* &#x20;`userType`  屬性已由 Zoom 標示為計畫棄用。

## **簡介**

### **了解 SCIM 屬性**

了解 Zoom SCIM 屬性如何組成的管理員，可以設定 Zoom 支援的任何屬性。照著範例操作的管理員，只能設定該範例所描述的屬性。本節說明其組成方式。將屬性對應到資料來源的部分，會在後面的身分識別提供者章節中說明。

#### <mark style="color:藍色;">每個屬性都有命名空間、名稱、資料型別，以及允許的值</mark>

先從一個完整且可運作的範例開始。以下是將使用者指派到 Zoom Phone 網站的識別碼：

```
urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite
```

此屬性涉及四項屬性設定。其中兩項顯示於上方那一行。另兩項則來自 API 參考資料，之後要在身分識別提供者的其他位置填入。就目前而言，我們著重於兩項： **命名空間** 和 **名稱**.

<table><thead><tr><th width="155.290771484375">屬性</th><th>從範例中擷取</th><th>作用</th></tr></thead><tbody><tr><td><strong>命名空間</strong></td><td><code>urn:ietf:params:scim:schemas:extension:zoom:1.0:User</code></td><td>告訴 Zoom 這個設定屬於哪個 schema，並作為幾乎所有 Zoom 產品與授權屬性的共用基底。作為識別碼的前半部傳給 Zoom。</td></tr><tr><td><strong>姓名</strong></td><td><code>zoomPhoneSite</code></td><td>指出正在寫入的特定 Zoom 設定——此處是使用者的 Zoom Phone 網站。作為識別碼的後半部傳給 Zoom。區分大小寫。</td></tr><tr><td><strong>資料型別</strong></td><td><code>string</code></td><td>告知身分識別提供者此屬性所存放的值類型，以便正確儲存及格式化。此項不會作為識別碼的一部分傳遞，而是要在 Entra ID 中另行指定為 <strong>類型</strong> ，或在 Okta 中指定為 <strong>資料類型</strong> 。</td></tr><tr><td><strong>允許的值</strong></td><td><code>LON-01</code>，Zoom Phone 網站名稱</td><td>實際套用至使用者的設定。某些屬性可填寫自由文字，其他屬性則有固定選項，例如 Zoom Contact Center 的 <code>Essentials</code>, <code>Premium</code>或 <code>Elite</code> 。佈建時會將此值傳送至 Zoom，由對應提供，而不是由識別碼提供。</td></tr></tbody></table>

{% hint style="danger" %}
**警告**

Zoom 公布了不只一個使用者擴充功能命名空間。產品設定和授權屬性使用 `urn:ietf:params:scim:schemas:extension:zoom:1.0:User`，本指南全篇皆使用此命名空間。department `department`, `manager`，以及 `costCenter` 使用 `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`。第三個 `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`，則包含 API 回應中傳回的登入類型資訊，而非佈建時設定的資訊。使用錯誤命名空間建立的屬性會被身分提供者接受，但 Zoom 會默默忽略。
{% endhint %}

#### <mark style="color:藍色;">在 SCIM2 API 參考資料中找到你需要的屬性</mark>

「 [SCIM2 API 參考文件](https://developers.zoom.us/docs/api/scim2/#tag/user/post/scim2/Users) 」列出 Zoom 在佈建期間接受的所有項目，是最具權威性的依據。需要注意兩項作業： **建立使用者** 和 **更新使用者**.

主要參考 **更新使用者**。每個人只會建立一次，但屬性會持續變更——辦公室搬遷、方案變更、角色變更、離職等——因此，隨著時間推移，佈建實際上大多是在更新資料。 **更新使用者** 也會說明 **建立使用者** 不需要包含的移除值，例如將 `zoomPhoneCallingPlan` 設為 `-1` 即可移除使用者的所有通話方案。

要尋找屬性：

* 開啟 SCIM2 API 參考文件，前往 **更新使用者**.
* 在要求本文中，找到 `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` 物件。本指南涵蓋的所有屬性都列在其中。
* 依名稱找到屬性，並記下其 **資料類型** 及其 **允許值**.
* 閱讀其旁的說明。說明中包含無法僅憑屬性名稱推知的行為—— `zoomPhoneExtNumber` 設為 `0` 會觸發自動分配分機， `zoomPhoneCallingPlan` 設為 `-1` 會移除所有通話方案，而 `zoomPhoneNumber` 必須參照 Zoom 帳戶中尚未分配的號碼。

#### <mark style="color:藍色;">組裝識別碼：父項、冒號、子項</mark>

列在該 `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` 物件中的所有項目都是它的 **子項** 。物件本身則是 **父項**。建立識別碼時，先命名父項，再加上冒號，最後加上子項：

```
父項       urn:ietf:params:scim:schemas:extension:zoom:1.0:User
冒號       :
子項       zoomPhoneSite

識別碼     urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite
```

整個構造就是這樣。你不需要向 Zoom 索取查詢表，也不需要產生任何東西——這個識別碼就是你已經擁有的兩部分，以冒號連接而成。

#### <mark style="color:藍色;">父項保持不變；只會更換子項</mark>

由於父項是固定的，因此設定第二個、第五個或第十五個屬性，只是在相同動作後附加不同的子項：

```
基底（父項）              urn:ietf:params:scim:schemas:extension:zoom:1.0:User

Zoom Phone 網站            urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite
Zoom Phone 號碼          urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneNumber
Zoom Phone 分機       urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneExtNumber
Zoom Phone 通話方案    urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneCallingPlan
```

同一個父項可承載其他所有 Zoom 產品。當產品改變時，這個組成方式也不會改變：

```
Contact Center 套件     urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomContactCenterPackage
Revenue Accelerator 角色   urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole
Workplace 套件           urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomWorkplace
Zoom Docs                  urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomDocs
```

因此你只需學一次父項。從那之後，設定新屬性只代表在 API 參考資料中查找三件事：子項名稱、資料型別，以及允許的值。

如果你能組合出父項和子項，那麼這份設定中最困難的部分就已經過去了。接下來剩下的是告訴你的身分識別提供者每個值應該從哪裡來——這會在後面的 Entra ID 與 Okta 章節中說明——以及決定先處理哪些屬性——這會在下一節說明。

#### <mark style="color:藍色;">兩種對應：基本與進階</mark>

不是每個屬性的風險都相同，設定任何東西之前先把它們分類是值得的。

本指南沿用 **基本** 和 **進階** 來自 [SSO 指南](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide)，其中對 SAML 回應對應也劃出相同界線。這些術語描述的是 **Zoom 收到值時會如何處理**，而不是設定該屬性的難易度。就實際操作而言，兩者完全相同：都記載於同一個 **更新使用者** 請求本文中，都是以相同的「父項:子項」結構建立，也都透過 Entra ID 和 Okta 中相同的步驟宣告及對應。

* **基本對應** 會將文字寫入使用者的個人資料。Zoom 會原樣儲存收到的值，絕不會拿它與任何內容比對。
* **進階對應** 則會向帳戶提出要求。Zoom 會取得該值並尋找相符的物件，或已購方案中的可用授權席位；而查找可能會失敗。

<table><thead><tr><th width="199.435791015625"></th><th>基本對應</th><th>進階對應</th></tr></thead><tbody><tr><td><strong>值的意義</strong></td><td>儲存在使用者個人資料上的文字</td><td>指向 Zoom 中某個物件的指標，或對已購買席位的主張</td></tr><tr><td><strong>範例</strong></td><td><code>department</code>, <code>title</code>, <code>costCenter</code></td><td><code>zoomPhoneSite</code>, <code>zoomContactCenterRole</code>, <code>zoomWorkplace</code></td></tr><tr><td><strong>父項</strong></td><td>最上層，或企業延伸</td><td>Zoom 延伸</td></tr><tr><td><strong>Zoom 中的前置條件</strong></td><td>無</td><td>物件必須存在，或席位必須是空閒的</td></tr><tr><td><strong>如果值錯誤</strong></td><td>錯誤的文字會出現在個人資料上</td><td>該屬性會被拒絕，或被悄悄忽略</td></tr></tbody></table>

這項差異會影響兩個實務上的決策。它決定了 **必須先在 Zoom 中建立哪些項目** ——基本對應不需要建立任何項目，進階對應則可能需要建立許多項目——也決定了 **出錯時的代價**。部門填錯只會造成個人資料上的外觀錯誤。網站名稱填錯或沒有可用的授權席位，則會使使用者無法使用正常運作的電話，或無法使用受聘時預期使用的產品；在正式部署環境中，還可能移除原本已有使用權限者的授權。

後果上的這種差異，就是下面將兩者分開說明的原因。

#### <mark style="color:藍色;">基本對應：個人資料資訊</mark>

基本對應會填入使用者 Zoom 個人資料上的描述性欄位。Zoom 會完整儲存每個送入的值，且從不將其與既有物件驗證，因此不需要先在 Zoom 建立任何東西，也不會因值錯誤而造成損壞。

**核心身分欄位通常已完成對應。** `userName`, `name.givenName`, `name.familyName`, `displayName`以及 `emails` 位於請求本文的頂層，沒有任何父項；Entra ID 和 Okta 整合也都預設會對應這些欄位。請先確認它們是否正確，而不是重新建立。 `title`, `phoneNumbers`以及 `locale` 也位於頂層，但可能需要新增。

**企業欄位會再多一層父項。** 結構不變，只需變更父項：

```
基底（父項）         urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

部門            urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department
成本中心           urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter
員工編號       urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber
組織          urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization
主管               urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager
```

透過 SCIM 填入 Department 與 Cost Center 不再需要 SAML 對應。

{% hint style="info" %}
**建議**

先對應一個基本屬性—— `department` 是個不錯的選擇，並且會在參考情境中以 **情境 0** 進行完整示範——在設定 Zoom 擴充功能下的任何項目之前，先針對單一測試使用者執行端對端測試。 `department` 值正確顯示在 Zoom 個人資料上，即可證明結構描述宣告、對應、範圍設定，以及您讀取佈建記錄的能力都正常。後續每個進階屬性的差異，只在於它指向的對象，而不在於設定方式。
{% endhint %}

#### <mark style="color:藍色;">進階對應：產品設定與權益</mark>

進階對應會指派使用者能做的事：Zoom Phone 網站與通話方案、Contact Center 角色與套件、Workplace 套件、Revenue Accelerator 區段。這些屬性都位於本指南全程使用的 Zoom 延伸父項之下。

關鍵差異在於，這些值不會儲存，而是會 **解析**。Zoom 會使用您傳送的值，尋找相符的物件或可用的授權席位。基本對應會將文字寫入個人資料；進階對應則是向帳戶的設定和資產清單提出要求，而該要求可能會失敗。

這就是本指南為何花整個章節說明前置條件。每個進階屬性都依賴於 Zoom 網頁入口網站中先前已建立或購買的某些內容，而且其失敗模式遠比拼錯職稱來得不寬容。

#### <mark style="color:藍色;">每種設定都共通的三個層次</mark>

無論是哪個屬性或哪個身分識別提供者，工作都一樣分為三個層次。只有各控制項的位置不同。

<table><thead><tr><th width="114.4166259765625">層次</th><th>用途</th><th>Microsoft Entra ID</th><th>Okta</th></tr></thead><tbody><tr><td><strong>1. 宣告</strong></td><td>告訴身分識別提供者該屬性存在於 Zoom 應用程式中，讓它可作為對應目標。</td><td>步驟 1</td><td>步驟 1</td></tr><tr><td><strong>2. 對應</strong></td><td>定義值的來源。</td><td>步驟 2</td><td>步驟 2–3</td></tr><tr><td><strong>3. 範圍</strong></td><td>決定此設定適用哪些使用者，以及何時執行。</td><td>步驟 3–5</td><td>步驟 4–5</td></tr></tbody></table>

一旦理解這個模式，新增第五個或第十五個屬性只是重複同樣的三個層次，而不是一個新專案。

#### <mark style="color:藍色;">Entra 與 Okta 在值可從何處取得方面有所不同</mark>

這是兩條路徑之間最具影響力的架構差異，也解釋了為什麼相同的商業需求在 Entra 與 Okta 之間會產生不同的設定。

* **Entra ID 只會從使用者物件屬性擷取值。** 值必須來自使用者的欄位，也就是現有的目錄欄位或專用的擴充屬性。如果目錄值和 Zoom 值的字串不同，就必須使用運算式進行轉換。
* **Okta 可從使用者設定檔或群組指派擷取值。** 使用 **屬性類型：群組** 可讓您在群組上設定一次值，並由每位成員繼承。若組態依循組織架構，就完全不需要翻譯邏輯。

沒有哪種方法在所有情況下都更好，但它們會導向不同的設定。

### **Zoom 端前置設定需求**

#### <mark style="color:藍色;">在嘗試進階對應之前，Zoom 端的物件必須先存在，SCIM 才能參照它們</mark>

SCIM 是指派機制，而非建立機制——它會將使用者連結至 Zoom 帳戶上已存在的組態，且它 **無法** 代替使用者建立該組態。

許多進階對應屬性都是 **參照**：您傳送的值必須能對應至 Zoom 中已存在的物件，例如網站、角色、範本、已購買的方案、特定號碼或分機。這些項目都適用同一項規則：

> 如果某個屬性名稱指向某樣東西，那麼那樣東西必須已存在，必須與送出的拼法完全一致，而且——若它依賴有限資源池——必須還有未使用的容量。

當被參照的物件不存在時，SCIM 既不會建立它，也不會排入請求。該屬性要不是直接失敗，並在佈建記錄中回傳錯誤；不然就是被悄悄丟棄——Zoom 接受負載、不做任何事，並回報成功。

以下章節依產品拆解前置條件，並附上建立各項內容的導覽路徑與支援文章。先閱讀帳戶層級說明，再閱讀你打算佈建的各產品章節。

#### <mark style="color:藍色;">任何產品在佈建前都適用的帳戶層級前置條件</mark>

本指南開頭列出的帳戶需求——自訂 URL、SSO、SCIM 授權，以及已驗證的相關聯網域——是後續所有屬性的先決條件。請在 [**管理中心**](https://zoom.com/account) → [**安全性與信任**](https://zoom.com/account/setting/security)中設定安全性和 SSO，並在 [**管理中心**](https://zoom.com/account) → **帳戶** → [**帳戶設定檔**](https://zoom.com/account)中管理相關聯網域；請參閱 [Zoom + Microsoft Entra ID SSO/SCIM 組態](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121).

另外有兩點值得明確說明：

* **購買授權席位不等於指派席位。** SCIM 會執行指派，但必須先有席位。請參閱 [為使用者指派或移除 Zoom 授權](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911).
* **席位必須屬於所要求的確切方案。** 如果該特定方案沒有可用席位，即使帳戶中的其他方案仍有剩餘席位，傳送授權屬性仍會失敗。

#### <mark style="color:藍色;">Zoom Phone</mark>

Zoom Phone 擁有最多的參照屬性，因為一個電話使用者是由數個預先購買或預先建立的基礎架構元件組成。

| 屬性                                           | 必須先存在的內容                                              | 如何建立                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Zoom Phone 授權本身                              | 可用的 Zoom Phone 席位——這是下方任何項目都能附加的前置權益。                 | 請預先購買。請參閱 [購買及指派 Zoom Phone 授權](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929).                                                                                                                                                                                                                                                                                                       |
| `zoomPhoneSite`                              | 網站名稱必須與送出的值完全一致。若省略該屬性，則會指派帳戶的主要網站；在啟用多網站後，這個網站預設就存在。 | [管理中心](https://zoom.com/account) → 產品組態 → 電話系統 → [公司資訊](https://zoom.com/pbx/page/telephone/settings#/settings) → **新增網站**，或使用 **匯入** 進行大量建立。請參閱 [管理多個網站](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716).                                                                                                                                                                             |
| `zoomPhoneNumber`                            | 號碼必須已購買或已攜入帳戶，且目前未被指派。已被其他使用者、通話佇列或自動總機持有的號碼不能重複使用。   | [管理中心](https://zoom.com/account) → 產品組態 → 號碼 → [電話號碼](https://zoom.com/cpw/page/phoneNumbers#/number-list)。請在此購買或移轉號碼，並讓目標號碼保持未指派狀態，這樣 SCIM 才能將其指派。請參閱 [使用號碼管理功能管理電話號碼](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0074457) 以及 [管理電話號碼](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060212).                                                                       |
| `zoomPhoneExtNumber` （僅限特定值）                 | 3–6 位數且尚未使用的分機。若傳送 `0`，則無須提供此值，因為會將指派工作交由 Zoom 處理。    | [管理中心](https://zoom.com/account) → 產品組態 → 電話系統 → [使用者與會議室](https://zoom.com/pbx/page/telephone/phoneUsers#/users) → 選取包含該分機的物件 → **設定檔** → **分機號碼** → **編輯**。請參閱 [變更電話使用者設定](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069338).                                                                                                                                                          |
| `zoomPhoneCallingPlan`                       | 通話方案，必須已購買且有可用容量，並以其正確的方案代碼參照。                        | 請預先購買。請參閱 [購買及指派 Zoom Phone 授權](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929) 和 [管理電話使用者](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069309)。方案代碼列於 [Zoom Phone 通話方案參考資料](https://developers.zoom.us/docs/api/references/phone-calling-plans/)，或由 `type` API 回傳 [列出通話方案](https://developers.zoom.us/docs/api/references/phone-calling-plans/) API，並附上可用席位數。 |
| `zoomPhoneCallingPlanSubscription` （僅限多訂閱帳戶） | 當帳戶對同一方案持有多個訂閱時，方案應從中提取的特定訂閱。                         | 方案與計費 → 訂閱管理。                                                                                                                                                                                                                                                                                                                                                                                                      |

**分機號碼池由不同類型的物件共用，不只供使用者使用。** 通話佇列、自動總機、共用線路群組和公共區域電話都會占用同一範圍內的分機號碼。這是最常見的「分機號碼已在使用中」錯誤原因，因為管理員只檢查使用者清單時，該分機看起來可能是空閒的。

**號碼移轉完成前，移轉的號碼無法指派。** 該號碼必須已新增至帳戶且尚未指派；僅開始移轉並不符合這兩項條件。

**網站是最常見的阻礙因素** 因為建立網站本身就有特定要求。網站地址會與實際地址資料庫核對，因為這些地址是緊急通話服務的基礎，因此虛構的地址與郵遞區號組合會因驗證錯誤而遭拒。大量匯入網站時，「自動總機」欄位必須填入 `Yes` 而非介面中顯示的標籤文字；來電顯示名稱主要適用於美國和加拿大，若造成驗證失敗，可以留白。

#### <mark style="color:藍色;">Zoom Contact Center</mark>

Contact Center 的佈建是以角色與範本為基礎。個別屬性必須解析為既有的 Contact Center 物件，而範本會承載那些沒有專屬 SCIM 屬性的設定。

| 屬性                              | 必須先存在的內容                                         | 如何建立                                                                                                                                                                                                                                                                                               |
| ------------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomContactCenterPackage`      | 搭配未使用席位購買的套件： `Essentials`, `Premium`或 `Elite` 。 | 請預先購買；若要購買其他 Premium 套件，可能需要先聯絡 Zoom 支援。請參閱 [變更 Zoom Contact Center 使用者設定](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874).                                                                                                                                            |
| `zoomContactCenterAddonsPlan`   | 附加方案，必須已購買且有可用容量。                                | 請預先購買；帳戶方案與計費資訊。                                                                                                                                                                                                                                                                                   |
| `zoomContactCenterRole`         | 角色，無論標準或自訂，都必須完全同名。若省略，會指派預設的 Agent 角色，該角色預設即存在。 | [管理員中心](https://zoom.com/account) → CX 管理 → Contact Center → [角色](https://zoom.com/cci/index/admin#/admin-next/admin-roles) → **新增** → 設定權限 → **儲存**。請參閱 [管理 Zoom Contact Center 角色](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941).                                  |
| `zoomContactCenterRegion`       | 區域。若省略，會指派帳戶的主要區域，而該區域必須先設定。                     | [管理員中心](https://zoom.com/account) → CX 管理 → Contact Center → [偏好設定](https://zoom.com/cci/index/admin#/admin-preferences) → 地區 → **新增地區** → 輸入名稱並選取 SIP 區域 → **新增**。請參閱 [管理 Zoom Contact Center 地區](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668).                    |
| `zoomContactCenterUserTemplate` | 使用者範本，名稱必須完全一致。新增類型範本會在建立使用者時套用；更新類型範本會在更新時套用。   | [管理中心](https://zoom.com/account) → CX 管理 → Contact Center → 使用者 → [範本](https://zoom.com/cci/index/admin#/admin-agents#templates) → **新增範本** → 選擇 **新增** → 設定角色、套件、佇列和技能 → **新增**。請參閱 [管理 Zoom Contact Center 使用者設定範本](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). |

{% hint style="danger" %}
**警告**

Contact Center 區域功能必須先由 Zoom 支援啟用後，才能建立區域，而且每位使用者只屬於一個區域。由於這是支援請求而非自助式切換，若計畫部署多區域，請盡早提出。
{% endhint %}

**收件匣、佇列和技能沒有 SCIM 屬性。** 若要佈建這些項目，請先在 [管理中心](https://zoom.com/account) → CX 管理 → Contact Center 中預先建立，並將其附加至使用者範本，再透過 `zoomContactCenterUserTemplate`指派該範本。因此，它們會成為 *範本* 的必要條件，而非個別使用者的必要條件；當需求變更時，也只需維護範本這個單一物件。

<table><thead><tr><th width="123.2821044921875">物件</th><th>如何建立</th></tr></thead><tbody><tr><td>佇列</td><td><a href="https://zoom.com/account">管理中心</a> → CX 管理 → Contact Center → <a href="https://zoom.com/cci/index/admin#/admin-queues">佇列</a> → <strong>新增佇列</strong> → 名稱、通道、客服專員 → <strong>儲存</strong>。請參閱 <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0061959">管理 Zoom Contact Center 佇列</a>.</td></tr><tr><td>技能</td><td><a href="https://zoom.com/account">管理中心</a> → CX 管理 → Contact Center → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-skills">技能</a> → 選取類別 → <strong>新增技能</strong> → 名稱 → <strong>新增</strong>。請參閱 <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059519">管理技能與技能類別</a>.</td></tr><tr><td>收件匣</td><td><a href="https://zoom.com/account">管理中心</a> → CX 管理 → Contact Center → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-inbox">收件匣</a> → <strong>新增收件匣</strong>。請參閱 <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059471">管理 Zoom Contact Center 收件匣</a>.</td></tr></tbody></table>

**同時提供範本和個別屬性時，以個別值為準。** 同時傳送範本與 `zoomContactCenterRole` 表示角色屬性會覆寫範本中的角色設定，因此參照的角色和範本都必須存在。

#### <mark style="color:藍色;">Zoom Revenue Accelerator</mark>

| 屬性                                                                  | 必須先存在的內容                                      | 如何建立                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------------- | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomRevenueAcceleratorPlan` 和 `zoomRevenueAcceleratorSubscription` | 已購買且有可用席位的 ZRA 方案或訂閱。                         | 請預先購買；帳戶方案與計費資訊。                                                                                                                                                                                                                                                           |
| `zoomRevenueAcceleratorRole`                                        | 角色，可以是標準角色或自訂角色，例如 `Sales Manager` —名稱必須完全相符。 | [管理員中心](https://zoom.com/account) → 使用者 → [角色](https://zoom.com/role#/) → **Revenue Accelerator** 索引標籤 → **+ 新增角色** → 名稱和說明 → **新增** → 設定權限 → **儲存變更**。請參閱 [使用 Zoom Revenue Accelerator 角色管理](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). |
| `zoomRevenueAcceleratorSegment`                                     | 使用者所屬的區段。                                     | Revenue Accelerator 管理員設定。                                                                                                                                                                                                                                                 |
| `zoomRevenueAcceleratorRegion`                                      | 區域，例如 `US`.                                   | Revenue Accelerator 管理員設定。                                                                                                                                                                                                                                                 |

#### <mark style="color:藍色;">Zoom Workplace 授權與帳戶角色</mark>

除了上述三項產品之外，標準使用者記錄還包含遵循相同規則的角色與授權參照。

| 屬性                                                                                                                                                                                                        | 必須先存在的內容                                | 如何建立                                                                                                                                                                                        |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `roles[]` (`value` / `display`)                                                                                                                                                                           | 帳戶角色，名稱必須完全一致。角色由 SCIM 參照，但絕不由 SCIM 建立。 | [管理員中心](https://zoom.com/account) → 使用者 → [角色](https://zoom.com/role#/) → **新增角色** → 名稱和說明 → 設定權限。請參閱 [使用角色管理](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). |
| `zoomWorkplace` 及其他授權或附加元件屬性 — Whiteboard、Scheduler、Clips Plus、Translated Captions、Workforce Management、Quality Management、Compliance Management、CX Insights、AI Sales Assist，以及它們的 `...Subscription` 對應項目 | 相對應的套件或附加功能，並以未使用席位購買。                  | 方案與帳單 → 方案管理 → 編輯方案 → 增加授權數量。請參閱 [升級您的帳戶和附加元件](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375).                                                                 |
| `loginType` (`sso` / `workEmail`），位於 `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`                                                                                                                    | 帳戶上已設定的 SSO，適用於 SSO 登入類型。               | [管理員中心](https://zoom.com/account) → 安全性與信任 → [單一登入](https://zoom.com/account/sso/saml).                                                                                                     |

對於授權或附加功能屬性，並沒有可命名的物件，但其前提條件在效果上是相同的：若該特定池中沒有可用席位，指派就會失敗。

#### <mark style="color:藍色;">沒有前提條件的屬性</mark>

每個基本對應屬性都符合條件，詳見 **基本對應：個人資料** — Zoom 會原封不動地儲存這些值，絕不會與現有物件進行驗證。Zoom 擴充功能中的兩個屬性也採用相同方式：

* **自動委派值** — `zoomPhoneExtNumber` 會以 `0`傳送，由 Zoom 自行配置分機號碼。
* **帳戶自訂屬性** — `{customAttribute}` 欄位，會儲存您傳送的任何字串。

**有預設值的參照** 屬於折衷情況：省略 `zoomPhoneSite`, `zoomContactCenterRole`或 `zoomContactCenterRegion` 時，會分別使用主要據點、預設的客服專員角色，以及主要區域。這些預設項目本身必須存在，而它們預設就會存在。

**群組則是部分例外。** 啟用群組佈建時，SCIM 會建立尚不存在的 Zoom 群組，並完全照原樣使用來源群組的名稱。它不會對該群組套用任何產品設定 — 群組建立後會包含成員，但沒有其他設定。Zoom Phone 政策、通話權限及其他群組層級設定，仍須在群組出現後前往 [管理中心](https://zoom.com/account) → 使用者 → [群組](https://zoom.com/account/group#/) 進行設定。

{% hint style="info" %}
**建議**

請將 Zoom 端的建置視為一個有自己驗收簽核的前置階段，並在屬性對應工作開始前完成與驗證。站點、號碼、方案、角色與模板通常由不同團隊管理，若在佈建測試期間才發現缺少物件，成本遠高於事先確認其存在。
{% endhint %}

### **準備您的目錄資料**

SCIM 會傳送來源中的任何內容。它不會驗證、正規化或更正。對任何屬性進行對應之前，請確認來源資料的三件事：

* **範圍內的每位使用者都會填入此欄位。** 未填入的欄位不會傳送任何內容，或會傳送已設定的預設值。
* **其值的格式與大小寫一致。** 兩個身分識別提供者的比對邏輯都採用完全比對。
* **其值與 Zoom 預期的值完全相符。** Zoom 不會以模糊比對方式比對據點名稱、角色名稱或方案值。

若現有欄位無法同時滿足這三項條件，為此整合刻意建立並填入的專用屬性，會比重用其他系統也會寫入的欄位更具可維護性。

{% hint style="info" %}
**建議**

在動身配置身分識別提供者之前，先決定誰是單一事實來源。大多數失敗的 SCIM 部署，本質上是目錄資料問題，只是表現為佈建問題。
{% endhint %}

### **參考情境**

本指南全程使用四個情境。無論身分識別提供者為何，其業務需求與 Zoom 端前提皆相同，因此只在此定義一次。每個特定身分識別提供者的章節最後都會示範如何在該平台上實作這四個情境。

#### <mark style="color:藍色;">情境 0：部門，作為第一個基本對應</mark>

使用者的部門應顯示在其 Zoom 個人資料上，資料來源為目錄。這是前面建議的第一個端到端測試基本對應，並在此納入以便在兩個身分識別提供者章節中都能完整演練。

**Zoom 端的先決條件。** 無。Zoom 會完全照原樣儲存傳入的值，絕不會與現有物件進行驗證。

**屬性。** 請注意，這裡的父層與下方三種情境不同 — `department` 位於企業擴充功能下，而非 Zoom 擴充功能下。

| 屬性                                                                      | 類型 | 備註                                                    |
| ----------------------------------------------------------------------- | -- | ----------------------------------------------------- |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` | 字串 | 自由文字。兩個身分識別提供者的使用者設定檔都已有 `department` 欄位，因此不需要新增來源屬性。 |

**為什麼從這裡開始。** 在 Zoom 個人資料中正確顯示部門值，可證明結構描述宣告、對應、範圍設定，以及您讀取佈建記錄的能力 — 同時不會冒著變更授權或電話設定的風險。以下每種進階情境的差異，僅在於屬性所指向的內容。

**先確認是否已經有對應。** Entra ID 與 Okta 的預設對應不同，而且兩家廠商更新 Zoom 整合時也會有所變動。請在 **佈建** → **對應** 在 Entra 中，或 **Zoom 屬性對應** 搭配 **顯示未對應的屬性** 在 Okta 中啟用。如果 `department` 已經對應，請確認其設定，而不要將它視為重複項目；如果您想從頭設定另一個屬性，請改用 `costCenter`, `organization`和 `employeeNumber` 位於相同的父層之下，且行為完全相同。

#### <mark style="color:藍色;">情境 1：Zoom Phone 站點與自動分機指派</mark>

應依使用者辦公地點將其放入正確的 Zoom Phone 站點，並在無需管理介入的情況下為其分配分機號碼。

**Zoom 端的必要條件** 網站必須事先建立。請在以下位置建立網站： [**管理中心**](https://zoom.com/account) → **產品設定** → **電話系統** → [**公司資訊**](https://zoom.com/pbx/page/telephone/settings#/settings) → **新增網站**，或透過 **匯入**批次建立。由於網站地址會用於緊急通話服務，因此系統會使用真實地址資料庫驗證地址；虛構的地址與郵遞區號組合將無法通過驗證。

**屬性。** 這兩個屬性都使用命名空間 `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:` 後接名稱。

| 屬性                   | 類型 | 備註                    |
| -------------------- | -- | --------------------- |
| `zoomPhoneSite`      | 字串 | 必須逐字逐字與 Zoom 站點名稱完全相符 |
| `zoomPhoneExtNumber` | 字串 | `0` 會觸發自動指派           |

**為何這個值 `0` 很重要。** 只有 Zoom 知道哪些分機號碼已在使用中，包括指派給呼叫佇列和自動總機，而非使用者的分機號碼。將指派工作交由 Zoom 處理，可避免一整類佈建失敗。在移轉期間，若要保留既有分機號碼，從目錄取得分機號碼會比較合適；但移轉完成後，應將對應切換為 `0` ，如此一來，未來加入的使用者就不必仰賴目錄資料持續維護。

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

Zoom Phone 帳戶上的預設網站通常名稱就是 `Main Site`，可在 [**管理中心**](https://zoom.com/account) → **產品設定** → **電話系統** → [**公司資訊**](https://zoom.com/pbx/page/telephone/settings#/settings)中找到。請先確認特定帳戶上的名稱，再使用此名稱，因為它可能已被重新命名。
{% endhint %}

#### <mark style="color:藍色;">情境 2：依國家而異的 Zoom Phone 通話方案</mark>

跨國組織已購買獨立的 Zoom Phone 通話方案，並需要讓每位使用者取得符合其國家的方案。

**Zoom 端的必要條件。** 帳戶必須已購買通話方案，且方案可供使用。方案值記載於 [Zoom Phone 通話方案參考資料](https://developers.zoom.us/docs/api/references/phone-calling-plans/).

**屬性。** `zoomPhoneCallingPlan` （字串）。

**如何取得正確的方案代碼。** `zoomPhoneCallingPlan` 接受的是數值型方案代碼，而非方案名稱。最可靠的取得方式是使用 [列出通話方案](https://developers.zoom.us/docs/api/references/phone-calling-plans/) API，此 API 會傳回每個方案的 `name`、其 `type` ——也就是您要對應的代碼——以及其 `subscribed` 和 `available` 席次數量。因此，一次呼叫即可確認方案存在、取得要傳送的值，並確認有足夠的容量可指派。

Zoom 網頁入口網站只會顯示名稱，不會顯示代碼，因此僅透過入口網站操作的管理員必須使用 [Zoom Phone 通話方案參考資料](https://developers.zoom.us/docs/api/references/phone-calling-plans/) 將顯示名稱轉換為代碼——例如， `UNLIMITED_PLAN_US_CA` 代表 `200` ，而 `UNLIMITED_PLAN_GB_IE` 代表 `202`則代表。參考資料列出的是常數名稱，而非入口網站中的文字，因此請根據方案特性確認是否相符——例如地區，以及按量計費或不限量——而非比對確切文字。

另外，Zoom 的 SCIM2 API 參考資料在範例承載內容中，顯示了類似 `phone_calling_usca_monthly_unlimited` 的帳務方案名稱。此識別碼用於 *購買* 訂閱，而非將方案指派給使用者。如果您需要指定方案所使用的訂閱，應在 `zoomPhoneCallingPlanSubscription`.

**為何 `-1` 會用作後援值。** SCIM2 參考資料將 `-1` 記載為可移除所有通話方案的值。對未能配對的使用者使用此值，可產生明確且可見的結果——不指派任何方案——避免完全不傳送值所造成的模糊情況。這也提供了一種簡潔的方式，可在不刪除使用者的情況下撤銷通話權限。

#### <mark style="color:藍色;">情境 3：Zoom Contact Center 套件、角色與區域</mark>

Contact Center 代理人在入職時就應佈建正確的 ZCC 套件與角色，而不是事後再手動設定。此情境說明該方法與產品無關——流程本身不變，變的只有屬性名稱與允許值。

| 屬性                         | 類型 | 允許的值                             |
| -------------------------- | -- | -------------------------------- |
| `zoomContactCenterPackage` | 字串 | `Essentials`, `Premium`, `Elite` |
| `zoomContactCenterRole`    | 字串 | 任何 ZCC 角色名稱。若未指定，預設為 `Agent` 。   |
| `zoomContactCenterRegion`  | 字串 | 任何已設定的 ZCC 區域。若省略則預設為主要區域。       |

**刻意省略屬性的說明。** 在單一區域部署中，請不要對應 `zoomContactCenterRegion` ，因為 Zoom 記載的預設值已符合需求。若屬性的預設值正確，省略該屬性比進行對應更好——每項對應都會增加維護責任。

**作業注意事項。** SCIM2 參考資料也記載了 `zoomContactCenterUserTemplate`，可套用預先建置的 ZCC 範本。新增類型範本會在建立使用者時套用，更新類型範本則會在更新時套用；若同一個要求中同時提供範本與個別屬性值，個別值會優先採用。如果 ZCC 設定相當複雜，以致難以維護大量個別屬性對應，則值得考慮使用範本。

### **Zoom 端驗證與常見錯誤**

每個身分識別提供者都有自己的記錄，並在各身分識別提供者的步驟 6 中說明。下方的 Zoom 端記錄對兩者都相同，且是 Zoom 實際收到內容的最終紀錄。

#### <mark style="color:藍色;">Zoom App Marketplace 呼叫記錄會顯示完整的請求與回應交換</mark>

1. 以帳戶擁有者身分登入 Zoom 網頁入口網站。
2. 前往 [**Zoom App Marketplace**](https://marketplace.zoom.us/) → **管理** → **帳戶上的應用程式**.
3. 選取代表身分識別提供者連線的應用程式。對 Entra 而言，通常名為 **Azure Identity** 或類似項目。
4. 開啟 **通話記錄** 分頁。
5. 使用 **依端點搜尋**，或使用日期範圍、方法和狀態篩選器，找出相關通話。
6. 選取該列以展開。
7. 檢視 `requestBody` 以查看實際傳送的內容，並檢視 `response` 以查看 Zoom 實際回傳的內容，包括產生的 Zoom 使用者 ID、 `httpStatus`以及產生的屬性集。

Zoom 會保留最近 100 筆 API 請求記錄，因此請及早調查失敗，而不是等到後續佈建活動將其覆蓋。

#### <mark style="color:藍色;">常見佈建錯誤及其原因</mark>

<table><thead><tr><th width="99.69622802734375">代碼</th><th>訊息</th><th>原因與解決方式</th></tr></thead><tbody><tr><td>400</td><td>帳戶尚未啟用單一登入。</td><td>SSO 是 SCIM 的前提。請先在 Zoom 帳戶上啟用並設定 SSO。</td></tr><tr><td>400</td><td>使用者已停用或遭鎖定。</td><td>目標 Zoom 使用者在目前狀態下無法更新。請在 Zoom 網頁入口網站中解決帳戶狀態。</td></tr><tr><td>403</td><td>因權限不足而拒絕請求："User:Edit"。</td><td>SCIM 連線背後的憑證缺少所需範圍。請使用擁有者或管理員帳戶重新授權連線。</td></tr><tr><td>404</td><td>使用者不存在。</td><td>身分識別提供者未將該使用者與現有 Zoom 使用者建立關聯。請驗證比對屬性與使用者名稱格式。</td></tr><tr><td>409</td><td>電子郵件網域與帳戶的關聯網域不相符。</td><td>使用者的電子郵件網域未與 Zoom 帳戶關聯。請先將該網域關聯並驗證後再佈建。</td></tr><tr><td>409</td><td>無法新增付費使用者。</td><td>沒有可用的所請求類型授權。請釋放帳戶中的可用容量，或將使用者佈建為 Basic。</td></tr><tr><td>409</td><td>無法使用 [bundle name] 建立更多使用者。</td><td>該特定套件已無剩餘席位。適用於 Workplace Business Plus、Enterprise Premier、Pro Plus 及其教育版對應方案。</td></tr><tr><td>429</td><td>請求過多。</td><td>佈建已超出 Zoom 的速率限制。若在多個週期中持續發生，請進一步調查。</td></tr></tbody></table>

#### <mark style="color:藍色;">有一種失敗模式完全不會產生錯誤</mark>

Zoom 接受但實際上不對應任何內容的值——例如尾端帶空白的站點名稱，或已在 Zoom 中重新命名的角色名稱——在語法上可能會被接受，但實際上不會套用到任何項目。記錄中不會標示此情況。相同問題的平台特定變體將在步驟 6 中說明。

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

當 Zoom 與身分識別提供者對使用者設定的看法不一致時，請將身分識別提供者視為權威來源並在那裡更正值。直接在 Zoom 網頁入口網站編輯會產生下一次佈建事件覆寫的狀態，使根本問題更難診斷。
{% endhint %}

## **使用 Entra ID 設定 SCIM**

#### <mark style="color:藍色;">Entra ID 的額外需求</mark>

* 具備存取 Enterprise Applications 的 Entra ID 管理員權限
* 您的使用者所使用的電子郵件網域已在 Entra ID 租用戶中驗證為自訂網域

#### <mark style="color:藍色;">Entra ID 的額外限制</mark>

* 屬性對應僅以 Entra *使用者物件* 中的屬性為來源。安全性群組無法直接提供 Zoom 屬性的值；群組成員資格只控制範圍，不會提供值。
* 增量佈建週期大約每 40 分鐘執行一次。啟用佈建後，變更不會立即生效。
* 由於 Microsoft 特有的限制，Entra ID 不支援 `Collaboration` 這個 `userType` 值。

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

標準佈建設定可在 `entra.microsoft.com` 或 `portal.azure.com`進行。不過，第 1 步中使用的結構描述編輯器只能透過附加 `forceSchemaEditorEnabled` 參數的 Azure 入口網站 URL 存取。此旗標對 `entra.microsoft.com`沒有作用。請在本節的所有步驟中使用第 1 步中的 Azure 入口網站連結，以免在設定過程中切換入口網站。
{% endhint %}

### 步驟 1：在 Zoom 應用程式結構定義中宣告屬性

每個屬性只需宣告一次。請在設定任何對應之前先宣告所有打算使用的屬性，這樣在步驟 2 時所有目標都可用。

1. 使用結構描述編輯器 URL 登入 Azure 入口網站： `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home`
2. 在 **Azure 服務**下方，選取 **Microsoft Entra ID**.
3. 在左側導覽功能表的 **管理**下方，按一下 **企業應用程式**.
4. 在應用程式清單中，按一下您的 Zoom 應用程式。\
   **注意**：應用程式名稱由 Entra 管理員在建立應用程式時設定。通常會命名為 **Zoom** 或 **Zoom SSO**，但在您的租用戶中可能有所不同。
5. 在左側導覽功能表的 **管理**下方，按一下 **佈建**.\
   **注意**：Azure 目前提供兩種版面配置之一。在舊版介面中，請選取 **編輯屬性對應** 位於 **管理佈建**下方。在新版介面中，頁面會開啟在 **概觀** 索引標籤；請從左側功能表再次選取 **佈建** 。兩種操作路徑都會前往相同位置。
6. 按一下 **對應** 下拉式選單，然後按一下 **佈建 Microsoft Entra ID 使用者**.\
   **注意**：在仍顯示舊版命名方式的租用戶中，此選項會顯示為 **佈建 Azure Active Directory 使用者**.
7. 在左下角，選取 **顯示進階選項** 核取方塊。
8. 按一下 **編輯 Zoom 的屬性清單**.
9. 捲動至第一個空白列並完成下列事項：
   * **名稱**：輸入完整的屬性字串，例如 `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **類型**：選取 **字串** 或 **布林值**，並符合 SCIM2 API 參考文件中所述的資料類型。
10. 對每個其他屬性重複步驟 9。
11. 在左上角，按一下 **儲存**.

{% hint style="warning" %}
**提醒**

屬性名稱區分大小寫，必須與 API 參考文件完全一致。 `zoomPhoneSite` 有效； `zoomphonesite` 和 `ZoomPhoneSite` 則無效。大小寫錯誤的屬性會通過結構描述編輯器的驗證，不會顯示錯誤，但會在 Zoom API 端靜默失敗。

對於文件中標示為 `boolean`, **字串** 也有效，前提是對應的來源提供文字字面值 `true` 或 `false`。選取 **字串** 通常更實用，尤其當來源是 Entra 擴充屬性時，因為這類屬性會儲存文字。
{% endhint %}

### 步驟 2：將目錄來源對應至屬性

Entra ID 提供三種對應類型，而它們之間的選擇是此設定中最關鍵的決定。

<table><thead><tr><th width="133.376708984375">對應類型</th><th>使用時機</th><th>行為</th></tr></thead><tbody><tr><td><strong>直接</strong></td><td>Entra 欄位已經持有 Zoom 預期的精確值。</td><td>將來源值原封不動傳遞。</td></tr><tr><td><strong>常數</strong></td><td>範圍內的每位使用者都應取得相同值。</td><td>將固定值傳送給每位已佈建的使用者。</td></tr><tr><td><strong>運算式</strong></td><td>值必須根據使用者屬性推導、翻譯或變化。</td><td>針對來源欄位評估運算式並傳送結果。</td></tr></tbody></table>

**若要建立對應：**

1. 返回 **佈建** → **對應** → **佈建 Microsoft Entra ID 使用者**.
2. 在左下角，按一下 **新增對應**.
3. 依所選類型設定對應——請參閱下方指引。
4. 按一下 **目標屬性** 下拉式選單，然後選取步驟 1 中宣告的屬性。
5. 按一下 **使用此屬性比對物件** 下拉式選單，然後選取 **否**.\
   **注意**：自訂 Zoom 屬性是組態值，不是身分比對索引鍵。只有用來關聯 Entra 使用者與 Zoom 使用者的屬性（通常是 `userName` ）才應設為 **是**.
6. 按一下 **套用此對應** 下拉式選單，然後選取 **一律**，讓此值在建立時及後續更新時皆適用。
7. 按一下 **確定**.
8. 為每個屬性重複上述步驟，然後按一下 **儲存** （位於 **屬性對應** 頁面頂端）。

#### <mark style="color:藍色;">直接對應會在不進行轉換的情況下傳遞既有欄位</mark>

* **對應類型**: **直接**
* **來源屬性**：值已與 Zoom 預期值完全一致的 Entra 欄位（逐字元相符）
* **值為空值時的預設值（選用）**：來源欄位為空時套用的備援值

直接對應最不容易出錯，只要目錄資料支援，就應優先採用。如果 `physicalDeliveryOfficeName` （在 Entra 使用者設定檔中顯示為 **辦公室位置** ）已包含與 Zoom Phone 網站名稱完全相符的值，直接對應即可，完全不需要任何邏輯。

{% hint style="info" icon="lightbulb" %}
**提示**

在 **值為空值時的預設值** 欄位填入值，以免來源值缺漏導致失敗或產生非預期結果。網站對應的預設值設為 `Main Site` ，可確保沒有辦公室位置的使用者仍能成功佈建，而不會落入未定義狀態。
{% endhint %}

#### <mark style="color:藍色;">常數對應會將單一值套用到範圍內的整個族群</mark>

* **對應類型**: **常數**
* **常數值**：要傳送的固定值

常數對應適用於單一設定的部署，也是多項 Zoom 專屬行為背後的機制。將 `zoomPhoneExtNumber` 設為 `0` 常數，會指示 Zoom 在使用者的網站中指派下一個可用的分機，完全避免分機號碼衝突。

#### <mark style="color:藍色;">表達式對應會在佈建時轉換或衍生值</mark>

* **對應類型**: **運算式**
* **運算式**：巢狀 `IIF()` 陳述式，用來評估一或多個來源屬性

只要目錄值與 Zoom 值不是相同字串，就需要表達式對應：

```
IIF([officeLocation]="London","LON-01",
IIF([officeLocation]="Manchester","MAN-01",
"Main Site"))
```

{% hint style="danger" %}
**警告**

運算式會依照輸入內容逐字比對文字，包括大小寫。 `GB` 和 `gb` 是不同的值， `United Kingdom` 和 `united kingdom`也是如此。比對失敗不會引發錯誤，而是直接使用預設分支，使用者會在毫無提示的情況下以錯誤的設定佈建。
{% endhint %}

請將來源值包在 `ToUpper()` 中，並以大寫常值進行比對，以消除大小寫不一致的問題：

```
IIF(ToUpper([country])="GB","202",
IIF(ToUpper([country])="UNITED KINGDOM","202",
"-1"))
```

#### <mark style="color:藍色;">來源欄位格式會隨 Entra 使用者的建立方式而異</mark>

這是表達式對應看起來正確、但在整個族群中行為不一致的最常見原因。

* **使用位置** 由 Microsoft 強制規定，必須始終包含有效的 ISO 3166-1 alpha-2 代碼，例如 `GB`，因為此欄位會影響授權和功能的可用性。這個欄位值得信賴。
* **國家或地區** 沒有這類強制規定，其內容取決於使用者的建立方式。透過 Entra 系統管理中心圖形介面建立的使用者會從完整國名的下拉式清單中選取，因此欄位通常會儲存 `United Kingdom`。透過 CSV 匯入或 PowerShell 建立的使用者，欄位通常會填入 `GB` ——這是慣例，而非強制規定。

在使用者透過多種方式建立的任何租用戶中， `country` 的格式都不會一致。請在建立運算式之前先統一欄位格式，或如上所示明確測試兩種格式。

### 步驟 3：將使用者與群組納入佈建範圍

指派會決定此設定會影響哪些使用者。超出應用程式指派範圍的使用者永遠不會受到任何對應影響，因此在推出期間，指派是主要的安全控制。

1. 前往 **Microsoft Entra ID** → **企業應用程式** → 您的 Zoom 應用程式 → **使用者和群組**.
2. 按一下 **新增使用者/群組**.
3. 在 **使用者和群組**下，選取預定的使用者或安全性群組。
4. 在 **選取角色**下，選擇適當的角色。
5. 按一下 **指派**.

實際上只有兩種角色值會用到。其他選項，例如 **公司** 和 **專業版** 不是正在淘汰的舊名稱，就是用於較少見的情境。

<table><thead><tr><th width="157.5225830078125">角色</th><th>效果</th></tr></thead><tbody><tr><td><strong>基本</strong></td><td>在沒有付費會議授權的情況下佈建使用者。當某個自訂屬性 — 例如 Zoom Phone 通話方案 — 負責指派付費權益時，請選用此項。</td></tr><tr><td><strong>已授權</strong></td><td>指定 Zoom 帳戶的 <em>預設</em> 授權方案，例如 Zoom Workplace Enterprise Plus。此畫面無法選擇特定套裝方案；預設方案是在 Zoom 端設定的。</td></tr></tbody></table>

無論要佈建多少自訂屬性，此角色選擇都會在每個加入應用程式的使用者或群組上套用一次。

**若要將 Entra 群組佈建為 Zoom 群組**（此功能預設為停用）：

1. 前往 **佈建** → **對應** 並選取 **佈建 Microsoft Entra ID 群組**.
2. 將 **已啟用** 切換為 **是**.
3. 確認已設定預設對應： `displayName` → `displayName`，以及 `members` → `members`.
4. 按一下 **儲存**.
5. 返回 **使用者和群組** 並確認指派給應用程式的是群組本身，而不只是群組中的個別成員。群組佈建只會處理直接指派的群組。

{% hint style="warning" %}
**注意：SCIM 對群組能做與不能做的事**

如果尚不存在名稱相符的 Zoom 群組，SCIM 會使用 Entra 群組的 `displayName` 依照原樣建立群組。建立的群組會包含成員，但 **不含任何產品設定**。管理員仍須前往 [**管理員中心**](https://zoom.com/account) → **使用者** → [**群組**](https://zoom.com/account/group#/) ，在 Zoom 網頁入口網站中套用預期設定，例如群組層級的 Zoom Phone 政策、通話權限或其他產品設定。SCIM 會佈建群組及其成員，但不會定義該群組在 Zoom 中的用途。
{% endhint %}

### 步驟 4：使用隨選佈建進行驗證

**隨選佈建** 的運作獨立於 **佈建狀態** 切換開關，這正是它適用於驗證的原因。到目前為止的每個步驟（包括此步驟）都可以在佈建仍關閉時完成。

1. 前往 **佈建** → **佈建概觀**.
2. 按一下 **隨選佈建**.
3. 搜尋並選取一位測試使用者，然後按一下 **佈建**.
4. 檢查結果。Entra 會回報每個佈建事件所執行的四個階段 — **匯入**, **判斷是否在範圍內**, **比對**和 **佈建** — 每個階段都可個別展開。
5. 確認顯示的屬性值符合您的預期。
6. 登入 Zoom 網頁入口網站並確認設定已套用。

{% hint style="info" %}
**建議**

請使用能代表使用者群體中 *最棘手* 情況的使用者進行驗證 — 例如海外使用者、透過不同方式建立的使用者，或來源欄位為空的使用者。只測試簡單情況，無法揭露步驟 2 所述的失敗模式。
{% endhint %}

### 步驟 5：啟用持續佈建

啟用佈建後，設定就會對範圍內的每位使用者即時生效。請先完成並驗證步驟 1 到 4。

1. 前往 **Microsoft Entra ID** → **企業應用程式** → 您的 Zoom 應用程式 → **佈建** → **佈建**.
2. 將 **佈建狀態** 切換為 **開啟**.
3. 按一下 **儲存**.

首次週期最多可能需要約 40 分鐘。後續增量週期大約每 40 分鐘執行一次。新加入者、屬性變更與停用都會依該排程同步，而不是立即同步。

### 步驟 6：使用 Entra 佈建記錄進行驗證

1. 前往 **Microsoft Entra ID** → **企業應用程式** → 您的 Zoom 應用程式 → **監視** → **佈建記錄**.
2. 搜尋或篩選測試使用者，然後選取相關事件。詳細資料檢視會顯示四個索引標籤： **步驟**, **疑難排解與建議**, **已修改的屬性**和 **摘要**.
3. 檢查 **摘要** 以確認動作是否成功。
4. 如果失敗，請開啟 **疑難排解與建議**，其中會顯示嘗試執行的動作、受影響使用者的主體名稱，以及 — 在 **詳細資料** — Zoom API 傳回的錯誤碼與完整錯誤訊息。

這比檢查對應畫面更可靠，因為它顯示的是實際傳送的值，而非預期由對應產生的值。如果 Entra 記錄無法提供明確結論，請改查 Zoom App Marketplace 呼叫記錄，詳見 **Zoom 端驗證與常見錯誤**一節；該記錄會顯示原始要求與回應的往返內容。

#### <mark style="color:藍色;">Entra ID 中的到職與離職行為</mark>

* 範圍是主要的安全控制。位於應用程式指派範圍之外的使用者，絕不會被此設定中的任何對應修改。
* 在 Entra 中停用使用者，或將其移出範圍，會自動反轉佈建並完成離職流程。
* 每次失敗都會產生對應的記錄項目 — 但仍有上文所述的靜默失敗注意事項。

### 步驟 7：在 Entra ID 中套用參考情境

各種情境、必要條件和屬性定義請參閱 [**參考情境**](#reference-scenarios) 一節。此處僅列出 Entra 對應。

**情境 0 — 部門。** 在步驟 1 中，宣告 `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` 設為 **字串**，請務必使用企業命名空間，而非 Zoom 命名空間。將其對應為 **直接** 從 Entra `department` 欄位。無需 **空值時的預設值** ——來源欄位為空時不會傳送任何內容，也不必在 Zoom 端建立對應物件。

**情境 1 — Zoom Phone 網站與自動分機。** 將 `zoomPhoneSite` 設為 **直接** 對應自 `physicalDeliveryOfficeName`，並將 **空值時的預設值** 設為 `Main Site`。將 `zoomPhoneExtNumber` 設為 **設為常數** ，值為 `0` ，除非您正在遷移既有的分機設定。如果辦公室位置值與 Zoom 網站名稱不完全相符，請改用 **運算式** 對應，格式如步驟 2 所示。

**情境 2 — 依國家／地區區分的通話方案。** 由於 Entra 無法從群組取得值，因此需要使用運算式。依各國家／地區新增更多 `IIF()` 層，並依步驟 2 所述，同時處理 alpha-2 代碼與完整文字格式：

```
IIF(ToUpper([country])="GB","202",
IIF(ToUpper([country])="UNITED KINGDOM","202",
IIF(ToUpper([country])="US","200",
IIF(ToUpper([country])="UNITED STATES","200",
"-1"))))
```

如果通話方案屬性會指派付費權益，請在步驟 3 選取 **基本** 而非 **授權** 。選取 **授權** 會另外套用帳戶的預設授權，這可能不符合預期的商業方案。

**情境 3 — Contact Center 套件、角色與區域。** 使用由可區分客服專員層級的目錄欄位所驅動的 `zoomContactCenterPackage` 運算式 **來對應，並將** 以此目錄欄位作為判斷依據；而 `zoomContactCenterRole` 則 **直接** 對應自存有角色名稱的欄位。單一區域部署中，請勿對應 `zoomContactCenterRegion` 。

## **使用 Okta 設定 SCIM**

#### <mark style="color:藍色;">Okta 的額外需求</mark>

* 具備 Profile Editor 存取權的 Okta 系統管理員權限

#### <mark style="color:藍色;">Okta 的額外限制</mark>

* 當使用者屬於多個群組且為同一屬性提供衝突值時，只會傳送優先權最高的群組值。請參閱步驟 5。

{% hint style="warning" %}
**注意：兩個設定檔，兩種用途**

Okta 維護兩種與此處相關的不同設定檔；了解兩者的區別，即可避免大多數初期的困惑。 **Okta 使用者設定檔** 是目錄中某個人員的值 *儲存* 的位置。 **Zoom 使用者應用程式設定檔** 是目錄中某個人員的值 *會傳送* 至 Zoom，其屬性會帶有 SCIM 外部名稱和命名空間。每位使用者的設定需要兩者，以及連結兩者的對應。群組層級的設定只需要應用程式設定檔屬性，並在群組指派中設定其值。
{% endhint %}

### 步驟 1：在 Zoom 應用程式使用者設定檔上宣告屬性

這個屬性才是真正將值傳送到 Zoom 的屬性。每個屬性只需宣告一次。

1. 登入 Okta 管理主控台。
2. 在左側導覽選單中，按一下 **應用程式**，然後按一下 **應用程式**.
3. 在 **狀態**下方，按一下 **啟用中**.
4. 按一下 **Zoom** 應用程式。\
   **注意**：應用程式名稱由 Okta 管理員在建立應用程式時設定。名稱通常為 **Zoom**，但在您的租用戶中可能不同。
5. 按一下 **佈建** 索引標籤。
6. 在 **Zoom 屬性對應**下方，按一下 **前往設定檔編輯器**.
7. 在 **屬性**下方，按一下 **+ 新增屬性**.
8. 請完成下列項目：
   * **資料類型**：選取 **字串** 或 **布林值**，並與 SCIM2 API 參考文件相符。
   * **顯示名稱**：輸入屬性名稱，例如 `zoomPhoneSite`.
   * **變數名稱**：輸入相同的名稱。
   * **外部名稱**：輸入 Zoom 文件所載的確切屬性名稱，例如 `zoomPhoneSite`.
   * **外部命名空間**：輸入 `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **說明** （選填）：記錄此屬性存在的原因，以及其值的來源。
   * **屬性類型**：選取 **個人** 表示每位使用者各自的值，或 **群組** 表示透過群組成員資格繼承的值。
9. 按一下 **儲存**，或 **儲存並新增另一個**.

{% hint style="danger" %}
**警告**

External name 和 External namespace 都必須正確。Zoom 公布的指引指定 External namespace 為完整 URN *其中包含* 屬性名稱，例如 `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole` 而非只有命名空間。這與一般 SCIM 慣例不同。請遵循上述格式，因為這是 Zoom 文件中說明可正常運作的設定。

屬性名稱在整個過程中都區分大小寫。大小寫錯誤的屬性會被 Profile Editor 接受而不報錯，並在 Zoom API 端靜默失敗。
{% endhint %}

### 步驟 2：在 Okta 使用者設定檔上建立來源屬性

若值是逐一由每位使用者持有，請完成此步驟。如果每位使用者的值都相同，或改由群組層級提供，則可略過。

1. 在左側導覽選單中，按一下 **目錄**，然後按一下 **設定檔編輯器**.
2. 按一下 **使用者** 索引標籤。
3. 在 **使用者** 方塊的 **篩選器**下方，按一下 **全部**.
4. 在 **Okta**右側，按一下 **使用者** 設定檔。
5. 在 **屬性**下方，按一下 **+ 新增屬性**.
6. 請完成下列項目：
   * **資料類型**：符合步驟 1 中宣告的 Zoom 屬性。
   * **顯示名稱** 和 **變數名稱**：輸入名稱，例如 `zoomPhoneSite`.
   * **列舉** （選用）：在 Zoom 屬性只接受固定值時，選取 **定義列舉值清單** 。
   * **必填屬性** （選用）：在範圍內的每位使用者都必須有值時，選取 **是** 。
7. 按一下 **儲存**.

{% hint style="info" icon="lightbulb" %}
**提示**

請為 Okta 使用者設定檔屬性與 Zoom 應用程式設定檔屬性使用相同名稱。Okta 不要求這麼做，但名稱一致可讓對應清單具有自我說明性，並在屬性數量增加時大幅減少疑難排解時間。
{% endhint %}

使用 **列舉** 每當 Zoom 文件中列出固定值集合時，都應使用選項，例如 Contact Center 套件、Workplace 組合代碼、Revenue Accelerator 方案值。在輸入時限制欄位可避免拼寫錯誤演變成無聲的佈建失敗，直到數週後因權益缺失才浮現。

### 步驟 3：將來源屬性對應到 Zoom 屬性

1. 前往 **應用程式** → **應用程式** → **啟用中** → **Zoom** 應用程式。
2. 按一下 **佈建** 索引標籤。
3. 在 **Zoom 屬性對應**下方，找到步驟 1 中宣告的屬性，然後按一下右側的編輯圖示。\
   **注意**：如果看不到該屬性，請按一下 **顯示未對應的屬性**.
4. 按一下 **屬性值** 下拉式選單，並選取 **從 Okta 個人資料對應**.
5. 按一下來源下拉式選單（預設顯示 `login | string` ），然後選取步驟 2 中建立的 Okta 使用者個人資料屬性。
6. 選取 **建立和更新**.\
   **注意**: **僅建立** 會在首次佈建 Zoom 使用者時套用值，之後不再套用。請謹慎選用此選項，適用於初次指派後不應遭到覆寫的值；其他情況則選取 **建立和更新** ，讓目錄中的變更能夠同步。
7. 按一下 **儲存**.
8. 對每個屬性重複一次。

{% hint style="warning" %}
**注意：衍生或轉換值**

如果 Okta 值與 Zoom 值的字串不同， **屬性值** 欄位也支援 Okta Expression Language，可用於條件邏輯和字串函式。運算式語法和可用函式會因 Okta 版本而異；大範圍套用前，請使用 **預覽** 針對單一測試使用者驗證任何運算式，並參閱 Okta 最新的 Expression Language 說明文件，確認支援的函式。

當轉換很簡單且值集合較小時，直接在 Okta 屬性上將 Zoom 值定義為列舉清單 — 或如步驟 5 所示使用群組層級屬性 — 通常比表達式更容易維護。
{% endhint %}

### 步驟 4：啟用對應用程式的佈建

在對應的佈建作業啟用之前，屬性對應不會生效。請在步驟 5 指派值之前先啟用它們。

1. 前往 **應用程式** → **應用程式** → **啟用中** → **Zoom** 應用程式。
2. 按一下 **佈建** 索引標籤。
3. 在 **佈建至應用程式**下方，按一下 **編輯**.
4. 啟用下方所述的設定，然後按一下 **儲存**.

| 設定          | 效果                                                               |
| ----------- | ---------------------------------------------------------------- |
| **建立使用者**   | 當應用程式指派給 Okta 中的使用者時，會在 Zoom 中建立或連結使用者。                          |
| **更新使用者屬性** | 當應用程式被指派時，會更新該使用者在 Zoom 中的屬性。之後對 Okta 使用者設定檔的變更會自動覆寫 Zoom 中對應的值。 |
| **停用使用者**   | 當應用程式在 Okta 中取消指派，或 Okta 帳戶被停用時，會停用 Zoom 帳戶。重新指派應用程式即可重新啟用帳戶。    |

{% hint style="danger" %}
**警告**

**更新使用者屬性** 可讓自訂屬性對應套用到現有使用者。若未啟用此設定，對應只會在建立使用者時套用，而 Okta 後續的任何變更都不會同步到 Zoom。
{% endhint %}

### 步驟 5：將值指派給使用者或群組

**若要將值指派給個別使用者：**

1. 前往 **目錄** → **人員** ，然後按一下使用者姓名。
2. 按一下 **個人資料** 索引標籤，然後按一下 **編輯**.
3. 以 Zoom 預期的值填入步驟 2 中建立的屬性。
4. 按一下 **儲存**.

該值會立即傳送。請先在 Zoom 網頁入口網站確認結果，再更廣泛套用相同變更。

**若要為群組指派值** — 更具可擴充性的模式，讓設定依循組織架構：

1. 確認步驟 1 中宣告的屬性，其 **屬性類型：群組**。如果宣告為 **個人**，請在 **Zoom 使用者** 的 **目錄** → **個人資料編輯器** → **使用者** → **全部**中，重複步驟 1，並選取 **群組** 作為屬性類型，以宣告對應的群組層級屬性。
2. 前往 **目錄** → **群組** → **全部** 索引標籤，然後按一下 **新增群組**.
3. 輸入 **名稱** 和選填的 **說明**，然後按一下 **儲存**.
4. 開啟群組，然後按一下 **應用程式** 索引標籤。
5. 按一下 **指派應用程式**，然後按一下 **指派** ，位於 **Zoom** 應用程式右側。
6. 以應適用於每位成員的值填入群組層級屬性。
7. 按一下 **儲存並返回**，然後按一下 **完成**.
8. 按一下群組的 **人員** 索引標籤，然後按一下 **指派人員**.
9. 可依名字、主要電子郵件地址或使用者名稱搜尋使用者，並按一下每個結果旁邊的新增按鈕。
10. 按一下 **完成**.

成員會自動繼承群組的屬性值。之後加入的使用者在加入時也會繼承，這使得此模式適合持續性的入職，而不只是一次性的移轉作業。

#### <mark style="color:藍色;">當使用者屬於多個群組時，群組優先順序會解決衝突值</mark>

當使用者屬於多個群組且這些群組為同一屬性提供值時，Okta 會傳送優先權最高的群組值。

1. 前往 **應用程式** → **應用程式** → **啟用中** → **Zoom** 應用程式。
2. 按一下 **作業** 索引標籤。
3. 在 **篩選器**下方，按一下 **群組**.
4. 將群組拖放到預期的順序。

{% hint style="info" %}
**建議**

請將群組從最具體到最一般排序，如此範圍較窄的群組 — 某個特定站點或角色 — 才會優先於廣泛的通用群組。若顛倒此順序，通用群組就會覆寫所有特定群組，通常會表現為整個族群都收到相同的非預期設定。
{% endhint %}

### 步驟 6：使用 Okta 系統記錄進行驗證

1. 前往 **報告** → **系統記錄**.
2. 依目標使用者或 Zoom 應用程式進行篩選，並將時間範圍縮小到該次佈建嘗試。
3. 開啟相關事件並檢視詳細資料，其中包含結果與下游應用程式傳回的任何錯誤。

未解決的佈建失敗也會顯示在 Zoom 應用程式的 **佈建** 索引標籤中。如果 Okta 記錄無法提供明確線索，請查看「 **Zoom 端驗證與常見錯誤**」一節所述的 Zoom App Marketplace 呼叫記錄，其中會顯示原始的請求與回應內容。

{% hint style="warning" %}
**注意：Okta 特有的靜默失敗**

在 Zoom 使用者設定檔中宣告、但未對應的屬性，或未在步驟 4 中啟用 **更新使用者屬性** 的屬性，不會傳送任何資料，但仍會顯示在對應清單中。系統不會產生錯誤。如果某個值未傳送至 Zoom，且系統記錄完全沒有對應事件，請先檢查對應和佈建設定，再進一步調查。
{% endhint %}

#### <mark style="color:藍色;">Okta 中的到職與離職行為</mark>

* 範圍是主要的安全控制。未在 Okta 中指派 Zoom 應用程式的使用者，不會被此設定中的任何對應修改。
* 啟用 **停用使用者** 後，取消指派應用程式或停用 Okta 帳戶時，會自動停用 Zoom 帳戶。
* 重新指派應用程式會重新啟用先前停用的 Zoom 帳戶，這使群組成員資格成為管理離職者與回任者的可行機制。

### 步驟 7：在 Okta 中套用參考情境

情境、先決條件和屬性定義請參閱 [**參考情境**](#reference-scenarios) 一節。此處僅說明 Okta 設定。

**情境 0 — 部門。** 在步驟 1，使用以下設定宣告屬性： **顯示名稱** 和 **變數名稱** `department`, **外部名稱** `department`和 **外部命名空間** `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`。使用 **屬性類型：個人**。Okta 的基本使用者設定檔已包含 `department` 屬性，因此可略過步驟 2，直接在步驟 3 從該屬性進行對應，並選取 **建立並更新**.

{% hint style="warning" %}
**注意：企業擴充屬性的命名空間格式**

步驟 1 中的警告說明了 Zoom 的慣例：將屬性名稱附加至外部命名空間。此指引適用於 Zoom 擴充功能下的屬性。 `department` 屬於標準 SCIM 企業擴充功能；在此情況下，Okta 通常會將命名空間和外部名稱分別放在不同欄位，如上所示。如果值未傳送至 Zoom，請嘗試附加屬性名稱的形式 — `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` — 並在 Marketplace 呼叫記錄中確認哪種形式成功。
{% endhint %}

**如果 `department` 已完成對應，可使用以下替代方案。** 以下各項的行為完全相同、位於相同的父項下，且沒有任何先決條件 — 只要在「 **外部名稱** 以及命名空間；如果 Okta 設定檔尚未包含對應的來源屬性，請在步驟 2 新增一個：

| 屬性               | 備註                                                            |
| ---------------- | ------------------------------------------------------------- |
| `costCenter`     | 商務欄位，因使用者之間會有所不同，所以錯誤值會很明顯                                    |
| `organization`   | 通常所有使用者都相同，因此較難發現錯誤                                           |
| `employeeNumber` | 通常已經對應為身分欄位——請在宣告前先檢查                                         |
| `pronouns`       | 隸屬於 **Zoom** 擴充功能，而非企業版擴充功能，因此會使用本指南其他所有情境相同的命名空間，也完全避開上述格式問題 |

**情境 1 — Zoom Phone 網站與自動分機。** 將 `zoomPhoneSite` 宣告為 **屬性類型：群組** 並在各網站的 Okta 群組上設定其值，讓群組成員資格直接決定網站，無須任何轉換邏輯。將 `zoomPhoneExtNumber` 宣告為個人屬性，並將預設值設為 `0` 除非您要遷移既有的分機設定。

**情境 2 — 依國家／地區而異的通話方案。** 將 `zoomPhoneCallingPlan` 宣告為 **屬性類型：群組** 並為各通話方案區域建立一個群組，在每個群組的 Zoom 應用程式指派中設定方案值。使用者透過群組成員資格繼承正確的方案，而儲存在 Okta 中的值也正是 Zoom 所需的值。此外，您也可以在 **指派** 索引標籤中查看並稽核設定，且即使底層目錄資料的填入方式不一致，設定仍能維持正確。帶有 `-1` 的群組可讓您在不刪除使用者的情況下，妥善移除其通話權限。

**情境 3 — Contact Center 套件、角色與區域。** 將 `zoomContactCenterPackage` 宣告為列舉屬性，並限定為三個允許的值，以確保無法輸入無效套件。將 `zoomContactCenterRole` 宣告為群組層級屬性，因為角色通常依據團隊架構而定。在單一區域部署中，請讓 `zoomContactCenterRegion` 維持未對應狀態。

## 疑難排解

### 錯誤

#### <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 只能套用身分提供者在佈建要求中提交的資訊。請使用這些記錄，確認身分提供者是否已提交使用者身分與授權屬性。如果這些聲明中缺少預期資訊，請聯絡身分提供者以取得支援。


---

# 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/scim-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.
