> 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/vi/goc-quan-tri-vien/account-and-endpoint-management/scim-guide.md).

# Cẩm nang SCIM cho Entra ID và Okta

Hướng dẫn tạo ánh xạ SCIM tùy chỉnh giữa Entra ID hoặc Okta và Zoom

## Tổng quan

API SCIM2 của Zoom cung cấp một danh mục lớn các thuộc tính người dùng kiểm soát việc cấp phép, quyền sử dụng sản phẩm, vai trò, khu vực và cấu hình theo dịch vụ. Các tích hợp cấp phát sẵn có cho cả Microsoft Entra ID và Okta chỉ ánh xạ một tập hợp nhỏ trong số này — đủ để tạo, cập nhật và hủy kích hoạt người dùng, nhưng không đủ để cấp phát các site Zoom Phone, các gói trung tâm liên hệ, vai trò Revenue Accelerator hoặc bất kỳ thuộc tính nào trong hàng chục thuộc tính khác mà Zoom hỗ trợ.

Hướng dẫn này trình bày phương pháp có thể lặp lại để thêm *bất kỳ* thuộc tính SCIM nào của Zoom vào cấu hình cấp phép của bạn. Thay vì chỉ mô tả riêng lẻ một thuộc tính, hướng dẫn giải thích mô hình nền tảng để quản trị viên có thể tra cứu thuộc tính trong tài liệu tham khảo API SCIM2 của Zoom và tự cấu hình thuộc tính đó mà không cần chờ bài viết dành riêng cho sản phẩm được xuất bản.

### Cách sử dụng hướng dẫn này

