Chuyển đến nội dung chính
SCIM (System for Cross-domain Identity Management) cho phép nhà cung cấp danh tính (IdP) của bạn, như Okta hoặc Microsoft Entra ID, quản lý tài khoản CloudThinker thay bạn. Gán một người vào ứng dụng CloudThinker trong IdP là người đó tham gia tổ chức của bạn; bỏ gán là quyền truy cập của họ chấm dứt, không cần mời hay gỡ thủ công.

Điều kiện tiên quyết

  • Một tổ chức dùng gói Scale hoặc Enterprise. Xem Bảng giá.
  • Một kết nối SSO đang hoạt động với domain đã xác minh. Cài đặt cấp phát chỉ xuất hiện khi SSO đã hoạt động.
  • Vai trò Owner của tổ chức trong CloudThinker. Admin không quản lý được SSO hay SCIM. Xem Vai trò và quyền.
  • Quyền admin với cài đặt cấp phát (provisioning) của ứng dụng CloudThinker trong IdP.

SCIM thay đổi những gì trong CloudThinker

Gán trong IdP làm thành viên chuyển sang Active; vô hiệu hóa hoặc bỏ gán sẽ tạm ngưng họ; kích hoạt lại sẽ khôi phục họ cùng các workspace được tự động gán; SCIM DELETE xóa họ. Các nhóm được đẩy sang ánh xạ tới workspace và chỉ thêm quyền truy cập.Gán trong IdP làm thành viên chuyển sang Active; vô hiệu hóa hoặc bỏ gán sẽ tạm ngưng họ; kích hoạt lại sẽ khôi phục họ cùng các workspace được tự động gán; SCIM DELETE xóa họ. Các nhóm được đẩy sang ánh xạ tới workspace và chỉ thêm quyền truy cập.

Bỏ gán sẽ tạm ngưng thành viên; chỉ SCIM DELETE mới xóa họ, và ánh xạ nhóm chỉ thêm quyền truy cập.

Bỏ gán một người khỏi ứng dụng thường được tính là vô hiệu hóa, không phải xóa. Cả Okta và Microsoft Entra ID đều gửi active=false khi bạn bỏ gán user, nên người đó bị tạm ngưng trong CloudThinker chứ không bị gỡ. Họ chỉ bị gỡ khi IdP gửi DELETE. Khi SCIM đang bật, IdP là nguồn sự thật về việc ai thuộc tổ chức:
  • Lời mời thành viên bị tắt. Mời từ CloudThinker sẽ trả về “Member invitations are disabled because this organization uses SCIM provisioning.”
  • Bạn không gỡ được thành viên do SCIM cấp phát trong CloudThinker. Thông báo lỗi là “This member was provisioned via SCIM.” Hãy gỡ họ trong IdP.
  • Cấp phát just-in-time bị tắt. SCIM và just-in-time (tài khoản được tạo ở lần đăng nhập SSO đầu tiên) không chạy cùng nhau được. Bật SCIM sẽ tự tắt just-in-time. Người thuộc domain của bạn mà IdP chưa cấp phát sẽ bị từ chối khi đăng nhập SSO với thông báo “No account found. Contact your administrator for access.” cho tới khi IdP cấp phát cho họ.
Bạn vẫn đổi được vai trò hoặc quyền truy cập workspace của thành viên trong CloudThinker. Xem Tổ chức.

Bật SCIM trong CloudThinker

1

Mở cài đặt cấp phát

Vào Admin Settings → Identity and access và tìm thẻ Provisioning & directory sync bên dưới kết nối SSO.Nếu không thấy thẻ, kết nối SSO của bạn chưa hoạt động. Hãy hoàn tất thiết lập SSO trước.
2

Chọn SCIM

Chọn SCIM (Sync users and groups from your identity provider). Các lựa chọn khác là Manual (bạn tự mời người dùng) và Just-in-time (tài khoản được tạo ở lần đăng nhập SSO đầu tiên).Trạng thái thành công: hộp thoại SCIM enabled mở ra.
3

Sao chép hai giá trị

Hộp thoại hiển thị:
  • Bearer token: thông tin bí mật mà IdP gửi để chứng minh request của mình được phép.
  • SCIM base URL: endpoint mà IdP gọi tới. URL có dạng https://<your-cloudthinker-host>/api/v1/scim/<organization-id>/v2.
Sao chép cả hai, rồi nhấn Done.Trạng thái thành công: thẻ hiển thị Directory sync (SCIM) kèm “SCIM directory sync is active.”
Bearer token chỉ hiển thị một lần. Nếu bạn đóng hộp thoại mà chưa sao chép, hãy nhấn Rotate token để lấy token mới.

