Cấp phát người dùng từ Okta bằng SCIM
SCIM 2.0 cho phép Okta tạo, cập nhật, khóa và gỡ người trong tổ chức Tara của bạn, và đặt role theo nhóm Okta. SCIM không đăng nhập thay ai: mọi người vẫn đăng nhập bằng SSO của tổ chức (OIDC), nên hãy cài SSO trước.
SCIM chỉ có ở gói Enterprise. Ở Free và Team, owner không tạo được token SCIM; nếu tổ chức mất tính năng này, mọi lệnh SCIM nhận 403 kèm câu nêu rõ gói (IdP không hiểu mã 402 Payment Required nên Tara dùng 403 ở đây).
Bạn phải là owner của tổ chức. Chỉ owner tạo được token SCIM và ánh xạ nhóm sang role.
Trong Tara
- Mở Settings › SSO, tìm mục SCIM provisioning. Tạo một token và đặt tên. Sao chép token (bắt đầu bằng
tara_scim_); token chỉ hiện một lần. - Sao chép base URL:
https://<máy chủ Tara>/scim/v2/orgs/<slug tổ chức>. - Nên làm: ánh xạ tên nhóm Okta sang role (xem Nhóm và role).
Trên terminal:
ph org scim-token create okta --out scim-token.txt
ph org scim-roles set '{"Engineering":"member","Platform":"admin","Stakeholders":"viewer"}'Token có hạn 365 ngày theo mặc định (tối đa 730), chỉ thuộc tổ chức này và chỉ gọi được /scim/v2/orgs/<slug tổ chức>/…. Mỗi tổ chức có tối đa 10 token còn hiệu lực, nên khi xoay vòng bạn tạo token thứ hai trước rồi mới thu hồi token cũ.
Trong Okta
Tên các mục dưới đây là tên Okta thường hiện; giữa các ứng dụng và phiên bản có thể lệch đôi chút.
- Trong Okta Admin Console, thêm một app integration hỗ trợ provisioning SCIM 2.0 với xác thực HTTP Header. Danh mục của Okta có ứng dụng SCIM 2.0 chung cho kiểu này; dùng nó, hoặc app integration SCIM của bạn.
- Mở tab Provisioning của ứng dụng và chọn cấu hình tích hợp API (SCIM).
- SCIM connector base URL: base URL từ Tara.
- Unique identifier field for users:
userName. - Supported provisioning actions: bật Push New Users, Push Profile Updates và Push Groups. Okta vô hiệu hóa người dùng khi họ bị gỡ khỏi ứng dụng hoặc bị deactivate; hãy bảo đảm ứng dụng được phép deactivate người dùng.
- Authentication Mode: HTTP Header. Dán token vào ô authorization. Tara chỉ nhận
Authorization: Bearer <token>. Nếu Okta gửi nguyên văn giá trị ô này, hãy nhậpBearerrồi đến token. - Chọn Test Connector Configuration. Okta gọi base URL; kết quả xanh nghĩa là token và URL đúng. Lưu lại.
- Ở phần cài đặt provisioning To App, bật Create Users, Update User Attributes và Deactivate Users.
- Thuộc tính username của Okta được ánh xạ sang
userNamephải là email công việc của người đó, và thuộc tính email phải được ánh xạ. Tara gắn người theo email này. - Gán người và nhóm vào ứng dụng. Muốn đẩy nhóm, dùng tab Push Groups của ứng dụng.
Tara chỉ đọc các thuộc tính này của người dùng: userName, externalId, name (tên, họ, tên đầy đủ), displayName, email công việc trong emails và active. Thuộc tính khác Okta gửi (chức danh, số điện thoại...) được nhận rồi bỏ qua, nên ánh xạ thừa không gây hại.
Chuyện gì xảy ra
- Một người được gán vào ứng dụng. Okta tạo họ trong Tara. Nếu đã có người có tài khoản Tara với đúng email đã xác minh đó, họ được gắn ngay và thành thành viên. Nếu chưa, Tara giữ chỗ chờ theo email.
- Lần đăng nhập đầu. Khi người đó đăng nhập bằng SSO của tổ chức và email từ Okta khớp, Tara gắn tài khoản của họ rồi cho họ vào tổ chức với role theo nhóm.
- Okta deactivate một người. Tara gỡ họ khỏi tổ chức và các project, họ không tốn seat, và đăng nhập SSO hay tự vào theo tên miền không đưa họ vào lại được. Nếu bạn kích hoạt lại trong Okta, tư cách thành viên quay lại.
- Okta xóa một người. Tara gỡ họ khỏi tổ chức. Tài khoản Tara của họ không bị xóa.
- Owner không bao giờ bị đụng đến. SCIM không tạo, không đổi, không gỡ owner.
Nhóm và role
scimGroupRoles ánh xạ tên nhóm sang admin, member hoặc viewer (không bao giờ owner). Tên nhóm không phân biệt hoa thường.
- Người thuộc nhiều nhóm có ánh xạ nhận role cao nhất.
- Chưa đặt ánh xạ nào: mọi người được cấp phát đều là member.
- Đã đặt ánh xạ nhưng người đó không thuộc nhóm nào có ánh xạ: họ là viewer (miễn phí, không tốn seat).
- Người bạn thêm bằng tay hoặc bằng lời mời giữ nguyên role bạn đã cho. SCIM chỉ đổi role của thành viên vào bằng cách khác.
- Bạn đổi ánh xạ thì Tara cập nhật role của mọi người đã được gắn.
Seat và giới hạn
Admin và member tốn seat; viewer thì không. Hết seat theo gói, Okta nhận 409 với Seat limit reached trong phần chi tiết lỗi và báo thành lỗi provisioning. Người đã được cấp phát vẫn giữ quyền. Hãy cho người mới role viewer qua một nhóm ánh xạ sang viewer, hoặc nâng gói (Thanh toán và nâng gói).
Kiểm tra kết quả
Mở Audit log trong Tara và tìm các hành động:
| Hành động | Ý nghĩa |
|---|---|
scim.user.create | Okta tạo một người |
scim.user.link | Đã gắn với tài khoản Tara (verified_email hoặc oidc_login) |
scim.user.role | Thêm tư cách thành viên hoặc đổi role |
scim.user.suspend, scim.user.reactivate | Okta deactivate hoặc kích hoạt lại |
scim.user.delete | Okta xóa người |
scim.group.create, scim.group.update, scim.group.delete | Thay đổi nhóm |
scim.group.roles | Owner lưu ánh xạ nhóm sang role |
scim_token.create, scim_token.revoke | Owner tạo hoặc thu hồi token |
Khi có lỗi
| Bạn thấy | Nguyên nhân |
|---|---|
401 | Token sai, hết hạn hoặc đã thu hồi, hoặc header không phải Bearer <token>. |
403 | Token thuộc tổ chức khác (kiểm tra slug trong URL), hoặc dùng credential không phải token SCIM. |
404 | Sai đường dẫn. Base URL phải kết thúc bằng slug tổ chức, không có /Users. |
409 kèm uniqueness | Người khác trong tổ chức đã có userName, email hoặc externalId đó. |
409 kèm Seat limit reached | Hết seat cho role này. Xem phần trên. |
400 kèm invalidFilter | Okta dùng filter Tara không hỗ trợ. Tara hỗ trợ eq trên userName, externalId, id, active và email công việc cho người dùng, và trên displayName, externalId, id cho nhóm. |
scim_suspended lúc đăng nhập | Người đó đang bị deactivate trong Okta. |
Giới hạn
- Không có bulk, sort, ETag và thao tác mật khẩu.
- Filter chỉ có toán tử
eq. - Thuộc tính enterprise extension không được lưu.
Endpoint của Tara tự mô tả ở /scim/v2/orgs/<slug tổ chức>/ServiceProviderConfig.
Dùng Microsoft Entra ID? Xem Cấp phát người dùng từ Microsoft Entra ID bằng SCIM.