Trước tiên, hãy đọc phần Giới thiệu bắt đầu bằng [**Tìm hiểu về các thuộc tính SCIM**](#understanding-scim-attributes) cùng với các phần tiếp theo — điều kiện tiên quyết, dữ liệu thư mục, các tình huống tham khảo và xác minh ở phía Zoom. Những nội dung này áp dụng bất kể bạn sử dụng nhà cung cấp danh tính (IdP) nào. Sau đó, hãy xem phần Microsoft Entra ID hoặc Okta, tùy theo dịch vụ bạn dùng. Mỗi phần đều trình bày đầy đủ từ bước cấu hình đầu tiên đến xác minh và các ví dụ thực hành; bạn không cần chuyển qua lại giữa các phần.

Để tìm hiểu các khái niệm nền tảng về SSO và SCIM làm cơ sở cho hướng dẫn này, hãy tham khảo [Cẩm nang SSO](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), [bài viết về SSO và cấp phép Zoom cho Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121), và [bài viết về Đăng nhập một lần Zoom cho Okta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256).

{% hint style="danger" %}
**Cảnh báo**

Cấp phép được cấu hình sai ảnh hưởng đến người dùng hiện có, bao gồm cả việc xóa các giấy phép đã đang được sử dụng. Hãy xác thực mọi thay đổi với một người dùng thử nghiệm duy nhất trước khi áp dụng cho môi trường người dùng thực tế.
{% endhint %}

### **Điều kiện tiên quyết để sử dụng SCIM**

Mọi nội dung trong phần này đều áp dụng bất kể nhà cung cấp danh tính. Hãy đọc phần này trước khi chuyển sang các hướng dẫn cụ thể cho nhà cung cấp danh tính của bạn.

#### Các yêu cầu chung cho cả hai nhà cung cấp danh tính

* tài khoản Zoom Kinh doanh, Giáo dục hoặc Doanh nghiệp lớn có [URL tùy biến](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061540)
* quyền của chủ sở hữu tài khoản Tài khoản Zoom hoặc quản trị viên
* [Đăng nhập một lần](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) được bật trên tài khoản Zoom
* Một [miền liên kết đã xác minh](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) trên tài khoản Zoom, khớp với miền email của người dùng được cấp quyền
* Việc cấp phát SCIM đã được thiết lập giữa nhà cung cấp danh tính và Zoom
* Giấy phép Zoom, gói, tiện ích mở rộng hoặc đối tượng cấu hình đang được gán phải đã tồn tại và có sẵn trên Tài khoản Zoom

Các yêu cầu cụ thể theo từng nhà cung cấp danh tính được liệt kê ở đầu mỗi phần tương ứng.

#### Các hạn chế chung cho cả hai nhà cung cấp danh tính

* SCIM chỉ gán các quyền hiện có; không thể tạo các đối tượng mà SCIM tham chiếu. Xem phần [**Trước khi thử ánh xạ nâng cao, các đối tượng phía Zoom phải tồn tại thì SCIM mới có thể tham chiếu đến chúng.**](#before-attempting-advanced-mapping-zoom-side-objects-must-exist-before-scim-can-reference-them) bên dưới.
* Một số thuộc tính chỉ chấp nhận một giá trị cho mỗi người dùng. Một gói cuộc gọi Zoom Phone là một ví dụ — các gói tiện ích mở rộng như Customer Engagement Pack không thể được cấp phát thông qua SCIM.
* Các `userType` thuộc tính này được Zoom ghi nhận là dự kiến sẽ bị loại bỏ.

## **Giới thiệu**

### **Hiểu các thuộc tính SCIM**

Những quản trị viên hiểu cách một thuộc tính Zoom SCIM được cấu thành có thể Cấu hình bất kỳ thuộc tính nào mà Zoom hỗ trợ. Những quản trị viên làm theo một công thức chỉ có thể Cấu hình thuộc tính mà công thức đó mô tả. Phần này đề cập đến cách cấu thành. Việc ánh xạ một thuộc tính với một nguồn dữ liệu sẽ diễn ra sau, trong các phần về nhà cung cấp danh tính.

#### <mark style="color:xanh dương;">Mỗi thuộc tính đều có một không gian tên, một tên, một kiểu dữ liệu và một giá trị được phép</mark>

Hãy bắt đầu với một ví dụ đầy đủ, hoạt động được. Đây là mã nhận diện để gán một người dùng vào một cơ sở Zoom Phone:

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

Có bốn thuộc tính của đặc tính này đang được sử dụng. Hai thuộc tính hiển thị ở dòng phía trên. Hai thuộc tính còn lại lấy từ tài liệu tham khảo API và sẽ được nhập ở nơi khác trong nhà cung cấp danh tính của bạn sau này. Trước mắt, chúng ta tập trung vào hai thuộc tính: **Không gian tên** và **Tên**.

<table><thead><tr><th width="155.290771484375">Thuộc tính</th><th>Trích xuất từ ví dụ</th><th>Nó làm gì</th></tr></thead><tbody><tr><td><strong>Không gian tên</strong></td><td><code>urn:ietf:params:scim:schemas:extension:zoom:1.0:User</code></td><td>Cho Zoom biết lược đồ mà cài đặt này thuộc về, và đóng vai trò là cơ sở chung cho hầu như mọi thuộc tính sản phẩm và cấp phép của Zoom. Được truyền đến Zoom như nửa đầu của mã nhận diện.</td></tr><tr><td><strong>Tên</strong></td><td><code>zoomPhoneSite</code></td><td>Xác định cài đặt cụ thể của Zoom đang được ghi — ở đây là cơ sở Zoom Phone của người dùng. Được truyền đến Zoom như nửa sau của mã nhận diện. Phân biệt chữ hoa chữ thường.</td></tr><tr><td><strong>Kiểu dữ liệu</strong></td><td><code>string</code></td><td>Cho nhà cung cấp danh tính biết loại giá trị mà thuộc tính chứa để giá trị được lưu trữ và định dạng chính xác. Không được truyền như một phần của mã nhận diện; được khai báo riêng dưới tên <strong>Loại</strong> trong Entra ID hoặc <strong>Kiểu dữ liệu</strong> trong Okta.</td></tr><tr><td><strong>Giá trị được phép</strong></td><td><code>LON-01</code>, tên cơ sở Zoom Phone</td><td>Cài đặt thực sự được áp dụng cho người dùng. Văn bản tự do đối với một số thuộc tính, tập giá trị cố định đối với các thuộc tính khác — <code>Essentials</code>, <code>Premium</code>, hoặc <code>Cao cấp</code> ví dụ: đối với trung tâm liên hệ Zoom. Được truyền tới Zoom tại thời điểm cấp phát, do phép ánh xạ cung cấp thay vì mã nhận diện.</td></tr></tbody></table>

{% hint style="danger" %}
**Cảnh báo**

Zoom xuất bản nhiều không gian tên tiện ích mở rộng dành cho người dùng. Cấu hình sản phẩm và các thuộc tính cấp phép sử dụng `urn:ietf:params:scim:schemas:extension:zoom:1.0:User`, đây là không gian tên được sử dụng xuyên suốt hướng dẫn này. Các trường tiêu chuẩn dành cho Doanh nghiệp lớn như `department`, `manager`, và `costCenter` sử dụng `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`。 Một phần ba, `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`, chứa thông tin về loại đăng nhập được trả về trong các phản hồi API thay vì được cấu hình trong quá trình cấp phát. Một thuộc tính được tạo dựa trên không gian tên không phù hợp sẽ được nhà cung cấp danh tính của bạn chấp nhận nhưng Zoom sẽ âm thầm bỏ qua.
{% endhint %}

#### <mark style="color:xanh dương;">Xác định thuộc tính bạn cần trong tài liệu tham khảo API SCIM2</mark>

Các [Tài liệu tham khảo API SCIM2](https://developers.zoom.us/docs/api/scim2/#tag/user/post/scim2/Users) là danh sách chính thức về mọi thứ Zoom chấp nhận trong quá trình cấp quyền. Có hai thao tác cần lưu ý: **Tạo người dùng** và **Cập nhật người dùng**.

Chủ yếu tham khảo **Cập nhật người dùng**. Mỗi người chỉ được tạo một lần, nhưng các thuộc tính thay đổi liên tục — chuyển văn phòng, đổi gói dịch vụ, thay đổi vai trò, nghỉ việc — vì vậy phần lớn hoạt động cấp quyền thực tế theo thời gian là cập nhật. **Cập nhật người dùng** cũng ghi lại các giá trị dùng để xóa mà **Tạo người dùng** không có lý do gì để đưa vào, chẳng hạn như đặt `zoomPhoneCallingPlan` đến `-1` để xóa tất cả gói gọi khỏi người dùng.

Để tìm một thuộc tính:

* Mở tài liệu tham khảo API SCIM2 và truy cập **Cập nhật người dùng**.
* Trong phần thân yêu cầu, hãy tìm `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` đối tượng. Mọi thuộc tính được đề cập trong hướng dẫn này đều được liệt kê bên trong đối tượng đó.
* Tìm thuộc tính theo tên và ghi lại **kiểu dữ liệu** và của nó **các giá trị được phép**.
* Hãy đọc phần mô tả đi kèm. Mô tả nêu những hành vi không thể suy ra từ tên thuộc tính — `zoomPhoneExtNumber` được đặt thành `0` sẽ kích hoạt việc tự động gán số máy lẻ, `zoomPhoneCallingPlan` được đặt thành `-1` sẽ xóa tất cả gói gọi điện, và `zoomPhoneNumber` phải tham chiếu đến một số hiện chưa được gán trong Tài khoản Zoom.

#### <mark style="color:xanh dương;">Đang ghép mã nhận diện: cha, dấu hai chấm, con</mark>

Mọi thứ được liệt kê bên trong mục đó `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` đối tượng là một **con** của nó. Bản thân đối tượng chính là **phần tử cha**. Tạo mã nhận diện nghĩa là đặt tên cho phần tử cha, thêm dấu hai chấm, rồi thêm phần tử con:

```
Cha       urn:ietf:params:scim:schemas:extension:zoom:1.0:người dùng
Dấu hai chấm        :
Trẻ em        zoomPhoneSite

Mã nhận diện   urn:ietf:params:scim:schemas:extension:zoom:1.0:người dùng:zoomPhoneSite
```

Đó là toàn bộ cấu trúc. Không có bảng tra cứu nào để yêu cầu từ Zoom và không có gì để tạo — mã nhận diện là hai thứ bạn đã có, được nối bằng dấu hai chấm.

#### <mark style="color:xanh dương;">Mục cha vẫn giữ nguyên; chỉ mục con thay đổi</mark>

Vì phần tử cha đã cố định, việc cấu hình thuộc tính thứ hai, thứ năm hoặc thứ mười lăm là cùng một thao tác với một phần tử con khác được thêm vào sau:

```
Cơ sở (cha)              urn:ietf:params:scim:schemas:extension:zoom:1.0:người dùng

Zoom Phone cơ sở            urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite
Số Zoom Phone          urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneNumber
Số máy lẻ Zoom Phone       urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneExtNumber
Zoom Phone gói cuộc gọi    urn:ietf:params:scim:schemas:extension:zoom:1.0:người dùng:zoomPhoneCallingPlan
```

Phần cha mẹ giống nhau chứa mọi sản phẩm Zoom khác. Không có gì Giới thiệu về cấu trúc thay đổi khi sản phẩm thay đổi:

```
Gói trung tâm liên hệ     urn:ietf:params:scim:schemas:extension:zoom:1.0:người dùng:zoomContactCenterPackage
Vai trò Bộ tăng tốc doanh thu   urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole
Gói Workplace           urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomWorkplace
Zoom Docs                  urn:ietf:params:scim:schemas:extension:zoom:1.0:người dùng:zoomDocs
```

Vì vậy, bạn chỉ cần học phần tử cha một lần. Từ đó trở đi, khi cấu hình một thuộc tính mới, bạn chỉ cần tra cứu ba thứ trong tài liệu tham chiếu API: tên phần tử con, kiểu dữ liệu của nó, và các giá trị được phép của nó.

Nếu bạn có thể ghép nối một mục cha và một mục con, phần khó nhất của cấu hình này đã ở phía sau bạn. Phần còn lại là cho nhà cung cấp danh tính của bạn biết mỗi giá trị nên đến từ đâu — được trình bày trong các phần Entra ID và Okta tiếp theo — và quyết định những thuộc tính nào cần xử lý trước, sẽ được đề cập Tiếp.

#### <mark style="color:xanh dương;">Hai loại ánh xạ: Cơ bản và nâng cao</mark>

Không phải thuộc tính nào cũng mang cùng một mức rủi ro, và đáng để phân loại chúng trước khi cấu hình bất kỳ thứ gì.

Hướng dẫn này sử dụng các thuật ngữ **Cơ bản** và **nâng cao** từ  [Hướng dẫn thực địa về SSO](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), tài liệu cũng đưa ra sự phân biệt tương tự đối với ánh xạ phản hồi Ngôn ngữ đánh dấu bảo đảm an toàn. Các thuật ngữ này mô tả  **cách Zoom xử lý giá trị khi nhận được**, chứ không phải mức độ khó khi Cấu hình thuộc tính. Về cơ chế, hai loại này giống hệt nhau: cả hai đều được ghi trong cùng một phần thân yêu cầu  **Cập nhật người dùng** , đều được tạo bằng cùng một cấu trúc cha-dấu hai chấm-con, và đều được khai báo và ánh xạ qua cùng các bước trong Entra ID và Okta.

* **Ánh xạ Cơ bản**  ghi văn bản vào hồ sơ của người dùng. Zoom lưu giá trị đúng như được gửi và không bao giờ đối chiếu giá trị đó với bất cứ thứ gì.
* **Ánh xạ nâng cao** đưa ra yêu cầu đối với tài khoản. Zoom lấy giá trị đó và tìm đối tượng khớp hoặc một chỗ trống trong gói đã mua — và việc tra cứu đó có thể thất bại.

<table><thead><tr><th width="199.435791015625"></th><th>Ánh xạ Cơ bản</th><th>Ánh xạ nâng cao</th></tr></thead><tbody><tr><td><strong>Giá trị là gì</strong></td><td>Văn bản được lưu trên hồ sơ của người dùng</td><td>Một con trỏ tới một đối tượng trong Zoom, hoặc quyền đối với một chỗ ngồi đã mua</td></tr><tr><td><strong>Ví dụ</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>Cha</strong></td><td>Cấp cao nhất, hoặc phần mở rộng của Doanh nghiệp lớn</td><td>Phần mở rộng của Zoom</td></tr><tr><td><strong>Điều kiện tiên quyết trong Zoom</strong></td><td>Không có</td><td>Đối tượng phải tồn tại, hoặc chỗ ngồi phải trống</td></tr><tr><td><strong>Nếu giá trị không đúng</strong></td><td>Văn bản không chính xác xuất hiện trên một hồ sơ</td><td>Thuộc tính bị từ chối, hoặc bị bỏ qua một cách âm thầm</td></tr></tbody></table>

Sự khác biệt này chi phối hai quyết định thực tế. Nó quyết định **những gì bạn phải thiết lập trước trong Zoom** — không cần thiết lập gì cho ánh xạ cơ bản, nhưng có thể cần khá nhiều cho ánh xạ nâng cao — đồng thời cũng quyết định **cái giá phải trả cho một sai lầm**. Sai phòng ban chỉ là lỗi hình thức trên hồ sơ. Tên cơ sở sai hoặc không có chỗ giấy phép sẽ khiến người dùng không thể sử dụng điện thoại hoặc sản phẩm mà họ được tuyển dụng để dùng; trong môi trường đang hoạt động, điều này có thể khiến một người mất quyền sử dụng mà họ vốn đã có.

Sự khác biệt về hệ quả đó là lý do hai thứ này được xử lý riêng bên dưới.

#### <mark style="color:xanh dương;">Ánh xạ Cơ bản: thông tin hồ sơ</mark>

Ánh xạ Cơ bản điền các trường mô tả trên hồ sơ Zoom của người dùng. Zoom lưu từng giá trị đúng như được gửi và không bao giờ xác thực nó đối chiếu với một đối tượng hiện có, vì vậy không có gì cần dựng sẵn trong Zoom trước đó và cũng không có gì sẽ hỏng nếu một giá trị sai.

**Các trường nhận dạng cốt lõi thường đã được ánh xạ sẵn.** `Tên người dùng`, `name.givenName`, `name.familyName`, `displayName` và `emails` nằm ở cấp cao nhất của phần thân yêu cầu, hoàn toàn không có phần tử cha, và cả hai tích hợp Entra ID lẫn Okta đều ánh xạ chúng ngay từ đầu. Hãy xác minh chúng thay vì tạo lại. `title`, `phoneNumbers` và `locale` cũng ở cấp cao nhất, nhưng có thể cần bổ sung.

**Các trường Doanh nghiệp lớn sử dụng một cấp cha thứ hai.** Cách xây dựng không thay đổi — chỉ có cấp cha thay đổi:

```
Cơ sở (cha)         urn:ietf:params:scim:schemas:extension:Doanh nghiệp lớn:2.0:người dùng

Phòng ban            urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department
Trung tâm chi phí           urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter
Số nhân viên       urn:ietf:params:scim:schemas:extension:Doanh nghiệp lớn:2.0:người dùng:employeeNumber
Tổ chức          urn:ietf:params:scim:schemas:extension:Doanh nghiệp lớn:2.0:người dùng:Tổ chức
Quản lý               urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager
```

Việc điền Bộ phận và Trung tâm chi phí thông qua SCIM không còn yêu cầu ánh xạ Ngôn ngữ đánh dấu bảo đảm an toàn.

{% hint style="info" %}
**Khuyến nghị**

Trước tiên, hãy ánh xạ một thuộc tính cơ bản — `department` là một lựa chọn phù hợp và được trình bày chi tiết trong **Tình huống 0** trong các kịch bản tham chiếu — và chạy quy trình từ đầu đến cuối cho một người dùng thử nghiệm trước khi cấu hình bất kỳ thứ gì trong tiện ích mở rộng Zoom. Một `department` giá trị hiển thị chính xác trên hồ sơ Zoom chứng minh rằng bạn đã khai báo lược đồ, thiết lập ánh xạ, phạm vi và khả năng đọc nhật ký cấp phát. Mỗi thuộc tính nâng cao tiếp theo chỉ khác ở đối tượng mà thuộc tính trỏ đến, chứ không khác cách cấu hình.
{% endhint %}

#### <mark style="color:xanh dương;">Ánh xạ nâng cao: cấu hình sản phẩm và quyền lợi</mark>

Ánh xạ nâng cao gán những gì một người dùng có thể làm: một cơ sở và gói cuộc gọi Zoom Phone, một Vai trò và Gói của trung tâm liên hệ, một gói Workplace, một phân đoạn Revenue Accelerator. Các thuộc tính này nằm dưới phần tử cha của phần mở rộng Zoom được dùng xuyên suốt hướng dẫn này.

Điểm khác biệt quan trọng là các giá trị này không được lưu trữ — chúng được **phân giải**. Zoom nhận giá trị bạn gửi rồi tìm đối tượng khớp hoặc một vị trí còn trống. Trong khi ánh xạ cơ bản ghi văn bản vào hồ sơ, ánh xạ nâng cao đưa ra yêu cầu đối với cấu hình và tài nguyên của tài khoản, và yêu cầu đó có thể thất bại.

Đây là lý do hướng dẫn này dành hẳn một phần cho các điều kiện tiên quyết. Mọi thuộc tính nâng cao đều phụ thuộc vào việc một thứ gì đó đã được tạo hoặc mua trước đó trong Cổng thông tin web của Zoom, và các kiểu lỗi này kém khoan dung hơn nhiều so với một chức danh bị viết sai.

#### <mark style="color:xanh dương;">Ba lớp chung cho mọi cấu hình</mark>

Bất kể thuộc tính nào hay nhà cung cấp danh tính nào, công việc vẫn là ba lớp giống nhau. Chỉ có Vị trí của mỗi điều khiển là khác nhau.

<table><thead><tr><th width="114.4166259765625">Lớp</th><th>Mục đích</th><th>Microsoft Entra ID</th><th>Okta</th></tr></thead><tbody><tr><td><strong>1. Khai báo</strong></td><td>Cho nhà cung cấp danh tính biết rằng thuộc tính tồn tại trong ứng dụng Zoom để nó trở thành mục tiêu ánh xạ khả dụng.</td><td>Bước 1</td><td>Bước 1</td></tr><tr><td><strong>2. Ánh xạ</strong></td><td>Xác định giá trị đến từ đâu.</td><td>Bước 2</td><td>Bước 2–3</td></tr><tr><td><strong>3. Phạm vi</strong></td><td>Xác định những người dùng nào cấu hình áp dụng cho và khi nào nó chạy.</td><td>Các bước 3–5</td><td>Các bước 4–5</td></tr></tbody></table>

Một khi mô hình này được hiểu, việc thêm thuộc tính thứ năm hoặc thứ mười lăm chỉ là lặp lại cùng ba lớp đó, chứ không phải một dự án mới.

#### <mark style="color:xanh dương;">Entra và Okta khác nhau ở nơi một giá trị có thể bắt nguồn</mark>

Đây là khác biệt kiến trúc có tính quyết định lớn nhất giữa hai cách, và nó giải thích vì sao cùng một yêu cầu Kinh doanh lại tạo ra các cấu hình khác nhau giữa Entra và Okta.

* **Entra ID chỉ lấy giá trị từ các thuộc tính của đối tượng người dùng.** Giá trị phải lấy từ một trường trên người dùng — trường thư mục hiện có hoặc thuộc tính mở rộng được xây dựng theo mục đích. Khi giá trị trong thư mục và giá trị Zoom không phải cùng một chuỗi, cần có biểu thức để chuyển đổi giữa chúng.
* **Okta có thể lấy giá trị từ hồ sơ người dùng hoặc từ việc gán nhóm.** Khai báo một thuộc tính với **Loại thuộc tính: Nhóm** cho phép đặt giá trị một lần cho một nhóm và áp dụng giá trị đó cho mọi Thành viên trong nhóm. Khi cấu hình tuân theo cơ cấu tổ chức, cách này loại bỏ hoàn toàn nhu cầu về logic dịch.

Không có cách nào tốt hơn một cách tuyệt đối, nhưng chúng dẫn đến các cấu hình khác nhau.

### **Yêu cầu Cấu hình trước phía Zoom**

#### <mark style="color:xanh dương;">Trước khi thử ánh xạ nâng cao, các đối tượng phía Zoom phải tồn tại để SCIM có thể tham chiếu đến chúng</mark>

SCIM là cơ chế gán, không phải cơ chế tạo — nó liên kết người dùng với cấu hình đã có trên Tài khoản Zoom, và nó **không thể** tạo cấu hình đó thay cho người dùng.

Phần lớn các thuộc tính ánh xạ nâng cao là **tham chiếu**: giá trị bạn gửi phải tương ứng với một đối tượng đã tồn tại trong Zoom — cơ sở, Vai trò, mẫu, gói đã mua, một số điện thoại cụ thể hoặc số máy nhánh. Tất cả đều tuân theo một quy tắc:

> Nếu một thuộc tính gọi tên một thứ gì đó, thứ đó phải đã tồn tại, phải được viết đúng y như đã gửi, và — khi nó lấy từ một nguồn hữu hạn — phải còn dung lượng chưa dùng.

Khi một đối tượng được tham chiếu không tồn tại, SCIM không tạo nó cũng không xếp yêu cầu vào hàng đợi. Thuộc tính hoặc thất bại ngay lập tức, với lỗi được trả về trong nhật ký cấp phát, hoặc bị loại bỏ âm thầm — Zoom chấp nhận tải trọng, không áp dụng gì và báo thành công.

Các phần dưới đây tách các điều kiện tiên quyết theo từng sản phẩm, kèm đường dẫn điều hướng và bài Hỗ trợ để thiết lập từng phần. Hãy đọc các ghi chú ở cấp tài khoản, rồi đến phần dành cho từng sản phẩm bạn dự định cấp phát.

#### <mark style="color:xanh dương;">Các điều kiện tiên quyết ở cấp tài khoản áp dụng trước khi bất kỳ sản phẩm nào được cấp phát</mark>

Các yêu cầu về tài khoản được liệt kê ở đầu hướng dẫn này — URL tùy biến, SSO, quyền ủy quyền SCIM và miền được liên kết đã xác minh — là điều kiện tiên quyết cho mọi thuộc tính tiếp theo. Cấu hình bảo mật và SSO trong [**Trung tâm quản trị**](https://zoom.com/account) → [**Bảo mật và độ tin cậy**](https://zoom.com/account/setting/security), và quản lý các miền được liên kết trong [**Trung tâm quản trị**](https://zoom.com/account) → **Tài khoản** → [**Hồ sơ tài khoản**](https://zoom.com/account); xem [Cấu hình SSO/SCIM Zoom + Microsoft Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121).

Hai điểm nữa đáng được nêu rõ:

* **Mua một chỗ không đồng nghĩa với việc gán chỗ đó.** SCIM thực hiện việc gán, nhưng chỗ đó phải có sẵn trước. Xem [Gán hoặc xóa giấy phép Zoom của người dùng](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911).
* **Chỗ phải thuộc đúng gói được yêu cầu.** Việc gửi thuộc tính giấy phép khi gói cụ thể đó không còn chỗ trống sẽ không thành công, ngay cả khi một gói khác trong tài khoản còn dung lượng.

#### <mark style="color:xanh dương;">Zoom Phone</mark>

Zoom Phone có bộ thuộc tính tham chiếu lớn nhất vì một người dùng điện thoại được ghép từ nhiều phần hạ tầng đã mua trước hoặc đã được xây sẵn.

| Thuộc tính                                                                          | Những gì phải tồn tại sẵn                                                                                                                                                            | Cách tạo nó                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Chính giấy phép Zoom Phone                                                          | Một suất Zoom Phone đang có sẵn — quyền lợi tiên quyết trước khi bất cứ thứ gì bên dưới có thể được gắn vào.                                                                         | Mua trước. Xem [Mua và gán giấy phép Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929).                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `zoomPhoneSite`                                                                     | Cơ sở, được đặt tên đúng y như giá trị được gửi. Bỏ qua thuộc tính sẽ gán cơ sở chính của tài khoản, cơ sở này tồn tại mặc định khi Nhiều địa điểm được bật.                       | [Trung tâm quản trị](https://zoom.com/account) → Cấu hình sản phẩm → Hệ thống điện thoại → [Thông tin công ty](https://zoom.com/pbx/page/telephone/settings#/settings) → **Thêm cơ sở**, hoặc **Nhập** để tạo hàng loạt. Xem [Quản lý nhiều địa điểm](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716).                                                                                                                                                                                                                                           |
| `zoomPhoneNumber`                                                                   | Số đó, đã được mua hoặc Chuyển mạng giữ số vào tài khoản và hiện chưa được gán. Một số đã thuộc về người dùng khác, hàng đợi cuộc gọi hoặc tổng đài tự động không thể được dùng lại. | [Trung tâm quản trị](https://zoom.com/account) → Cấu hình sản phẩm → Số điện thoại → [Số điện thoại](https://zoom.com/cpw/page/phoneNumbers#/number-list). Mua hoặc chuyển mạng giữ số tại đây, và để số đích chưa được gán để SCIM có thể nhận số đó. Xem [Sử dụng Quản lý số để quản lý số điện thoại](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0074457) và [Quản lý số điện thoại](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060212).                                                                                 |
| `zoomPhoneExtNumber` (chỉ áp dụng cho các giá trị cụ thể)                           | Số máy nhánh gồm 3–6 chữ số, chưa được sử dụng. Không bắt buộc khi gửi `0`, thao tác này sẽ giao việc gán cho Zoom.                                                                  | [Trung tâm quản trị](https://zoom.com/account) → Cấu hình sản phẩm → Hệ thống điện thoại → [Người dùng và phòng](https://zoom.com/pbx/page/telephone/phoneUsers#/users) → Chọn đối tượng giữ số máy nhánh → **Hồ sơ** → **Số máy lẻ** → **Chỉnh sửa**. Xem [Thay đổi cài đặt của người dùng điện thoại](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069338).                                                                                                                                                                                         |
| `zoomPhoneCallingPlan`                                                              | gói cuộc gọi, đã mua và còn dung lượng khả dụng, được tham chiếu bằng mã gói chính xác của nó.                                                                                       | Mua trước. Xem [Mua và chỉ định giấy phép Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929) và [Quản lý người dùng điện thoại](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069309). Mã gói được liệt kê trong [Tài liệu tham khảo về gói cuộc gọi Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/), hoặc được trả về dưới dạng `type` bởi [Liệt kê các gói cuộc gọi](https://developers.zoom.us/docs/api/references/phone-calling-plans/) API cùng với số lượng chỗ còn trống. |
| `zoomPhoneCallingPlanSubscription` (chỉ áp dụng cho tài khoản có nhiều gói đăng ký) | Gói đăng ký cụ thể mà gói này sẽ sử dụng, khi tài khoản có nhiều hơn một gói đăng ký cho cùng một gói.                                                                               | Gói và Thanh toán → quản lý gói đăng ký.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

**Nhóm tiện ích mở rộng được dùng chung giữa các loại đối tượng, không chỉ người dùng.** Hàng đợi cuộc gọi, lễ tân tự động, nhóm đường dây được chia sẻ và điện thoại khu vực chung đều sử dụng tiện ích mở rộng trong cùng một dải. Đây là nguyên nhân phổ biến nhất gây ra lỗi “tiện ích mở rộng đã được sử dụng”, vì tiện ích mở rộng có vẻ còn trống khi quản trị viên chỉ kiểm tra danh sách người dùng.

**Không thể gán số được Chuyển mạng giữ số cho đến khi quá trình Chuyển mạng giữ số hoàn tất.** Số đó phải vừa được trình bày trong tài khoản vừa chưa được gán; việc bắt đầu Chuyển mạng giữ số không đáp ứng điều kiện nào trong hai điều kiện này.

**Cơ sở là trở ngại phổ biến nhất** vì việc tạo cơ sở có những yêu cầu riêng. Địa chỉ cơ sở được xác thực dựa trên cơ sở dữ liệu địa chỉ thực tế vì chúng là nền tảng cho dịch vụ cuộc gọi khẩn cấp — các tổ hợp địa chỉ và mã bưu chính tự tạo sẽ bị từ chối kèm theo lỗi xác thực. Khi nhập hàng loạt cơ sở, cột tổng đài tự động yêu cầu giá trị `Yes` thay vì nội dung nhãn hiển thị trong giao diện. Tên của ID người gọi chủ yếu áp dụng cho Hoa Kỳ và Canada và có thể để trống nếu gây ra lỗi xác thực.

#### <mark style="color:xanh dương;">Zoom trung tâm liên hệ</mark>

Việc cấp phép Trung tâm liên hệ được điều khiển theo Vai trò và mẫu. Các thuộc tính riêng lẻ phải phân giải thành các đối tượng Trung tâm liên hệ hiện có, và mẫu chứa Cài đặt không có thuộc tính SCIM chuyên biệt riêng.

| Thuộc tính                      | Những gì phải tồn tại sẵn                                                                                                                               | Cách tạo nó                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomContactCenterPackage`      | Gói — `Essentials`, `Premium`, hoặc `Elite` — đã mua và còn chỗ chưa sử dụng.                                                                           | Mua trước; đối với Premium, có thể cần liên hệ với Hỗ trợ Zoom để mua thêm gói trước. Xem [Thay đổi Cài đặt người dùng trung tâm liên hệ Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874).                                                                                                                                                                   |
| `zoomContactCenterAddonsPlan`   | Gói tiện ích mở rộng, đã mua và có dung lượng.                                                                                                          | mua trước; gói tài khoản và thông tin thanh toán.                                                                                                                                                                                                                                                                                                                                               |
| `zoomContactCenterRole`         | Vai trò, Tiêu chuẩn hoặc tùy chỉnh, được đặt tên chính xác. Nếu bỏ qua, hệ thống sẽ Chỉ định Vai trò Nhân viên mặc định, vốn tồn tại theo mặc định. | [Trung tâm quản trị viên](https://zoom.com/account) → Quản lý CX → Trung tâm liên hệ → [Vai trò](https://zoom.com/cci/index/admin#/admin-next/admin-roles) → **Thêm** → Cấu hình quyền → **Lưu**. Xem [Quản lý vai trò trong trung tâm liên hệ Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941).                                                               |
| `zoomContactCenterRegion`       | Khu vực. Nếu bỏ qua, hệ thống sẽ Chỉ định khu vực chính của tài khoản, khu vực này phải được Cấu hình.                                                  | [Trung tâm quản trị](https://zoom.com/account) → Quản lý CX → Trung tâm liên hệ → [Tùy chọn](https://zoom.com/cci/index/admin#/admin-preferences) → Khu vực → **Thêm khu vực** → Đi vào tên và Chọn một vùng SIP → **Thêm**. Xem [Quản lý các khu vực của trung tâm liên hệ Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668).                                  |
| `zoomContactCenterUserTemplate` | Mẫu người dùng, được đặt tên chính xác. Mẫu loại Thêm áp dụng khi tạo người dùng; mẫu loại Cập nhật áp dụng khi cập nhật.                               | [Trung tâm quản trị](https://zoom.com/account) → Quản lý CX → Trung tâm liên hệ → Người dùng → [Mẫu](https://zoom.com/cci/index/admin#/admin-agents#templates) → **Thêm mẫu** → Chọn **Thêm** → Cấu hình vai trò, gói, hàng đợi và kỹ năng → **Thêm**. Xem [Quản lý mẫu Cài đặt người dùng trung tâm liên hệ Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). |

{% hint style="danger" %}
**Cảnh báo**

Tính năng khu vực của Trung tâm liên hệ phải được Hỗ trợ Zoom bật trước khi có thể tạo khu vực, và mỗi người dùng chỉ thuộc đúng một khu vực. Vì đây là yêu cầu Hỗ trợ thay vì Bật/tắt tự phục vụ, hãy gửi yêu cầu sớm nếu dự kiến triển khai đa khu vực.
{% endhint %}

**Hộp thư đến, hàng đợi và kỹ năng không có thuộc tính SCIM.** Để cấp phát chúng, hãy tạo sẵn trong [Trung tâm quản trị](https://zoom.com/account) → Quản lý CX → Trung tâm liên hệ, gắn chúng vào một mẫu người dùng và Chỉ định mẫu đó thông qua `zoomContactCenterUserTemplate`. Do đó, chúng trở thành các điều kiện tiên quyết của *mẫu* thay vì của từng người dùng. Nhờ đó, mẫu cũng trở thành đối tượng duy nhất cần duy trì khi các yêu cầu này Thay đổi.

<table><thead><tr><th width="123.2821044921875">Đối tượng</th><th>Cách tạo nó</th></tr></thead><tbody><tr><td>Hàng đợi</td><td><a href="https://zoom.com/account">Trung tâm quản trị</a> → Quản lý CX → Trung tâm liên hệ → <a href="https://zoom.com/cci/index/admin#/admin-queues">Hàng đợi</a> → <strong>Thêm hàng đợi</strong> → tên, kênh, nhân viên → <strong>Lưu</strong>. Xem <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0061959">Quản lý hàng đợi của trung tâm liên hệ Zoom</a>.</td></tr><tr><td>Kỹ năng</td><td><a href="https://zoom.com/account">Trung tâm quản trị</a> → Quản lý CX → Trung tâm liên hệ → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-skills">Kỹ năng</a> → Chọn một danh mục → <strong>Thêm kỹ năng</strong> → tên → <strong>Thêm</strong>. Xem <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059519">Quản lý kỹ năng và danh mục kỹ năng</a>.</td></tr><tr><td>Hộp thư đến</td><td><a href="https://zoom.com/account">Trung tâm quản trị</a> → Quản lý CX → Trung tâm liên hệ → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-inbox">Hộp thư đến</a> → <strong>Thêm hộp thư đến</strong>. Xem <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059471">Quản lý hộp thư đến của trung tâm liên hệ Zoom</a>.</td></tr></tbody></table>

**Khi cả mẫu và các thuộc tính riêng lẻ đều được cung cấp, các giá trị riêng lẻ được ưu tiên.** Việc gửi một mẫu cùng với `zoomContactCenterRole` có nghĩa là thuộc tính Vai trò ghi đè thiết lập Vai trò của mẫu, vì vậy cả Vai trò được tham chiếu và mẫu đều phải tồn tại.

#### <mark style="color:xanh dương;">Zoom Revenue Accelerator</mark>

| Thuộc tính                                                           | Những gì phải tồn tại sẵn                                                                 | Cách tạo nó                                                                                                                                                                                                                                                                                                                                                          |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomRevenueAcceleratorPlan` và `zoomRevenueAcceleratorSubscription` | Gói hoặc gói đăng ký ZRA đã mua với một chỗ ngồi Đang rảnh.                               | mua trước; gói tài khoản và thông tin thanh toán.                                                                                                                                                                                                                                                                                                                    |
| `zoomRevenueAcceleratorRole`                                         | Vai trò, Tiêu chuẩn hoặc tùy chỉnh — ví dụ `Bán hàng Manager` — có tên chính xác như vậy. | [Trung tâm quản trị](https://zoom.com/account) → Người dùng → [Vai trò](https://zoom.com/role#/) → **Revenue Accelerator** thẻ → **+ Thêm vai trò** → tên và mô tả → **Thêm** → Cấu hình quyền → **Lưu thay đổi**. Xem [Sử dụng tính năng quản lý vai trò của Zoom Revenue Accelerator](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). |
| `zoomRevenueAcceleratorSegment`                                      | Phân đoạn mà người dùng thuộc về.                                                         | Cài đặt quản trị viên của Revenue Accelerator.                                                                                                                                                                                                                                                                                                                       |
| `zoomRevenueAcceleratorRegion`                                       | Khu vực — ví dụ: `US`.                                                                    | Cài đặt quản trị viên của Revenue Accelerator.                                                                                                                                                                                                                                                                                                                       |

#### <mark style="color:xanh dương;">Giấy phép Zoom Workplace và vai trò tài khoản</mark>

Ngoài ba sản phẩm ở trên, bản ghi người dùng tiêu chuẩn chứa các tham chiếu vai trò và giấy phép tuân theo cùng một quy tắc.

| Thuộc tính                                                                                                                                                                                                                                                                             | Những gì phải tồn tại sẵn                                                                                         | Cách tạo nó                                                                                                                                                                                                                                                          |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `roles[]` (`value` / `hiển thị`)                                                                                                                                                                                                                                                       | Vai trò tài khoản, được đặt tên chính xác. Các vai trò được SCIM tham chiếu, chứ không bao giờ được tạo bởi SCIM. | [Trung tâm quản trị viên](https://zoom.com/account) → Người dùng → [Vai trò](https://zoom.com/role#/) → **Thêm Vai trò** → tên và mô tả → Cấu hình quyền. Xem [Sử dụng Quản lý vai trò](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). |
| `zoomWorkplace` và các thuộc tính giấy phép hoặc tiện ích mở rộng khác — bảng trắng, Scheduler, Clips Plus, phụ đề đã dịch, Quản lý nhân sự, Quản lý chất lượng, Quản lý tuân thủ, CX Insights, AI Bán hàng Assist và các thuộc tính tương ứng `...Subscription` các đối tác tương ứng | Gói hoặc tiện ích mở rộng tương ứng, được mua với các chỗ ngồi chưa sử dụng.                                      | Gói và Thanh toán → Quản lý gói → chỉnh sửa gói → tăng số lượng giấy phép. Xem [Nâng cấp tài khoản và tiện ích bổ sung](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375).                                                                 |
| `loginType` (`sso` / `workEmail`), trong `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`                                                                                                                                                                                             | SSO đã được cấu hình trên tài khoản, cho loại đăng nhập SSO.                                                      | [Trung tâm quản trị](https://zoom.com/account) → Bảo mật và độ tin cậy → [Đăng nhập một lần](https://zoom.com/account/sso/saml).                                                                                                                                     |

Đối với một thuộc tính giấy phép hoặc tiện ích mở rộng, không có đối tượng nào để đặt tên, nhưng điều kiện tiên quyết có tác dụng tương đương: nếu không có chỗ trống khả dụng trong nhóm cụ thể đó, việc gán sẽ thất bại.

#### <mark style="color:xanh dương;">Các thuộc tính không có điều kiện tiên quyết</mark>

Mọi thuộc tính ánh xạ cơ bản đều đủ điều kiện, như đã đề cập trong **Ánh xạ cơ bản: thông tin hồ sơ** — Zoom lưu nguyên văn các giá trị đó và không bao giờ xác thực chúng với một đối tượng hiện có. Hai thuộc tính trong phần mở rộng Zoom cũng hoạt động theo cách tương tự:

* **Giá trị được ủy quyền tự động** — `zoomPhoneExtNumber` được gửi dưới dạng `0`, trong đó Zoom tự cấp số máy lẻ.
* **Thuộc tính tùy chỉnh của tài khoản** — `{customAttribute}` trường này chứa chuỗi bất kỳ mà bạn gửi.

**Các tham chiếu có giá trị mặc định** là trường hợp trung gian: việc bỏ qua `zoomPhoneSite`, `zoomContactCenterRole`, hoặc `zoomContactCenterRegion` lần lượt chuyển về cơ sở chính, Vai trò Agent mặc định và khu vực chính. Bản thân các giá trị mặc định này cũng phải tồn tại; theo mặc định, chúng đều tồn tại.

**Nhóm là một ngoại lệ một phần.** Khi bật tính năng cấp phát nhóm, SCIM sẽ tạo một nhóm Zoom chưa tồn tại, sử dụng chính xác tên nhóm nguồn như đã nhập. Tính năng này không áp dụng cấu hình sản phẩm nào cho nhóm đó — nhóm được tạo chỉ có thành viên, không có gì khác. Bạn vẫn cần cấu hình chính sách Zoom Phone, quyền gọi và các cài đặt cấp nhóm khác trong [Trung tâm quản trị](https://zoom.com/account) → Người dùng → [Nhóm](https://zoom.com/account/group#/) sau khi nhóm xuất hiện.

{% hint style="info" %}
**Khuyến nghị**

Hãy xem việc xây dựng phía Zoom như một giai đoạn tiên quyết với phê duyệt riêng, được hoàn tất và xác minh trước khi công việc ánh xạ thuộc tính bắt đầu. Các cơ sở, số, gói, Vai trò và mẫu thường do một nhóm khác phụ trách so với cấu hình của nhà cung cấp danh tính, và việc phát hiện một đối tượng bị thiếu trong quá trình kiểm thử cấp phát tốn kém hơn nhiều so với việc xác nhận sự tồn tại của nó trước đó.
{% endhint %}

### **Đang chuẩn bị dữ liệu thư mục của bạn**

SCIM truyền bất kỳ thứ gì nguồn chứa. Nó không xác thực, chuẩn hóa hay sửa lỗi. Trước khi ánh xạ bất kỳ thuộc tính nào, hãy xác nhận ba điều về nguồn dự định:

* **Trường này được điền cho mọi người dùng thuộc phạm vi áp dụng.** Trường không được điền sẽ không gửi dữ liệu nào hoặc sẽ gửi giá trị mặc định đã cấu hình.
* **Các giá trị của trường có định dạng và cách viết hoa nhất quán.** Logic so sánh trong cả hai nhà cung cấp danh tính đều chính xác tuyệt đối.
* **Các giá trị của nó khớp chính xác với các giá trị mà Zoom mong đợi.** Zoom không đối sánh gần đúng tên cơ sở, tên Vai trò hoặc giá trị gói dịch vụ.

Khi một trường hiện có không thể đáp ứng cả ba điều kiện, một thuộc tính xây dựng theo mục đích được điền có chủ đích cho Thành phần tích hợp này sẽ bền vững hơn so với việc tận dụng lại một trường mà các hệ thống khác cũng ghi vào.

{% hint style="info" %}
**Khuyến nghị**

Hãy quyết định nguồn dữ liệu chuẩn trước khi chạm vào cấu hình của nhà cung cấp danh tính. Hầu hết các triển khai SCIM thất bại là do vấn đề dữ liệu thư mục được biểu hiện dưới dạng vấn đề cấp phát.
{% endhint %}

### **Các kịch bản tham chiếu**

Bốn kịch bản được dùng xuyên suốt hướng dẫn này. Các yêu cầu Kinh doanh và các điều kiện tiên quyết phía Zoom của chúng là giống nhau bất kể nhà cung cấp danh tính, vì vậy chúng được định nghĩa một lần ở đây. Mỗi phần dành riêng cho từng nhà cung cấp danh tính sẽ kết thúc bằng cách cho thấy cách triển khai cả bốn trong nền tảng đó.

#### <mark style="color:xanh dương;">Kịch bản 0: Phòng ban, như một ánh xạ Cơ bản đầu tiên</mark>

Phòng ban của người dùng nên xuất hiện trên hồ sơ Zoom của họ, được lấy từ thư mục. Đây là ánh xạ Cơ bản được khuyến nghị trước đó như một bài kiểm thử đầu-cuối đầu tiên, và nó được đưa vào đây để quy trình được thực hiện trong cả hai phần nhà cung cấp danh tính.

**Điều kiện tiên quyết phía Zoom.** Không có. Zoom lưu trữ giá trị chính xác như được gửi và không bao giờ xác thực giá trị đó dựa trên một đối tượng hiện có.

**Thuộc tính.** Lưu ý rằng phần tử cha khác với ba trường hợp dưới đây — `department` nằm trong phần mở rộng Doanh nghiệp lớn, không phải phần mở rộng Zoom.

| Thuộc tính                                                              | Loại  | Ghi chú                                                                                                                                |
| ----------------------------------------------------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` | chuỗi | Văn bản tự do. Cả hai nhà cung cấp danh tính đều đã có trường `department` trong hồ sơ người dùng, nên không cần thuộc tính nguồn mới. |

**Vì sao nên bắt đầu từ đây.** Giá trị phòng ban hiển thị chính xác trên hồ sơ Zoom chứng minh rằng khai báo lược đồ, ánh xạ, phạm vi và khả năng đọc nhật ký cấp phát của bạn đều hoạt động — mà không gây rủi ro cho giấy phép hay cấu hình điện thoại. Mỗi tình huống nâng cao bên dưới chỉ khác ở đích mà thuộc tính trỏ đến.

**Trước tiên, hãy kiểm tra xem thuộc tính đã được ánh xạ chưa.** Ánh xạ mặc định khác nhau giữa Entra ID và Okta, đồng thời thay đổi khi cả hai nhà cung cấp cập nhật tích hợp Zoom. Xem lại danh sách hiện có trong **Cấp phát** → **Ánh xạ** trong Entra, hoặc **Ánh xạ thuộc tính Zoom** với **Hiển thị các thuộc tính chưa được ánh xạ** được bật trong Okta. Nếu `department` đã được ánh xạ, hãy xác minh ánh xạ đó thay vì khai báo trùng lặp — và nếu bạn muốn Cấu hình một thuộc tính khác từ đầu, `costCenter`, `Tổ chức`, và `employeeNumber` nằm dưới cùng một mục cha và hoạt động giống hệt nhau.

#### <mark style="color:xanh dương;">Tình huống 1: cơ sở Zoom Phone và gán số máy lẻ tự động</mark>

Người dùng nên được đặt vào đúng cơ sở Zoom Phone dựa trên văn phòng của họ và nhận số máy lẻ mà không cần can thiệp của quản trị viên.

**Điều kiện tiên quyết phía Zoom** Các cơ sở phải tồn tại từ trước. Tạo chúng trong [**Trung tâm quản trị**](https://zoom.com/account) → **Cấu hình sản phẩm** → **hệ thống điện thoại** → [**Thông tin công ty**](https://zoom.com/pbx/page/telephone/settings#/settings) → **Thêm cơ sở**, hoặc hàng loạt thông qua **Nhập**. Địa chỉ cơ sở được xác thực dựa trên cơ sở dữ liệu địa chỉ thực tế vì chúng hỗ trợ các dịch vụ cuộc gọi khẩn cấp, do đó các tổ hợp địa chỉ và mã bưu chính hư cấu sẽ không vượt qua bước xác thực.

**Thuộc tính.** Cả hai đều lấy không gian tên `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:` theo sau là tên.

| Thuộc tính           | Loại  | Ghi chú                                 |
| -------------------- | ----- | --------------------------------------- |
| `zoomPhoneSite`      | chuỗi | Phải khớp từng ký tự với tên cơ sở Zoom |
| `zoomPhoneExtNumber` | chuỗi | `0` kích hoạt việc tự động gán          |

**Vì sao giá trị `0` vấn đề.** Zoom là hệ thống duy nhất biết những số máy lẻ nào đang được sử dụng — bao gồm cả số máy lẻ được gán cho hàng đợi cuộc gọi và tổng đài tự động, thay vì cho người dùng. Giao việc gán số máy lẻ cho Zoom giúp loại bỏ hoàn toàn một nhóm lỗi cấp phát. Lấy số máy lẻ từ danh bạ sẽ phù hợp hơn trong quá trình di chuyển, khi việc giữ nguyên các số máy lẻ hiện có là quan trọng, nhưng cần chuyển ánh xạ sang `0` sau khi quá trình di chuyển hoàn tất, để những người tham gia sau này không phụ thuộc vào việc dữ liệu thư mục được duy trì vô thời hạn.

{% hint style="info" %}
**Lưu ý**

Cơ sở mặc định trên một tài khoản Zoom Phone thường có tên chính xác là `Cơ sở chính`, hiển thị bên dưới [**Trung tâm quản trị viên**](https://zoom.com/account) → **Cấu hình sản phẩm** → **hệ thống điện thoại** → [**Thông tin công ty**](https://zoom.com/pbx/page/telephone/settings#/settings). Hãy xác nhận tên trên tài khoản cụ thể trước khi dựa vào tên đó, vì tên có thể được đổi.
{% endhint %}

#### <mark style="color:xanh dương;">Kịch bản 2: gói cuộc gọi Zoom Phone thay đổi theo quốc gia</mark>

Một Tổ chức đa quốc gia đã mua các gói cuộc gọi Zoom Phone độc lập và cần mỗi người dùng nhận được gói phù hợp với quốc gia của họ.

**Điều kiện tiên quyết ở phía Zoom.** Các gói cuộc gọi phải được mua và có sẵn trên tài khoản. Giá trị của gói được mô tả trong [tài liệu tham khảo về gói cuộc gọi Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/).

**Thuộc tính.** `zoomPhoneCallingPlan` (chuỗi).

**Cách lấy mã gói phù hợp.** `zoomPhoneCallingPlan` nhận mã gói dạng số, không phải tên gói. Cách đáng tin cậy nhất để lấy mã này là [Liệt kê các gói gọi](https://developers.zoom.us/docs/api/references/phone-calling-plans/) API, trả về của mỗi gói `name`, của nó `type` — mã bạn ánh xạ — và `subscribed` và `Đang rảnh` số lượng chỗ. Vì vậy, một lệnh gọi sẽ xác nhận gói này tồn tại, cung cấp giá trị cần gửi và kiểm tra xem có đủ dung lượng để Chỉ định gói hay không.

Cổng thông tin web của Zoom chỉ hiển thị tên hiển thị, không hiển thị mã. Do đó, quản trị viên chỉ làm việc trên cổng thông tin phải tra tên hiển thị theo [tài liệu tham khảo về gói cuộc gọi Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/) — ví dụ như `UNLIMITED_PLAN_US_CA` là `200` và `UNLIMITED_PLAN_GB_IE` là `202`. Tài liệu tham khảo liệt kê tên hằng số thay vì cách gọi trên cổng thông tin, vì vậy hãy đối chiếu các đặc điểm của gói — khu vực và hình thức tính cước theo mức sử dụng hay không giới hạn — thay vì dựa vào văn bản trùng khớp chính xác.

Ngoài ra, tài liệu tham khảo API SCIM2 của Zoom cho biết tên gói thanh toán, chẳng hạn như `phone_calling_usca_monthly_unlimited` trong payload ví dụ của mình. Mã nhận diện đó được dùng để *mua* gói đăng ký, chứ không phải để chỉ định gói dịch vụ cho người dùng. Nếu bạn cần chỉ định gói dịch vụ sử dụng gói đăng ký nào, thông tin đó thuộc về `zoomPhoneCallingPlanSubscription`.

**Tại sao `-1` được dùng làm giá trị dự phòng.** Tài liệu tham khảo SCIM2 mô tả `-1` là giá trị dùng để xóa tất cả gói gọi. Dùng giá trị này cho người dùng không khớp sẽ tạo ra kết quả xác định và hiển thị được — không có gói nào được chỉ định — thay vì sự mơ hồ khi không gửi giá trị nào. Giá trị này cũng cung cấp cách rõ ràng để thu hồi quyền gọi mà không cần xóa người dùng.

#### <mark style="color:xanh dương;">Kịch bản 3: Gói Zoom trung tâm liên hệ, Vai trò và khu vực</mark>

Các nhân viên trung tâm liên hệ nên được cấp phát đúng Gói ZCC và Vai trò ngay tại thời điểm Hướng dẫn nhập môn, thay vì được cấu hình thủ công sau đó. Kịch bản này cho thấy phương pháp này không phụ thuộc vào sản phẩm — không có gì trong quy trình thay đổi, chỉ là tên thuộc tính và các giá trị được phép.

| Thuộc tính                 | Loại  | Các giá trị được phép                                                          |
| -------------------------- | ----- | ------------------------------------------------------------------------------ |
| `zoomContactCenterPackage` | chuỗi | `Essentials`, `Premium`, `Elite`                                               |
| `zoomContactCenterRole`    | chuỗi | Tên vai trò ZCC bất kỳ. Mặc định là `Agent` nếu không được chỉ định.           |
| `zoomContactCenterRegion`  | chuỗi | Bất kỳ khu vực ZCC nào đã được cấu hình. Mặc định là khu vực chính nếu bỏ qua. |

**Về việc cố ý bỏ qua thuộc tính.** Rời khỏi `zoomContactCenterRegion` không được ánh xạ trong các triển khai một vùng, nơi giá trị mặc định được Zoom tài liệu hóa vốn đã chính xác. Nếu giá trị mặc định của một thuộc tính là phù hợp thì nên bỏ qua thuộc tính đó thay vì ánh xạ nó — mỗi ánh xạ đều tạo thêm nghĩa vụ bảo trì.

**Lưu ý vận hành.** Tài liệu tham khảo SCIM2 cũng trình bày `zoomContactCenterUserTemplate`, áp dụng một mẫu ZCC dựng sẵn. Các mẫu loại Thêm được áp dụng khi tạo người dùng, còn các mẫu loại cập nhật được áp dụng khi cập nhật; nếu cùng một yêu cầu cung cấp cả mẫu lẫn các giá trị thuộc tính riêng lẻ thì các giá trị riêng lẻ sẽ được ưu tiên. Nên cân nhắc sử dụng mẫu khi cấu hình ZCC đủ phức tạp khiến việc duy trì cấu hình này qua nhiều ánh xạ thuộc tính riêng lẻ trở nên khó quản lý.

### **Xác minh phía Zoom và các lỗi thường gặp**

Mỗi nhà cung cấp danh tính có nhật ký riêng của họ, được đề cập trong Bước 6 của từng nhà cung cấp danh tính. Nhật ký phía Zoom bên dưới là giống hệt cho cả hai và là bản ghi xác định về những gì Zoom thực sự đã nhận.

#### <mark style="color:xanh dương;">Nhật ký cuộc gọi của Zoom App Marketplace Hiển thị toàn bộ quá trình trao đổi yêu cầu và phản hồi</mark>

1. Đăng nhập vào Cổng thông tin web của Zoom với tư cách là chủ sở hữu tài khoản.
2. Điều hướng đến [**Zoom App Marketplace**](https://marketplace.zoom.us/) → **Quản lý** → **Ứng dụng trong tài khoản**.
3. Chọn ứng dụng đại diện cho kết nối nhà cung cấp danh tính. Đối với Entra, ứng dụng này thường có tên **Azure Identity** hoặc tương tự.
4. Mở **Nhật ký cuộc gọi** thẻ.
5. Sử dụng **Tìm kiếm theo điểm cuối**, hoặc các bộ lọc phạm vi ngày, phương thức và trạng thái để tìm cuộc gọi liên quan.
6. Chọn hàng để mở rộng nó.
7. Xem lại `requestBody` để biết chính xác nội dung đã gửi và `response` để biết chính xác nội dung Zoom đã trả về, bao gồm mã người dùng Zoom được tạo, `httpStatus` và tập hợp thuộc tính thu được.

Zoom lưu giữ 100 nhật ký yêu cầu API gần đây nhất, vì vậy hãy điều tra lỗi kịp thời thay vì đợi đến sau khi các hoạt động cấp phát tiếp theo đã thay thế nó.

#### <mark style="color:xanh dương;">Các lỗi cấp phát thường gặp và nguyên nhân của chúng</mark>

<table><thead><tr><th width="99.69622802734375">Mã</th><th>Thông báo</th><th>Nguyên nhân và cách khắc phục</th></tr></thead><tbody><tr><td>400</td><td>Tài khoản chưa bật Đăng nhập một lần.</td><td>SSO là điều kiện tiên quyết cho SCIM. Bật và Cấu hình SSO trên Tài khoản Zoom trước.</td></tr><tr><td>400</td><td>người dùng không hoạt động hoặc bị khóa.</td><td>người dùng Zoom mục tiêu không thể được cập nhật trong trạng thái hiện tại. Giải quyết trạng thái tài khoản trong Cổng thông tin web của Zoom.</td></tr><tr><td>403</td><td>Yêu cầu đã bị từ chối do quyền không đủ: "người dùng:Edit".</td><td>Thông tin xác thực đằng sau kết nối SCIM thiếu phạm vi cần thiết. Ủy quyền lại kết nối với tài khoản Chủ sở hữu hoặc tài khoản quản trị viên.</td></tr><tr><td>404</td><td>người dùng không tồn tại.</td><td>Nhà cung cấp danh tính không đối chiếu người dùng với một người dùng Zoom hiện có. Xác minh thuộc tính khớp và định dạng Tên người dùng.</td></tr><tr><td>409</td><td>Miền email không khớp với miền liên kết của tài khoản.</td><td>Miền email của người dùng không được liên kết với Tài khoản Zoom. Liên kết và xác minh miền trước khi cung cấp.</td></tr><tr><td>409</td><td>Không thể Thêm người dùng trả phí.</td><td>Không có giấy phép của loại được yêu cầu nào Đang rảnh. Giải phóng dung lượng trên tài khoản, hoặc cấp cho người dùng là Cơ bản.</td></tr><tr><td>409</td><td>Không thể tạo thêm người dùng với [bundle name].</td><td>Gói cụ thể không còn chỗ trống nào. Áp dụng cho Workplace Kinh doanh Nâng cao, Doanh nghiệp lớn Premier, Chuyên nghiệp Plus, và các bản tương đương Giáo dục.</td></tr><tr><td>429</td><td>Quá nhiều yêu cầu.</td><td>Cấp phát đã vượt quá giới hạn tốc độ của Zoom. Hãy điều tra nếu tình trạng này vẫn kéo dài qua các chu kỳ.</td></tr></tbody></table>

#### <mark style="color:xanh dương;">Một chế độ lỗi không tạo ra bất kỳ lỗi nào cả</mark>

Một giá trị mà Zoom chấp nhận nhưng không tương ứng với bất kỳ thứ gì — chẳng hạn tên cơ sở có khoảng trắng ở cuối, hoặc tên Vai trò vì đã được đổi tên trong Zoom — có thể được chấp nhận về mặt cú pháp và không áp dụng cho gì cả. Không có mục nhật ký nào đánh dấu sự việc này. Các biến thể riêng cho từng nền tảng của cùng một vấn đề được đề cập trong Bước 6.

{% hint style="info" %}
**Lưu ý**

Khi Zoom và nhà cung cấp danh tính không đồng ý về cấu hình của người dùng, hãy xem nhà cung cấp danh tính là bên có thẩm quyền và sửa giá trị ở đó. Chỉnh sửa trực tiếp trong Cổng thông tin web của Zoom sẽ tạo ra một trạng thái mà Sự kiện cấp phát tiếp theo sẽ ghi đè, khiến vấn đề gốc khó chẩn đoán hơn.
{% endhint %}

## **Cấu hình SCIM với Entra ID**

#### <mark style="color:xanh dương;">Các yêu cầu bổ sung cho Entra ID</mark>

* Quyền quản trị viên Entra ID với Truy cập vào các Ứng dụng Doanh nghiệp lớn
* Tên miền email mà người dùng của bạn sử dụng, đã được xác minh là một tên miền tùy chỉnh trong tenant Entra ID

#### <mark style="color:xanh dương;">Các hạn chế bổ sung trong Entra ID</mark>

* Các ánh xạ thuộc tính chỉ lấy nguồn từ *đối tượng người dùng* Entra. Nhóm bảo mật không thể trực tiếp cung cấp giá trị cho thuộc tính Zoom; tư cách thành viên nhóm kiểm soát phạm vi, không phải giá trị.
* Các chu kỳ cấp phát gia tăng chạy khoảng mỗi 40 phút. Các thay đổi không diễn ra tức thì sau khi cấp phát được bật.
* Giá trị `Collaboration` của `userType` không được hỗ trợ với Entra ID do một hạn chế riêng của Microsoft.

{% hint style="info" %}
**Lưu ý**

Có thể thực hiện cấu hình cấp phát Tiêu chuẩn từ cả `entra.microsoft.com` lẫn `portal.azure.com`. Tuy nhiên, trình chỉnh sửa lược đồ được dùng ở Bước 1 chỉ có thể truy cập thông qua URL Azure Portal có thêm tham số `forceSchemaEditorEnabled` . Cờ này không có tác dụng trên `entra.microsoft.com`. Hãy dùng liên kết Azure Portal ở Bước 1 cho tất cả các bước trong phần này để tránh chuyển đổi cổng thông tin giữa chừng khi cấu hình.
{% endhint %}

### Bước 1: Khai báo thuộc tính trong lược đồ ứng dụng Zoom

Việc khai báo một thuộc tính là thao tác một lần cho mỗi thuộc tính. Hãy khai báo mọi thuộc tính bạn dự định sử dụng trước khi cấu hình bất kỳ ánh xạ nào, để tất cả các đích đều sẵn có ở Bước 2.

1. Đăng nhập vào Azure Portal bằng URL của trình chỉnh sửa lược đồ: `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home`
2. Trong **Dịch vụ Azure**, chọn **Microsoft Entra ID**.
3. Trong menu điều hướng bên trái, bên dưới **Quản lý**, nhấp vào **Ứng dụng Doanh nghiệp lớn**.
4. Trong danh sách ứng dụng, nhấp vào ứng dụng Zoom của bạn.\
   **Lưu ý**: Tên ứng dụng do quản trị viên Entra đặt khi tạo ứng dụng. Tên thường dùng là **Zoom** hoặc **Zoom SSO**, nhưng có thể khác trong đối tượng thuê của bạn.
5. Trong menu điều hướng bên trái, bên dưới **Quản lý**, nhấp vào **Cấp phép**.\
   **Lưu ý**: Azure hiện có một trong hai bố cục. Trong giao diện cũ, hãy chọn **Chỉnh sửa ánh xạ thuộc tính** trong mục **Quản lý cấp phép**. Trong giao diện mới hơn, trang sẽ mở ở thẻ **Tổng quan** ; hãy chọn **Cấp phép** một lần nữa từ menu bên trái. Cả hai cách đều dẫn đến cùng một nơi.
6. Nhấp vào **Ánh xạ** menu thả xuống, sau đó nhấp **Cấp phép người dùng Microsoft Entra ID**.\
   **Lưu ý**: Trong các tenant vẫn hiển thị cách đặt tên cũ, tùy chọn này xuất hiện dưới tên **Cấp phép người dùng Azure Active Directory**.
7. Ở góc dưới bên trái, hãy chọn **Hiển thị tùy chọn nâng cao** hộp kiểm.
8. Nhấp **Chỉnh sửa danh sách thuộc tính cho Zoom**.
9. Cuộn đến hàng trống đầu tiên và hoàn thành các nội dung sau:
   * **Tên**: Đi vào chuỗi thuộc tính đầy đủ, ví dụ `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **Loại**: Chọn **Chuỗi** hoặc **Giá trị Boolean**, khớp với kiểu dữ liệu được ghi trong tài liệu tham khảo API SCIM2.
10. Lặp lại bước 9 cho mỗi thuộc tính bổ sung.
11. Ở góc trên bên trái, nhấp vào **Lưu**.

{% hint style="warning" %}
**Lưu ý**

Tên thuộc tính phân biệt chữ hoa chữ thường và phải khớp chính xác với tài liệu tham khảo API. `zoomPhoneSite` là hợp lệ; `zoomphonesite` và `ZoomPhoneSite` thì không. Trình chỉnh sửa lược đồ chấp nhận thuộc tính viết sai kiểu chữ mà không báo lỗi, nhưng yêu cầu sẽ âm thầm thất bại tại API Zoom.

Đối với các thuộc tính được tài liệu mô tả là `boolean`, **Chuỗi** cũng hợp lệ nếu nguồn được ánh xạ cung cấp văn bản `true` hoặc `false`. Chọn **Chuỗi** thường thiết thực hơn khi nguồn là thuộc tính mở rộng Entra, vốn lưu trữ văn bản.
{% endhint %}

### Bước 2: Ánh xạ một nguồn thư mục tới thuộc tính

Entra ID cung cấp ba kiểu ánh xạ, và việc lựa chọn giữa chúng là quyết định quan trọng nhất trong phần Cấu hình.

<table><thead><tr><th width="133.376708984375">Kiểu ánh xạ</th><th>Dùng khi</th><th>Hành vi</th></tr></thead><tbody><tr><td><strong>Trực tiếp</strong></td><td>Một trường Entra đã chứa chính xác giá trị mà Zoom mong đợi.</td><td>Chuyển nguyên giá trị nguồn mà không thay đổi.</td></tr><tr><td><strong>Hằng số</strong></td><td>Mọi người dùng trong phạm vi đều nên nhận cùng một giá trị.</td><td>Gửi một giá trị cố định đến mọi người dùng được cung cấp.</td></tr><tr><td><strong>Biểu thức</strong></td><td>Giá trị phải được suy ra, dịch, hoặc thay đổi theo thuộc tính người dùng.</td><td>Đánh giá một biểu thức dựa trên các trường nguồn và gửi kết quả.</td></tr></tbody></table>

**Để tạo ánh xạ:**

1. Quay lại **Cấp phát** → **Ánh xạ** → **Cấp phát người dùng Microsoft Entra ID**.
2. Ở góc dưới bên trái, nhấp vào **Thêm ánh xạ mới**.
3. Cấu hình ánh xạ theo loại đã chọn — xem hướng dẫn bên dưới.
4. Nhấp vào **Thuộc tính đích** danh sách thả xuống và chọn thuộc tính đã khai báo ở Bước 1.
5. Nhấp vào **Đối chiếu các đối tượng bằng thuộc tính này** danh sách thả xuống và Chọn **Không**.\
   **Lưu ý**: Các thuộc tính Zoom tùy chỉnh là giá trị cấu hình, không phải khóa đối chiếu danh tính. Chỉ thuộc tính liên kết người dùng Entra với người dùng Zoom — thường là `Tên người dùng` — nên được đặt thành **Có**.
6. Nhấp vào **Áp dụng ánh xạ này** danh sách thả xuống và lựa chọn **Luôn luôn**, để giá trị được áp dụng cả khi tạo mới lẫn khi cập nhật sau đó.
7. Nhấp vào **OK**.
8. Lặp lại cho từng thuộc tính, sau đó nhấp vào **Lưu** ở đầu trang **Ánh xạ thuộc tính** .

#### <mark style="color:xanh dương;">Ánh xạ trực tiếp chuyển một trường hiện có qua mà không biến đổi</mark>

* **Loại ánh xạ**: **Trực tiếp**
* **Thuộc tính nguồn**: Một trường Entra có giá trị khớp chính xác với giá trị Zoom mong đợi, từng ký tự một
* **Giá trị mặc định nếu null (Tùy chọn)**: Giá trị dự phòng được áp dụng khi trường nguồn trống

Ánh xạ trực tiếp là lựa chọn ít dễ gặp lỗi nhất và nên được ưu tiên ở mọi nơi dữ liệu thư mục hỗ trợ. Nếu `physicalDeliveryOfficeName` — hiển thị dưới dạng **Vị trí văn phòng** trên hồ sơ người dùng Entra — đã chứa các giá trị khớp chính xác với tên cơ sở Zoom Phone, nên việc ánh xạ trực tiếp hoàn toàn không cần logic.

{% hint style="info" icon="lightbulb" %}
**Mẹo**

Điền **Giá trị mặc định nếu là null** bất cứ khi nào giá trị nguồn bị thiếu có thể gây ra lỗi hoặc kết quả ngoài ý muốn. Giá trị mặc định `Cơ sở chính` ánh xạ cơ sở đảm bảo người dùng không có Vị trí văn phòng vẫn được cấp quyền thành công thay vì rơi vào trạng thái không xác định.
{% endhint %}

#### <mark style="color:xanh dương;">Ánh xạ hằng áp dụng một giá trị cho toàn bộ tập người dùng trong phạm vi</mark>

* **Loại ánh xạ**: **Hằng số**
* **Giá trị hằng**: Giá trị cố định cần gửi

Ánh xạ hằng số phù hợp với các triển khai chỉ có một cấu hình và cũng là cơ chế đứng sau một số hành vi riêng của Zoom. Đặt `zoomPhoneExtNumber` thành một hằng số có giá trị `0` sẽ hướng dẫn Zoom Chỉ định số máy lẻ tiếp theo đang rảnh trong cơ sở của người dùng, loại bỏ hoàn toàn tình trạng trùng số máy lẻ.

#### <mark style="color:xanh dương;">Ánh xạ biểu thức dịch hoặc suy ra một giá trị tại thời điểm cấp phát</mark>

* **Loại ánh xạ**: **Biểu thức**
* **Biểu thức**: Một câu lệnh lồng nhau `IIF()` đánh giá một hoặc nhiều thuộc tính nguồn

Ánh xạ biểu thức là bắt buộc bất cứ khi nào giá trị trong thư mục và giá trị trong Zoom không phải cùng một chuỗi:

```
IIF([officeLocation]="London","LON-01",
IIF([officeLocation]="Manchester","MAN-01",
"Cơ sở chính"))
```

{% hint style="danger" %}
**Cảnh báo**

Biểu thức so sánh văn bản chính xác theo cách được nhập, bao gồm cả chữ hoa và chữ thường. `GB` và `gb` là các giá trị khác nhau, tương tự như `United Kingdom` và `united kingdom`. So sánh không khớp sẽ không phát sinh lỗi — biểu thức chuyển sang nhánh mặc định và người dùng được cấp cấu hình sai mà không có cảnh báo.
{% endhint %}

Bọc các giá trị nguồn trong `ToUpper()` và so sánh với các giá trị cố định viết hoa để loại bỏ sự không nhất quán về chữ hoa chữ thường:

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

#### <mark style="color:xanh dương;">Định dạng trường nguồn thay đổi tùy theo cách người dùng Entra được tạo</mark>

Đây là nguyên nhân phổ biến nhất của các ánh xạ biểu thức trông có vẻ đúng nhưng hoạt động không nhất quán trên toàn bộ tập người dùng.

* **Vị trí sử dụng** được Microsoft quy định phải luôn chứa mã ISO 3166-1 alpha-2 hợp lệ, chẳng hạn như `GB`, vì mã này quyết định tính khả dụng của giấy phép và Tính năng. Trường này đáng tin cậy.
* **Quốc gia hoặc khu vực** không có quy định như vậy và nội dung của trường tùy thuộc vào phương thức tạo người dùng. Người dùng được tạo qua giao diện đồ họa của cổng thông tin quản trị Entra sẽ Chọn từ danh sách thả xuống gồm tên quốc gia đầy đủ, vì vậy trường này thường lưu giá trị `United Kingdom`. Người dùng được tạo qua tính năng nhập CSV hoặc PowerShell thường được điền giá trị `GB` — theo quy ước chứ không phải theo quy định bắt buộc.

Trong mọi tenant có người dùng được tạo bằng nhiều phương thức khác nhau, `country` sẽ không có định dạng nhất quán. Hãy chuẩn hóa trường này trước khi tạo biểu thức hoặc kiểm tra rõ ràng cả hai định dạng như minh họa ở trên.

### Bước 3: Đưa người dùng và nhóm vào phạm vi cấp phát

Việc gán quyết định những người dùng nào mà cấu hình tác động đến. Người dùng nằm ngoài phạm vi gán của ứng dụng sẽ không bao giờ bị ảnh hưởng bởi bất kỳ ánh xạ nào, điều này khiến việc gán trở thành cơ chế kiểm soát an toàn chính trong quá trình triển khai.

1. Đi đến **Microsoft Entra ID** → **Ứng dụng Doanh nghiệp lớn** → ứng dụng Zoom của bạn → **Người dùng và nhóm**.
2. Nhấp vào **Thêm người dùng/nhóm**.
3. Trong mục **Người dùng và nhóm**, Chọn người dùng hoặc nhóm bảo mật cần thiết.
4. Trong mục **Chọn một vai trò**, Chọn vai trò phù hợp.
5. Nhấp vào **Chỉ định**.

Trên thực tế, chỉ có hai giá trị Vai trò là quan trọng. Các tùy chọn khác như **Corp** và **Chuyên nghiệp** là tên gọi cũ đang dần bị loại bỏ hoặc dành cho các trường hợp ít gặp.

<table><thead><tr><th width="157.5225830078125">Vai trò</th><th>Tác dụng</th></tr></thead><tbody><tr><td><strong>Cơ bản</strong></td><td>Cấp phát cho người dùng mà không có giấy phép cuộc họp trả phí. Chọn mục này khi một thuộc tính tùy chỉnh — chẳng hạn như một gói cuộc gọi Zoom Phone — chịu trách nhiệm gán quyền lợi trả phí.</td></tr><tr><td><strong>Được cấp giấy phép</strong></td><td>Chỉ định gói giấy phép <em>mặc định</em> của Tài khoản Zoom, ví dụ: Zoom Workplace Doanh nghiệp lớn Plus. Màn hình này không Cho phép Chọn một gói cụ thể; gói mặc định được cấu hình ở phía Zoom.</td></tr></tbody></table>

Việc chọn Vai trò này áp dụng một lần cho mỗi người dùng hoặc nhóm được thêm vào ứng dụng, bất kể có bao nhiêu thuộc tính tùy chỉnh đang được cấp phát.

**Để cấp phát các nhóm Entra dưới dạng nhóm Zoom**, tính năng này bị tắt theo mặc định:

1. Chuyển đến **Cấp phát** → **Ánh xạ** và Chọn **Cấp phát nhóm Microsoft Entra ID**.
2. Chuyển **Đã bật** sang **Có**.
3. Xác nhận các ánh xạ mặc định đã được thiết lập: `displayName` → `displayName`, và `members` → `members`.
4. Nhấp vào **Lưu**.
5. Quay lại **Người dùng và nhóm** và xác nhận chính nhóm đó được gán cho ứng dụng, chứ không chỉ các thành viên riêng lẻ. Tính năng cấp phát nhóm chỉ xử lý các nhóm được gán trực tiếp.

{% hint style="warning" %}
**Lưu ý: SCIM làm gì và không làm gì với nhóm**

Nếu chưa có nhóm Zoom trùng tên, SCIM sẽ tạo một nhóm bằng cách sử dụng `displayName` của nhóm Entra đúng như đã nhập. Nhóm được tạo cùng các thành viên nhưng **không có cấu hình sản phẩm nào**. Quản trị viên vẫn phải mở [**Trung tâm quản trị**](https://zoom.com/account) → **Người dùng** → [**Nhóm**](https://zoom.com/account/group#/) trong Cổng thông tin web của Zoom và áp dụng Cài đặt mong muốn — chính sách Zoom Phone ở cấp nhóm, quyền gọi điện hoặc cấu hình sản phẩm khác. SCIM tạo nhóm và quản lý tư cách thành viên; nó không xác định nhóm đó làm gì trong Zoom.
{% endhint %}

### Bước 4: Xác thực bằng Cấp phát theo yêu cầu

**Cấp phát theo yêu cầu** hoạt động độc lập với nút Bật/tắt **Trạng thái cấp phát** , và đó chính là lý do đây là công cụ phù hợp để xác thực. Mọi bước cho đến thời điểm này — kể cả bước này — đều có thể được hoàn thành khi tính năng cấp phát vẫn đang tắt.

1. Chuyển đến **Cấp phát** → **Tổng quan về cấp phát**.
2. Nhấp vào **Cấp phát theo yêu cầu**.
3. Tìm và Chọn một người dùng thử nghiệm, sau đó nhấp vào **Cấp phát**.
4. Xem lại kết quả. Entra báo cáo bốn giai đoạn mà hệ thống chạy cho mọi Sự kiện cấp phát — **Nhập**, **Xác định có thuộc phạm vi hay không**, **Khớp**, và **Cấp phát** — mỗi giai đoạn có thể mở rộng riêng.
5. Xác nhận rằng các giá trị thuộc tính hiển thị khớp với ý định của bạn.
6. Đăng nhập vào Cổng thông tin web của Zoom và xác nhận rằng cấu hình đã được áp dụng.

{% hint style="info" %}
**Khuyến nghị**

Kiểm tra bằng một người dùng đại diện cho trường hợp *khó nhất* trong nhóm người dùng của bạn — người dùng ở nước ngoài, người dùng được tạo bằng một phương thức khác hoặc người dùng có trường nguồn để trống. Một bài kiểm tra chỉ bao quát trường hợp đơn giản sẽ không phát hiện các chế độ lỗi được mô tả ở Bước 2.
{% endhint %}

### Bước 5: Bật cấp phát liên tục

Bật cấp phát sẽ áp dụng cấu hình trực tiếp cho mọi người dùng trong phạm vi. Hoàn thành và xác minh các Bước 1 đến 4 trước.

1. Điều hướng đến **Microsoft Entra ID** → **Ứng dụng Doanh nghiệp lớn** → ứng dụng Zoom của bạn → **Cấp phép** → **Cấp phép**.
2. Bật/tắt **Trạng thái cấp phép** thành **Bật**.
3. Nhấp vào **Lưu**.

Chu kỳ đầu tiên có thể mất tới khoảng 40 phút. Các chu kỳ tăng dần tiếp theo chạy với khoảng cách khoảng 40 phút. Người dùng mới, thay đổi thuộc tính và hủy kích hoạt sẽ đồng bộ theo Lên lịch đó thay vì ngay lập tức.

### Bước 6: Xác minh bằng cách sử dụng nhật ký cấp phát của Entra

1. Điều hướng đến **Microsoft Entra ID** → **Ứng dụng Doanh nghiệp lớn** → ứng dụng Zoom của bạn → **Giám sát** → **Nhật ký cấp phép**.
2. Tìm kiếm hoặc lọc theo người dùng thử nghiệm, sau đó Chọn sự kiện liên quan. Chế độ xem chi tiết mở ra với bốn tab: **Các bước**, **Khắc phục sự cố & Đề xuất**, **Các thuộc tính đã sửa đổi**, và **Tóm tắt**.
3. Xem lại **Tóm tắt** để xác nhận thao tác thành công hay thất bại.
4. Nếu thao tác thất bại, hãy mở **Khắc phục sự cố & đề xuất**, nơi hiển thị thao tác đã thử thực hiện, tên chính của người dùng bị ảnh hưởng và — trong mục **Chi tiết** — mã lỗi và thông báo lỗi đầy đủ do API của Zoom trả về.

Điều này đáng tin cậy hơn việc kiểm tra màn hình ánh xạ vì nó hiển thị các giá trị nguyên văn được truyền đi thay vì những gì phép ánh xạ dự kiến tạo ra. Khi nhật ký Entra không đưa ra kết luận rõ ràng, hãy chuyển sang nhật ký cuộc gọi của Zoom App Marketplace được mô tả trong **Xác minh phía Zoom và các lỗi thường gặp**, hiển thị nội dung trao đổi yêu cầu và phản hồi thô.

#### <mark style="color:xanh dương;">Hành vi Hướng dẫn nhập môn và rời hệ thống trong Entra ID</mark>

* Phạm vi là biện pháp kiểm soát an toàn chính. Những người dùng nằm ngoài phạm vi gán của ứng dụng không bao giờ bị bất kỳ ánh xạ nào trong cấu hình này sửa đổi.
* Vô hiệu hóa một người dùng trong Entra, hoặc loại bỏ họ khỏi phạm vi, sẽ tự động đảo ngược việc cấp phát và khép lại vòng lặp ngừng nhập môn.
* Mọi lỗi đều tạo ra một mục nhật ký tương ứng — với lưu ý về lỗi im lặng đã nêu ở trên.

### Bước 7: Áp dụng các kịch bản tham chiếu trong Entra ID

Các tình huống, điều kiện tiên quyết và định nghĩa thuộc tính nằm trong [**Các tình huống tham chiếu**](#reference-scenarios) phần. Ở đây chỉ cung cấp các ánh xạ Entra.

**Tình huống 0 — Phòng ban.** Ở Bước 1, hãy khai báo `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` là **Chuỗi**, lưu ý sử dụng không gian tên Doanh nghiệp lớn thay vì không gian tên Zoom. Ánh xạ thành **Trực tiếp** từ trường Entra `department` trường. Không **Giá trị mặc định nếu null** là cần thiết — trường nguồn trống sẽ không gửi gì, và không cần phải tồn tại đối tượng nào ở phía Zoom.

**Tình huống 1 — cơ sở Zoom Phone và số máy lẻ tự động.** Ánh xạ `zoomPhoneSite` thành **Trực tiếp** từ `physicalDeliveryOfficeName`, với **Giá trị mặc định nếu là null** được đặt thành `Main cơ sở`. Bản đồ `zoomPhoneExtNumber` thành **Hằng số** với giá trị là `0` trừ khi bạn đang di chuyển cấu hình tiện ích mở rộng hiện có. Nếu giá trị vị trí văn phòng không khớp chính xác với tên cơ sở Zoom, hãy thay bằng một **Biểu thức** bản ánh xạ theo định dạng trong Bước 2.

**Tình huống 2 — Gói cuộc gọi thay đổi theo quốc gia.** Vì Entra không thể lấy giá trị từ một nhóm nên cần dùng biểu thức. Hãy mở rộng biểu thức bằng cách thêm các `IIF()` các lớp cho mỗi quốc gia, đồng thời tính đến cả định dạng alpha-2 và định dạng đầy đủ như mô tả ở Bước 2:

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

Khi thuộc tính gói cuộc gọi chỉ định quyền lợi trả phí, hãy Chọn **Cơ bản** thay vì **Được cấp giấy phép** ở Bước 3. Việc Chọn **Được cấp giấy phép** sẽ áp dụng thêm giấy phép mặc định của tài khoản, điều này có thể không phù hợp với kết quả thương mại mong muốn.

**Tình huống 3 — Gói Trung tâm liên hệ, Vai trò và khu vực.** Ánh xạ `zoomContactCenterPackage` với một **Biểu thức** được điều khiển bởi trường thư mục phân biệt các cấp tác nhân, và `zoomContactCenterRole` là **Trực tiếp** từ một trường chứa tên vai trò. Rời khỏi `zoomContactCenterRegion` chưa được ánh xạ trong các triển khai một vùng.

## **Cấu hình SCIM với Okta**

#### <mark style="color:xanh dương;">Các yêu cầu bổ sung cho Okta</mark>

* Đặc quyền quản trị viên Okta với Truy cập vào Trình chỉnh sửa hồ sơ

#### <mark style="color:xanh dương;">Các giới hạn bổ sung trong Okta</mark>

* Khi người dùng thuộc nhiều nhóm cung cấp các giá trị xung đột cho cùng một thuộc tính, chỉ giá trị của nhóm có mức ưu tiên cao nhất được truyền đi. Xem Bước 5.

{% hint style="warning" %}
**Lưu ý: Hai hồ sơ, hai mục đích**

Okta duy trì hai hồ sơ riêng biệt có liên quan ở đây; hiểu rõ sự khác biệt này sẽ giúp tránh phần lớn nhầm lẫn ban đầu. Phần **Hồ sơ người dùng Okta** là nơi một giá trị được *lưu trữ* gắn với một người trong thư mục. **Hồ sơ ứng dụng người dùng Zoom** là nơi một giá trị được *được gửi* đến Zoom, và các thuộc tính của hồ sơ này chứa tên bên ngoài và không gian tên SCIM. Cấu hình cho từng người dùng cần cả hai hồ sơ, cùng với một ánh xạ để Kết nối chúng. Cấu hình ở cấp nhóm chỉ cần thuộc tính của hồ sơ ứng dụng, với giá trị được đặt khi gán nhóm.
{% endhint %}

### Bước 1: Khai báo thuộc tính trên hồ sơ người dùng của ứng dụng Zoom

Đây là thuộc tính thực sự truyền một giá trị tới Zoom. Việc khai báo nó là một thao tác chỉ thực hiện một lần cho mỗi thuộc tính.

1. Đăng nhập vào Bảng điều khiển quản trị Okta.
2. Trong menu điều hướng bên trái, nhấp vào **Ứng dụng**, sau đó nhấp vào **Ứng dụng**.
3. Trong mục **TRẠNG THÁI**, hãy nhấp vào **ĐANG HOẠT ĐỘNG**.
4. Nhấp vào **Zoom** ứng dụng.\
   **Lưu ý**: Tên ứng dụng do quản trị viên Okta xác định khi tạo ứng dụng. Tên này thường là **Zoom**, nhưng có thể khác trong tổ chức của bạn.
5. Nhấp vào **Cấp phát** thẻ.
6. Trong mục **Ánh xạ thuộc tính Zoom**, nhấp vào **Đi đến Trình chỉnh sửa hồ sơ**.
7. Trong mục **Thuộc tính**, nhấp vào **+ Thêm thuộc tính**.
8. Hoàn thành các mục sau:
   * **Kiểu dữ liệu**: Chọn **string** hoặc **boolean**, khớp với tài liệu tham khảo API SCIM2.
   * **Tên hiển thị**: Đi vào tên thuộc tính, ví dụ `zoomPhoneSite`.
   * **Tên biến**: Đi vào cùng một tên.
   * **Tên bên ngoài**: Đi vào tên thuộc tính chính xác như được Zoom ghi trong tài liệu, ví dụ `zoomPhoneSite`.
   * **Không gian tên bên ngoài**: Đi vào `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **Mô tả** (Tùy chọn): Ghi lại lý do thuộc tính này tồn tại và nguồn gốc các giá trị của nó.
   * **Loại thuộc tính**: Chọn **Cá nhân** cho giá trị riêng của từng người dùng hoặc **nhóm** cho giá trị được kế thừa thông qua tư cách thành viên của nhóm.
9. Nhấp vào **Lưu**, hoặc **Lưu và thêm mục khác**.

{% hint style="danger" %}
**Cảnh báo**

Tên bên ngoài và không gian tên bên ngoài đều phải chính xác. Hướng dẫn được Zoom công bố chỉ định không gian tên bên ngoài là URN đầy đủ *bao gồm* tên thuộc tính — ví dụ `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole` — thay vì chỉ dùng namespace. Điều này khác với quy ước SCIM chung. Hãy tuân theo định dạng được trình bày ở trên, vì định dạng đó phản ánh cấu hình mà Zoom xác nhận là hoạt động.

Tên thuộc tính phân biệt chữ hoa chữ thường trên toàn bộ hệ thống. Một thuộc tính viết sai hoa/thường vẫn được Trình chỉnh sửa hồ sơ chấp nhận mà không báo lỗi và thất bại âm thầm ở API Zoom.
{% endhint %}

### Bước 2: Tạo một thuộc tính nguồn trên hồ sơ người dùng Okta

Hoàn tất bước này khi giá trị được giữ theo từng người dùng. Bỏ qua bước này nếu giá trị giống nhau cho mọi người dùng, hoặc nếu thay vào đó nó sẽ được cung cấp ở cấp nhóm.

1. Trong menu điều hướng bên trái, hãy nhấp vào **Thư mục**, sau đó nhấp vào **Trình chỉnh sửa hồ sơ**.
2. Nhấp vào **Người dùng** thẻ.
3. Trong **Người dùng** hộp, bên dưới mục **Bộ lọc**, hãy nhấp vào **Tất cả**.
4. Ở bên phải **Okta**, nhấp vào **Người dùng** hồ sơ.
5. Trong mục **Thuộc tính**, nhấp vào **+ Thêm thuộc tính**.
6. Hoàn thành các mục sau:
   * **Loại dữ liệu**: Khớp với thuộc tính Zoom đã khai báo ở Bước 1.
   * **Tên hiển thị** và **Tên biến**: Nhập một tên, ví dụ `zoomPhoneSite`.
   * **Enum** (Tùy chọn): Chọn **Xác định danh sách giá trị được liệt kê** trong đó thuộc tính Zoom chỉ chấp nhận một tập hợp giá trị cố định.
   * **Thuộc tính bắt buộc** (Tùy chọn): Chọn **Có** trong đó mọi người dùng trong phạm vi đều phải có một giá trị.
7. Nhấp vào **Lưu**.

{% hint style="info" icon="lightbulb" %}
**Mẹo**

Sử dụng cùng một tên cho thuộc tính hồ sơ người dùng Okta và thuộc tính hồ sơ ứng dụng Zoom. Okta không yêu cầu điều này, nhưng các tên khớp nhau làm cho danh sách ánh xạ tự mô tả và giảm đáng kể thời gian khắc phục sự cố khi số lượng thuộc tính tăng lên.
{% endhint %}

Sử dụng **Enum** tùy chọn ở bất cứ nơi nào Zoom mô tả một tập giá trị cố định — các gói trung tâm liên hệ, mã gói Workplace và giá trị gói Revenue Accelerator. Việc giới hạn trường ngay tại thời điểm nhập giúp ngăn lỗi đánh máy gây ra lỗi cấp phát âm thầm, chỉ được phát hiện sau nhiều tuần khi thiếu quyền sử dụng.

### Bước 3: Ánh xạ thuộc tính nguồn với thuộc tính Zoom

1. Đi đến **Ứng dụng** → **Ứng dụng** → **Đang hoạt động** → ứng dụng **Zoom** .
2. Nhấp vào **Cấp phát** thẻ.
3. Trong mục **Ánh xạ thuộc tính Zoom**, tìm thuộc tính đã khai báo ở Bước 1 và nhấp vào biểu tượng chỉnh sửa ở bên phải thuộc tính đó.\
   **Lưu ý**: Nếu không thấy thuộc tính, hãy nhấp vào **Hiển thị các thuộc tính chưa ánh xạ**.
4. Nhấp vào **Giá trị thuộc tính** danh sách thả xuống và chọn **Ánh xạ từ hồ sơ Okta**.
5. Nhấp vào danh sách thả xuống nguồn — đang hiển thị `login | string` theo mặc định — và chọn thuộc tính hồ sơ người dùng Okta được tạo ở Bước 2.
6. Chọn **Tạo và cập nhật**.\
   **Lưu ý**: **Chỉ tạo** áp dụng giá trị khi người dùng Zoom được cấp quyền lần đầu và không áp dụng lại. Hãy chọn tùy chọn này một cách có cân nhắc cho các giá trị không nên bị ghi đè sau lần gán ban đầu; chọn **Tạo và cập nhật** trong mọi trường hợp khác để các thay đổi trong thư mục được đồng bộ.
7. Nhấp vào **Lưu**.
8. Lặp lại cho từng thuộc tính.

{% hint style="warning" %}
**Lưu ý: Suy diễn hoặc dịch một giá trị**

Khi giá trị Okta và giá trị Zoom không phải là cùng một chuỗi, trường **Giá trị thuộc tính** cũng chấp nhận Ngôn ngữ biểu thức Okta, hỗ trợ logic điều kiện và các hàm xử lý chuỗi. Cú pháp biểu thức và các hàm khả dụng có thể khác nhau tùy phiên bản Okta; hãy xác thực mọi biểu thức bằng một người dùng thử nghiệm duy nhất thông qua **Xem trước** trước khi áp dụng rộng rãi hơn, đồng thời tham khảo tài liệu Ngôn ngữ biểu thức hiện tại của Okta để biết các hàm được hỗ trợ.

Khi việc dịch là đơn giản và bộ giá trị nhỏ, việc định nghĩa giá trị Zoom trực tiếp trên thuộc tính Okta dưới dạng một danh sách liệt kê — hoặc sử dụng một thuộc tính cấp nhóm, như trong Bước 5 — thường dễ bảo trì hơn một biểu thức.
{% endhint %}

### Bước 4: Bật cấp phép cho ứng dụng

Các ánh xạ thuộc tính không có tác dụng cho đến khi các thao tác cấp phép tương ứng được Bật. Hãy Bật chúng trước khi gán các giá trị ở Bước 5.

1. Đi đến **Ứng dụng** → **Ứng dụng** → **Đang hoạt động** → ứng dụng **Zoom** .
2. Nhấp vào **Cấp phát** thẻ.
3. Trong mục **Cấp quyền cho ứng dụng**, hãy nhấp vào **Chỉnh sửa**.
4. Bật các cài đặt được mô tả bên dưới, sau đó nhấp vào **Lưu**.

| Cài đặt                            | Tác dụng                                                                                                                                                                          |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tạo người dùng**                 | Tạo hoặc liên kết một người dùng trong Zoom khi ứng dụng được gán cho một người dùng trong Okta.                                                                                  |
| **Cập nhật thuộc tính người dùng** | Cập nhật các thuộc tính của một người dùng trong Zoom khi ứng dụng được gán. Các thay đổi tiếp theo đối với hồ sơ người dùng Okta sẽ tự động ghi đè giá trị tương ứng trong Zoom. |
| **Hủy kích hoạt người dùng**       | Hủy kích hoạt Tài khoản Zoom  khi ứng dụng bị hủy gán trong Okta, hoặc khi tài khoản Okta bị hủy kích hoạt. Tài khoản có thể được kích hoạt lại bằng cách gán lại ứng dụng.       |

{% hint style="danger" %}
**Cảnh báo**

**Cập nhật thuộc tính người dùng** là tùy chọn giúp các ánh xạ thuộc tính tùy chỉnh có hiệu lực với những người dùng hiện có. Nếu không bật tùy chọn này, ánh xạ chỉ được áp dụng khi tạo người dùng; mọi thay đổi tiếp theo trong Okta sẽ không được đồng bộ sang Zoom.
{% endhint %}

### Bước 5: Chỉ định giá trị cho người dùng hoặc nhóm

**Để Chỉ định một giá trị cho một người dùng riêng lẻ:**

1. Điều hướng đến **Thư mục** → **Mọi người** và nhấp vào tên người dùng.
2. Nhấp vào **Hồ sơ** thẻ, sau đó nhấp vào **Chỉnh sửa**.
3. Điền thuộc tính được tạo ở Bước 2 bằng giá trị mà Zoom mong đợi.
4. Nhấp vào **Lưu**.

Giá trị được truyền đi ngay lập tức. Xác nhận kết quả trong Cổng thông tin web của Zoom trước khi áp dụng cùng một Thay đổi đó rộng rãi hơn.

**Để chỉ định một giá trị cho một nhóm** — mô hình có khả năng mở rộng cao hơn, trong đó cấu hình tuân theo cơ cấu tổ chức:

1. Xác nhận thuộc tính đã được khai báo ở Bước 1 với **Loại thuộc tính: Nhóm**. Nếu thuộc tính được khai báo là **Cá nhân**, hãy khai báo thuộc tính tương đương ở cấp nhóm bằng cách lặp lại Bước 1 trên hồ sơ **người dùng Zoom** trong **Danh bạ** → **Trình chỉnh sửa hồ sơ** → **Người dùng** → **Tất cả**, chọn **Nhóm** làm loại thuộc tính.
2. Đi đến **Danh bạ** → **Nhóm** → thẻ **Tất cả** , sau đó nhấp vào **Thêm nhóm**.
3. Điền **Tên** và **Mô tả**tùy chọn, sau đó nhấp vào **Lưu**.
4. Mở nhóm rồi nhấp vào thẻ **Ứng dụng** .
5. Nhấp vào **Chỉ định ứng dụng**, sau đó nhấp vào **Chỉ định** ở bên phải ứng dụng **Zoom** .
6. Điền các thuộc tính ở cấp độ nhóm bằng các giá trị sẽ áp dụng cho mọi Thành viên.
7. Nhấp vào **Lưu và quay lại**, sau đó nhấp vào **Xong**.
8. Nhấp vào thẻ **Mọi người** của nhóm, sau đó nhấp vào **Chỉ định mọi người**.
9. Tìm người dùng theo tên, địa chỉ email chính hoặc Tên người dùng, rồi nhấp vào nút Thêm bên cạnh từng mục.
10. Nhấp vào **Xong**.

Các Thành viên kế thừa tự động các giá trị thuộc tính của nhóm. Những người dùng được Thêm sau này sẽ kế thừa chúng khi tham gia, điều này khiến mô hình này bền vững cho Hướng dẫn nhập môn liên tục thay vì chỉ là một lần di chuyển dữ liệu.

#### <mark style="color:xanh dương;">Độ ưu tiên của nhóm giải quyết các giá trị xung đột khi một người dùng thuộc về nhiều nhóm</mark>

Khi một người dùng là Thành viên của hơn một nhóm cung cấp giá trị cho cùng một thuộc tính, Okta sẽ truyền giá trị từ nhóm có độ ưu tiên cao nhất.

1. Đi đến **Ứng dụng** → **Ứng dụng** → **Đang hoạt động** → ứng dụng **Zoom** .
2. Nhấp vào **Bài tập** thẻ.
3. Trong phần **Bộ lọc**, nhấp vào **Nhóm**.
4. Kéo và thả các nhóm vào thứ tự mong muốn.

{% hint style="info" %}
**Khuyến nghị**

Sắp xếp các nhóm từ cụ thể nhất đến tổng quát nhất, để một nhóm có phạm vi hẹp — một cơ sở hoặc Vai trò cụ thể — sẽ được ưu tiên hơn một lựa chọn bao quát chung. Việc đảo ngược thứ tự này khiến nhóm tổng quát ghi đè mọi nhóm cụ thể, điều này thường biểu hiện như toàn bộ nhóm người dùng nhận cùng một cấu hình ngoài ý muốn.
{% endhint %}

### Bước 6: Xác minh bằng Nhật ký hệ thống Okta

1. Điều hướng đến **Báo cáo** → **Nhật ký hệ thống**.
2. Lọc theo người dùng mục tiêu hoặc bằng ứng dụng Zoom, và thu hẹp khoảng thời gian đến lần thử cấp phát.
3. Mở Sự kiện liên quan và xem lại chi tiết, bao gồm kết quả và mọi lỗi do ứng dụng hạ nguồn trả về.

Các lỗi cấp phép chưa được xử lý cũng xuất hiện trong ứng dụng Zoom **Cấp phát** thẻ. Khi nhật ký Okta không đủ để kết luận, hãy chuyển sang nhật ký cuộc gọi của Zoom App Marketplace được mô tả trong **Xác minh ở phía Zoom và các lỗi thường gặp**, hiển thị quá trình trao đổi yêu cầu và phản hồi thô.

{% hint style="warning" %}
**Lưu ý: Lỗi im lặng đặc thù của Okta**

Một thuộc tính được khai báo trong hồ sơ người dùng Zoom nhưng chưa bao giờ được ánh xạ, hoặc được ánh xạ mà không **Cập nhật thuộc tính người dùng** được bật ở Bước 4, không truyền dữ liệu gì nhưng vẫn hiển thị trong danh sách ánh xạ. Không có lỗi nào được báo. Nếu một giá trị không đến được Zoom và Nhật ký hệ thống hoàn toàn không có sự kiện tương ứng, hãy kiểm tra ánh xạ và cài đặt cấp phát trước khi điều tra thêm.
{% endhint %}

#### <mark style="color:xanh dương;">Hành vi Hướng dẫn nhập môn và rời hệ thống trong Okta</mark>

* Phạm vi là điều khiển an toàn chính. Những người dùng không được gán ứng dụng Zoom trong Okta sẽ không bao giờ bị sửa đổi bởi bất kỳ ánh xạ nào trong cấu hình này.
* Với **Vô hiệu hóa người dùng** được bật, việc hủy gán ứng dụng hoặc vô hiệu hóa tài khoản Okta sẽ tự động vô hiệu hóa Tài khoản Zoom.
* Gán lại ứng dụng sẽ kích hoạt lại một Tài khoản Zoom đã bị vô hiệu hóa trước đó, điều này khiến tư cách thành viên nhóm trở thành một cơ chế khả thi để quản lý những người rời đi và quay lại.

### Bước 7: Áp dụng các kịch bản tham chiếu trong Okta

Các tình huống, điều kiện tiên quyết và định nghĩa thuộc tính nằm trong phần [**Các tình huống tham khảo**](#reference-scenarios) Chỉ có cấu hình Okta được trình bày tại đây.

**Tình huống 0 — Phòng ban.** Ở Bước 1, khai báo thuộc tính bằng **Tên hiển thị** và **Tên biến** `department`, **Tên bên ngoài** `department`, và **Không gian tên bên ngoài** `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`. Sử dụng **Loại thuộc tính: Cá nhân**. Hồ sơ người dùng cơ bản của Okta đã có sẵn một `department` thuộc tính, vì vậy có thể bỏ qua Bước 2 — ánh xạ trực tiếp từ thuộc tính đó ở Bước 3, bằng cách chọn **Tạo và cập nhật**.

{% hint style="warning" %}
**Lưu ý: Định dạng namespace cho các thuộc tính phần mở rộng doanh nghiệp**

CẢNH BÁO ở Bước 1 mô tả quy ước của Zoom về việc thêm tên thuộc tính vào namespace External. Hướng dẫn đó được ghi lại dành cho các thuộc tính trong phần mở rộng Zoom. `department` thuộc phần mở rộng doanh nghiệp SCIM tiêu chuẩn, trong đó hành vi thông thường của Okta là giữ không gian tên và tên bên ngoài trong các trường riêng biệt, như minh họa ở trên. Nếu giá trị không đến được Zoom, hãy thử dạng nối thêm — `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` — và xác nhận biểu mẫu nào đã thành công trong nhật ký cuộc gọi của Marketplace.
{% endhint %}

**Các lựa chọn thay thế nếu `department` đã được ánh xạ.** Bất kỳ mục nào sau đây cũng hoạt động giống hệt nhau, nằm dưới cùng một phần tử cha và không có điều kiện tiên quyết — hãy thay tên thuộc tính trong cả hai **Tên bên ngoài** và không gian tên, đồng thời Thêm một thuộc tính nguồn tương ứng ở Bước 2 nếu hồ sơ Okta chưa có thuộc tính đó:

| Thuộc tính       | Ghi chú                                                                                                                                                                                       |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `costCenter`     | Trường Kinh doanh, khác nhau giữa các người dùng nên giá trị sai sẽ hiển thị                                                                                                                  |
| `Tổ chức`        | Thường giống hệt trên tất cả người dùng, khiến lỗi khó nhận ra hơn                                                                                                                            |
| `employeeNumber` | Thường đã được ánh xạ như một trường định danh — kiểm tra trước khi khai báo                                                                                                                  |
| `pronouns`       | Thuộc phần mở rộng **Zoom** thay vì phần mở rộng doanh nghiệp, nên sử dụng cùng không gian tên với mọi trường hợp khác trong hướng dẫn này và hoàn toàn tránh được vấn đề về định dạng ở trên |

**Trường hợp 1 — cơ sở Zoom Phone và số máy nhánh tự động.** Khai báo `zoomPhoneSite` với **Loại thuộc tính: nhóm** và đặt giá trị của thuộc tính này trên nhóm Okta của từng cơ sở, để tư cách thành viên nhóm trực tiếp xác định cơ sở mà không cần logic chuyển đổi. Khai báo `zoomPhoneExtNumber` là thuộc tính cá nhân có giá trị mặc định là `0` trừ khi bạn đang di chuyển cấu hình số máy nhánh đã có.

**Trường hợp 2 — gói cuộc gọi thay đổi theo quốc gia.** Khai báo `zoomPhoneCallingPlan` với **Loại thuộc tính: nhóm** và tạo một nhóm cho mỗi khu vực của gói cuộc gọi, đặt giá trị gói trong phần gán ứng dụng Zoom của từng nhóm. Người dùng kế thừa đúng gói thông qua tư cách thành viên, và giá trị lưu trong Okta chính là giá trị mà Zoom mong đợi. Cách này cũng giúp cấu hình hiển thị và có thể kiểm tra được từ **Phân công** thẻ, đồng thời không bị ảnh hưởng bởi những điểm không nhất quán trong cách dữ liệu thư mục cơ sở được nhập. Một nhóm mang `-1` cung cấp cách thức rõ ràng để thu hồi quyền sử dụng cuộc gọi mà không xóa người dùng.

**Trường hợp 3 — Gói, Vai trò và khu vực của trung tâm liên hệ.** Khai báo `zoomContactCenterPackage` là thuộc tính liệt kê, giới hạn ở ba giá trị được phép, để không thể nhập Gói không hợp lệ. Khai báo `zoomContactCenterRole` là thuộc tính cấp nhóm, vì Vai trò thường dựa theo cơ cấu nhóm làm việc. Để `zoomContactCenterRegion` không được ánh xạ trong các triển khai một khu vực.

## Khắc phục sự cố

### Lỗi

#### <mark style="color:xanh dương;">Người dùng không tồn tại hoặc không thuộc tài khoản này</mark>

Lỗi này xảy ra khi không thể cấp quyền cho người dùng mục tiêu bằng địa chỉ email của họ vì tài khoản đã tồn tại. Quản trị viên Zoom nên liên hệ trực tiếp với người dùng và mời thủ công người dùng vào tài khoản.

<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>Ví dụ về lỗi cấp quyền.</p></figcaption></figure></div>

#### <mark style="color:xanh dương;">Bạn không thể thêm người dùng trả phí</mark>

Lỗi này xảy ra khi SCIM cố cấp quyền cho người dùng nhưng tài khoản không có đủ giấy phép. Để khắc phục lỗi, cần cấp quyền cho người dùng với tư cách người dùng cơ bản hoặc bổ sung giấy phép để có thể cấp quyền.

<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>Ví dụ về lỗi cấp quyền.</p></figcaption></figure></div>

### Sử dụng nhật ký SCIM để khắc phục sự cố cấp quyền cho người dùng

Zoom cung cấp 100 nhật ký yêu cầu API gần đây nhất trong [Zoom Marketplace](https://marketplace.zoom.us/). Quản trị viên Zoom có thể dùng các nhật ký này để xác nhận thông tin nào đang được gửi và nhận thông qua các API cấp quyền. Để truy cập nhật ký, hãy đăng nhập vào Zoom Marketplace với tư cách quản trị viên Zoom rồi nhấp vào **Quản lý**. Trên trang tiếp theo, hãy chọn **Nhật ký cuộc gọi** trong mục **Quản lý ứng dụng cá nhân**. Tại đó, hãy nhấp vào một mục để mở rộng nhật ký API và xem nội dung.

Hình ảnh sau đây minh họa một yêu cầu cấp quyền cho người dùng SCIM, trong đó danh tính người dùng và các thuộc tính giấy phép được tô sáng để tham khảo.

<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>Ví dụ về yêu cầu cấp quyền cho người dùng SCIM.</p></figcaption></figure></div>

Tương tự như ánh xạ phản hồi, Zoom chỉ có thể áp dụng thông tin được nhà cung cấp danh tính gửi trong yêu cầu cấp quyền. Hãy dùng các nhật ký này để xác nhận rằng nhà cung cấp danh tính đang gửi các thuộc tính danh tính và giấy phép của người dùng. Nếu thiếu thông tin mong đợi trong các xác nhận này, hãy liên hệ với nhà cung cấp danh tính để được hỗ trợ.


---

# 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/vi/goc-quan-tri-vien/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.
