Thiết lập OIDC SSO
OIDC là giải pháp thay thế cho SAML để kết nối nhà cung cấp danh tính của bạn. Cả hai đều cho phép nhóm của bạn đăng nhập bằng tài khoản công ty hiện có của họ; OIDC là giao thức hiện đại hơn được một số nhà cung cấp ưa thích. Nếu bạn không chắc chắn nên sử dụng cái nào, hãy sử dụng SAML — đây là mặc định và hoạt động với mọi nhà cung cấp được hỗ trợ. Hãy chọn OIDC khi nhà cung cấp của bạn đề xuất hoặc khi SAML không phải là một lựa chọn dành cho bạn.
Quá trình thiết lập có các bước tương tự như SAML — định cấu hình, xác minh miền của bạn, kiểm tra rồi bật — với một số chi tiết dành riêng cho OIDC.
Trước khi bạn bắt đầu
- Tài khoản quản trị viên có quyền quản lý đăng nhập một lần.
- Truy cập vào bảng quản trị của nhà cung cấp danh tính của bạn.
- Miền bạn có thể xác minh (miền email mà nhóm của bạn đăng nhập).
Mở trình hướng dẫn thiết lập
- Đi tới Quản lý người dùng → Đăng nhập một lần.
- Chọn Thiết lập đăng nhập một lần.
- Chọn nhà cung cấp của bạn, sau đó chuyển giao thức sang OIDC.
Trao đổi cài đặt với nhà cung cấp danh tính của bạn
-
Tạo ứng dụng OIDC (hoặc "OpenID Connect") mới trong bảng điều khiển của nhà cung cấp của bạn. Kliv hiển thị cho bạn URL chuyển hướng để dán vào.
-
Nhà cung cấp của bạn cung cấp cho bạn client ID, client secret và issuer URL (địa chỉ web xác định dịch vụ đăng nhập của nhà cung cấp của bạn). Dán cả ba vào Kliv.
-
Issuer URL phải khớp với nhà cung cấp của bạn chính xác, từng ký tự. Đây là điều dễ mắc lỗi nhất:
- Issuer của Microsoft Entra dành riêng cho tenant của bạn và bao gồm mã định danh dài — hãy sao chép mã đó từ ứng dụng của riêng bạn, đừng dùng lại mã định danh từ một hướng dẫn nào.
- Google công bố issuer dưới nhiều dạng; hãy sử dụng chính xác cái mà bảng điều khiển của bạn hiển thị.
Nếu issuer chỉ sai dù rất nhỏ, các đăng nhập hợp lệ sẽ bị từ chối. Bước kiểm tra bên dưới sẽ cho bạn biết liệu đây có phải là sự cố hay không.
Kliv lưu nội dung này dưới dạng bản nháp — đã định cấu hình nhưng chưa hoạt động. Nhóm của bạn tiếp tục đăng nhập theo cách họ làm hiện nay cho đến khi bạn hoàn thành.
Xác minh miền của bạn
Giống như SAML, Kliv sẽ không tạo tài khoản từ nhà cung cấp của bạn cho đến khi bạn chứng minh được rằng bạn kiểm soát miền email. Theo dõi Xác minh miền của bạn, sau đó quay lại đây khi nó hiển thị Đã xác minh.
Kiểm tra bằng đăng nhập thực sự
- Chọn Kiểm tra đăng nhập.
- Đăng nhập vào nhà cung cấp của bạn chính xác như nhóm của bạn sẽ làm.
- Khi thành công, Kliv ghi lại quá trình kiểm tra và mở khóa Bật.
- Khi không thành công, Kliv hiển thị chi tiết mong đợi so với nhận được để bạn có thể khắc phục issuer, client secret hoặc chuyển hướng — xem Khắc phục sự cố đăng nhập SSO không thành công.
Bật SSO
Sau khi đăng nhập thử nghiệm thành công, hãy chọn Bật. Giờ đây, những người trên miền đã xác minh của bạn sẽ được gửi đến nhà cung cấp của bạn để đăng nhập và những lần đăng nhập lần đầu sẽ tự động tạo một tài khoản thành viên tiêu chuẩn.
Thành viên mới chỉ có quyền truy cập của thành viên — không có vai trò nâng cao trừ khi bạn định cấu hình ánh xạ nhóm.
Ghi chú về danh tính người dùng
OIDC xác định mỗi người bằng một cặp giá trị ổn định từ nhà cung cấp của bạn chứ không phải bằng địa chỉ email của họ. Điều đó là có chủ ý: điều đó có nghĩa là một người giữ cùng một tài khoản Kliv ngay cả khi email của họ thay đổi và điều đó có nghĩa là Kliv không phụ thuộc vào việc nhà cung cấp của bạn đánh dấu email là "đã xác minh" (một số nhà cung cấp không gửi email đó cho tài khoản cơ quan). Bạn không cần phải định cấu hình bất cứ điều gì cho việc này — việc biết lý do tại sao một email đã thay đổi không tạo ra một tài khoản trùng lặp sẽ rất hữu ích.