Thiết lập SAML SSO

Đăng nhập một lần (SSO) cho phép nhóm của bạn đăng nhập vào Kliv bằng tài khoản họ đã sử dụng tại nơi làm việc — thông qua nhà cung cấp danh tính của công ty bạn (dịch vụ quản lý thông tin đăng nhập của nhân viên, như Okta hoặc Microsoft Entra). Không có mật khẩu Kliv riêng biệt để quản lý và khi ai đó rời đi, việc xóa họ ở một nơi cũng sẽ xóa quyền truy cập của họ vào đây.

SAML là cách được hỗ trợ rộng rãi nhất để kết nối nhà cung cấp danh tính. Trang này sẽ hướng dẫn bạn cách thiết lập, kiểm tra nó bằng thông tin đăng nhập thực sự và bật nó — theo thứ tự đó, để nhóm của bạn không bị gián đoạn.

Bạn tự cấu hình tất cả những điều này. Không cần ticket hỗ trợ và không cần gọi điện cho nhà cung cấp.

Trước khi bạn bắt đầu

  • Bạn cần có tài khoản quản trị viên có quyền quản lý đăng nhập một lần cho tổ chức của mình.
  • Bạn sẽ cần quyền truy cập vào bảng quản trị của nhà cung cấp danh tính của mình (Okta, Entra, Google Workspace, OneLogin hoặc nhà cung cấp SAML khác).
  • Có một miền mà bạn có thể xác minh — miền email mà nhóm của bạn đăng nhập bằng (ví dụ: yourcompany.com).

Mở trình hướng dẫn thiết lập

  1. Đi tới Quản lý người dùng → Đăng nhập một lần.
  2. Chọn Thiết lập đăng nhập một lần.
  3. Chọn nhà cung cấp của bạn — Okta, Microsoft Entra, Google, OneLogin hoặc Other. Việc chọn một nhà cung cấp đã biết sẽ điền trước các cài đặt phù hợp để bạn phải sao chép thủ công ít hơn.
  4. Để nguyên giao thức ở SAML (mặc định). OIDC là một giải pháp thay thế nâng cao - xem Thiết lập OIDC SSO.

Trao đổi cài đặt với nhà cung cấp danh tính của bạn

SSO hoạt động dựa trên nhà cung cấp danh tính của bạn và Kliv tin tưởng lẫn nhau. Bạn cung cấp cho mỗi người một vài chi tiết về người kia:

  1. Kliv hiển thị cho bạn các giá trị mà nhà cung cấp của bạn cần (chẳng hạn như URL đăng nhập Kliv lắng nghe). Sao chép chúng vào ứng dụng SAML mới trong bảng quản trị của nhà cung cấp của bạn.
  2. Nhà cung cấp của bạn sẽ cung cấp lại cho bạn thông tin chi tiết của chính họ — thường là URL siêu dữ liệu hoặc tệp XML, cùng với chứng chỉ ký. Dán siêu dữ liệu (hoặc tải tệp lên) vào Kliv.
  3. Đảm bảo nhà cung cấp của bạn gửi số nhận dạng ổn định cho mỗi người dùng chứ không chỉ địa chỉ email. (Thuộc tính chính xác dành riêng cho nhà cung cấp — bản cấu hình có sẵn sẽ nêu tên thuộc tính cần dùng; xác nhận từ ngữ trong bảng điều khiển của bạn.) Đây là giá trị mà Kliv sử dụng để nhận dạng người quay lại ngay cả khi email của họ thay đổi.

Kliv lưu nội dung này dưới dạng bản nháp. Bản nháp đã được cấu hình nhưng chưa hoạt động — nhóm của bạn vẫn đăng nhập theo cách họ thực hiện hiện nay cho đến khi bạn hoàn thành.

Xác minh miền của bạn

Trước khi Kliv tạo tài khoản từ nhà cung cấp của bạn, bạn phải chứng minh rằng bạn kiểm soát miền email mà nhóm của bạn sử dụng. Điều này ngăn cản bất kỳ ai xác nhận quyền sở hữu miền không phải của họ.

Theo dõi Xác minh miền của bạn để thêm một bản ghi DNS hoặc một tệp vào trang web của bạn. Hãy quay lại đây khi nó hiển thị Đã xác minh.

Kiểm tra bằng đăng nhập thực sự

Đây là bước giúp SSO bật an toàn: bạn chứng minh rằng toàn bộ hành trình khứ hồi đều hoạt động trước khi nó ảnh hưởng đến bất kỳ ai.

  1. Trong trình hướng dẫn, chọn Kiểm tra đăng nhập.
  2. Bạn sẽ được gửi đến nhà cung cấp danh tính của mình để đăng nhập, chính xác như nhóm của bạn sẽ làm.
  3. Nếu thành công, Kliv ghi lại quá trình kiểm tra thành công và bật nút Bật.
  4. Nếu không thành công, Kliv sẽ hiển thị cho bạn những gì nó mong đợi so với những gì nhà cung cấp của bạn thực sự đã gửi - xem Khắc phục sự cố đăng nhập SSO không thành công. Sửa nó trong nhà cung cấp của bạn và kiểm tra lại.

Bạn không thể bật SSO cho đến khi đăng nhập thử nghiệm thành công đối với cấu hình chính xác mà bạn sắp kích hoạt. Chỉ lưu đơn thuần thì không bao giờ đủ.

Bật nó lên

Khi quá trình kiểm tra đã vượt qua, hãy chọn Bật. Từ giờ trở đi, khi ai đó nhập địa chỉ email trên miền đã xác minh của bạn, Kliv sẽ gửi họ đến nhà cung cấp danh tính của bạn để đăng nhập. Những người đăng nhập lần đầu tiên sẽ tự động tạo tài khoản Kliv với quyền truy cập tiêu chuẩn của thành viên.

Thành viên mới chỉ có mặt trong nhóm everyone của bạn. Họ không nhận được vai trò quản trị viên hoặc bất kỳ vai trò nâng cao nào từ nhà cung cấp danh tính của bạn trừ khi bạn cố tình thiết lập vai trò đó — xem Ánh xạ các nhóm IdP thành các vai trò Kliv.

Sau khi thiết lập

Trang Đăng nhập một lần của bạn hiện hiển thị thẻ trạng thái thay vì trình hướng dẫn: nhà cung cấp, miền đã xác minh của bạn, lần đăng nhập thành công gần đây nhất và cảnh báo nếu chứng chỉ ký của bạn sắp hết hạn. Hãy chú ý cảnh báo đó — chứng chỉ đã hết hạn sẽ ngừng đăng nhập cho đến khi bạn tải lên chứng chỉ mới.

Để yêu cầu mọi người trên miền của bạn sử dụng SSO (và duy trì cách đăng nhập an toàn nếu miền này bị hỏng), hãy xem Yêu cầu SSO và đặt quản trị viên khẩn cấp (break-glass).