Đặt giá trị mặc định cho thành viên mới

Bên dưới các lựa chọn cấp phát, hai cài đặt quyết định người mới được cấp phát sẽ nhận được gì. Hãy đặt trước khi IdP gửi những user đầu tiên. Không gán được Owner theo cách này. Để biết mỗi vai trò làm được gì, xem Vai trò và quyền.

Cấu hình nhà cung cấp danh tính

Dùng ứng dụng CloudThinker bạn đã tạo cho SSO.
1

Bật SCIM trên ứng dụng

Mở ứng dụng CloudThinker. Trên tab General, nhấn Edit trong App Settings, đặt Provisioning thành SCIM rồi lưu.
2

Nhập thông tin kết nối

Trên Provisioning → Integration, nhấn Edit:Nhấn Test Connector Configuration, rồi Save.
3

Bật các hành động To App

Trên Provisioning → To App, nhấn Edit và bật Create Users, Update User Attributes và Deactivate Users. Lưu lại.
4

Push nhóm

Trên tab Push Groups, thêm các nhóm bạn muốn ánh xạ tới workspace.
CloudThinker đọc các thuộc tính sau: Trạng thái thành công: gán một user thử nghiệm vào ứng dụng. Trong khoảng thời gian đồng bộ của IdP, user đó xuất hiện trong Admin Settings → Organization → Members, và View sync logs hiển thị một mục CREATE có trạng thái SUCCESS. Những gì SCIM API của CloudThinker hỗ trợ, để bạn khớp với các tùy chọn của IdP:
Nếu ai đó đã có tài khoản CloudThinker từ tổ chức khác, CloudThinker chỉ thêm tài khoản sẵn có đó vào tổ chức của bạn khi domain email của tài khoản thuộc các domain SSO đã xác minh của bạn. Nếu không, IdP nhận được “User email domain not verified for this organization.”

Ánh xạ nhóm tới workspace

Nhóm cho phép một thay đổi trong IdP đưa cả một đội vào đúng các workspace.
1

Push nhóm từ IdP

Trong IdP, gán các nhóm vào ứng dụng CloudThinker và push nhóm.Trạng thái thành công: mỗi nhóm xuất hiện trong Group mappings trên Admin Settings → Identity and access, kèm Group name và số Members. Trước đó, mục này hiển thị “No groups synced yet.”
2

Chọn workspace cho từng nhóm

Trên dòng của nhóm, mở Auto-assigned workspaces và chọn các workspace mà thành viên nhóm sẽ tham gia.
3

Chọn vai trò của nhóm

Đặt Auto-assigned organization role cho nhóm, hoặc giữ Inherit from connection để dùng vai trò mặc định bạn đã đặt ở trên.CloudThinker đặt vai trò tổ chức của thành viên một lần duy nhất, khi tạo thành viên. Các lần đồng bộ sau không thay đổi vai trò này, nên vai trò bạn tự đổi trong CloudThinker sẽ được giữ nguyên.
4

Lưu dòng

Nhấn Save trong cột Actions.Trạng thái thành công: thành viên hiện tại của nhóm được thêm vào các workspace đã chọn, còn thành viên tương lai được thêm khi IdP đồng bộ họ vào nhóm.
Ánh xạ nhóm chỉ thêm quyền truy cập workspace. Gỡ một người khỏi nhóm, hoặc gỡ một workspace khỏi ánh xạ, không đưa họ ra khỏi workspace đó. Hãy gỡ họ trong thành viên workspace, hoặc bỏ gán họ khỏi ứng dụng trong IdP để gỡ khỏi mọi nơi.
Sau lần đồng bộ đầu tiên, hãy kiểm tra vai trò của các thành viên mới trong Admin Settings → Organization → Members và điều chỉnh những vai trò cần khác đi.

Điều gì xảy ra khi một người rời đi

Automation không bao giờ tự đổi chủ sở hữu. Admin của workspace có thể chọn Take ownership trên trang của automation, và automation vẫn tắt cho tới khi họ bật lại. Xem chủ sở hữu automation.
Nếu gói của bạn tính phí theo seat và mọi seat đã được dùng hết, người mới được cấp phát hoặc được kích hoạt lại sẽ được thêm ở trạng thái inactive và chưa dùng được CloudThinker. Thành viên đang hoạt động và lời mời đang chờ đều chiếm seat; thành viên bị tạm ngưng và inactive thì không. Owner thêm seat trên Admin Settings → Billing; xem Thêm hoặc bớt seat. Sau đó kiểm tra trạng thái của họ trong Admin Settings → Organization → Members.

Xoay vòng hoặc tắt token

Xoay vòng token khi token có thể đã bị lộ hoặc chính sách của bạn yêu cầu:
1

Xoay vòng

Trong Directory sync (SCIM), nhấn Rotate token, rồi nhấn Rotate trong hộp xác nhận.Trạng thái thành công: một hộp thoại hiển thị Bearer token mới và SCIM base URL. Token cũ vẫn hoạt động trong 24 giờ.
2

Cập nhật IdP

Dán token mới vào cài đặt cấp phát của IdP và kiểm tra kết nối. Hãy làm trong vòng 24 giờ, nếu không các lượt đồng bộ sẽ bắt đầu thất bại với lỗi xác thực.
Tắt SCIM bằng cách chọn Manual hoặc Just-in-time trong Provisioning & directory sync, rồi chọn Disable SCIM trong hộp xác nhận. Thao tác này thu hồi token ngay lập tức và dừng đồng bộ thư mục. Thành viên hiện có vẫn giữ tài khoản, và từ đó bạn quản lý họ trong CloudThinker. Hãy tắt cả cấp phát trong IdP, nếu không IdP sẽ tiếp tục gửi các request thất bại. Các thay đổi token (tạo, xoay vòng, thu hồi) và mọi user hay nhóm mà SCIM cấp phát, cập nhật hoặc gỡ bỏ đều được ghi vào nhật ký kiểm toán.

Kiểm tra hoạt động đồng bộ

Nhấn View sync logs trong Directory sync (SCIM) để mở SCIM sync logs. Mỗi ngày một lần, CloudThinker còn kiểm tra những người do SCIM cấp phát mà không có hoạt động đồng bộ nào trong 7 ngày, và thêm một mục UPDATE có trạng thái SKIPPED cho từng người. Đây chỉ là lời nhắc: CloudThinker không thay đổi quyền truy cập của họ. Hãy kiểm tra người đó còn được gán trong IdP không, và bỏ gán tại đó nếu họ đã rời đi.

Khắc phục sự cố

Thẻ chỉ hiển thị khi kết nối SSO đã hoạt động. Hãy hoàn tất thiết lập SSO, kể cả xác minh domain. Bạn cũng cần vai trò Owner.
CloudThinker không tự kéo nhóm về; IdP phải push nhóm sang. Gán các nhóm vào ứng dụng CloudThinker trong IdP, chạy push, rồi tìm các mục Group trong View sync logs.
Xác nhận user đã được gán vào ứng dụng CloudThinker trong IdP, rồi tìm mục FAILED trong sync log. Nguyên nhân thường gặp: token đã được xoay vòng hơn 24 giờ trước hoặc đã bị thu hồi, tài khoản sẵn có của người đó dùng domain email chưa xác minh (“User email domain not verified for this organization”), hoặc email được dành riêng cho một tài khoản nội bộ của CloudThinker (“This email belongs to a CloudThinker System user”). Với trường hợp cuối, hãy dùng email khác hoặc liên hệ đội hỗ trợ.
Bỏ gán hoặc vô hiệu hóa họ ngay trên ứng dụng CloudThinker. Gỡ họ khỏi một nhóm chỉ thay đổi tư cách thành viên nhóm. Một số IdP đồng bộ theo lịch (Microsoft Entra ID chạy khoảng 40 phút một lần), nên hãy chờ chu kỳ tiếp theo và kiểm tra sync log.
Token trong IdP không còn hợp lệ: token đã được xoay vòng hơn 24 giờ trước, hoặc SCIM đã bị tắt. Nhấn Rotate token và dán giá trị mới vào IdP. Nếu SCIM đã bị tắt, hãy chọn lại SCIM để lấy token mới.
Just-in-time và SCIM không chạy cùng nhau được. Chọn Just-in-time trong Provisioning & directory sync và xác nhận Disable SCIM, thao tác này thu hồi token và dừng đồng bộ thư mục.
Đây là hành vi bình thường khi SCIM đang bật. Hãy gán hoặc bỏ gán người dùng trong IdP.

Bước tiếp theo

Vai trò và quyền

Chọn vai trò mặc định phù hợp cho thành viên được cấp phát.

Thành viên workspace

Tinh chỉnh ai được mở từng workspace.

Nhật ký kiểm toán

Xem lại các thay đổi token và việc thu hồi cấp phát.

Đăng nhập một lần

Thay đổi kết nối SSO hoặc các domain đã xác minh.