
Xác thực OIDC
Xác thực SAML
Xác thực LDAP
Truy cập công khai
reCAPTCHA
Hạn chế mật khẩu
Cấu hình chung
Biến môi trườngEXTERNAL_AUTH là bắt buộc để bật module xác thực cụ thể. Biến môi trường này chỉ định những phương thức xác thực bên ngoài nào được kích hoạt. Các tùy chọn khả dụng (viết thường) gồm:
- saml
- ldap
- oidc
OVERLEAF_DISABLE_LOCAL_LOGIN=true. Thao tác này sẽ ẩn hình thức đăng nhập bằng email và mật khẩu. Thiết lập này không có tác dụng trừ khi EXTERNAL_AUTH bật ít nhất một phương thức (được thêm vào trong 6.3.1).
Tài khoản và mật khẩu
Khi đặtEXTERNAL_AUTH, một phiên bản có thể chứa tài khoản có và không có mật khẩu cục bộ. Việc một tài khoản có được đặt hoặc đổi mật khẩu hay không chỉ phụ thuộc vào điều đó: tài khoản có mật khẩu cục bộ tự quản lý nó, tài khoản không có mật khẩu cục bộ chỉ đăng nhập qua SSO và không thể nhận mật khẩu từ quản trị viên. Trên phiên bản chỉ dùng OIDC, tài khoản có thể tự đặt mật khẩu bằng email đặt lại, trừ khi OVERLEAF_DISABLE_LOCAL_LOGIN=true.
- LDAP và SAML tiếp quản tài khoản cục bộ có cùng email ở lần đăng nhập đầu tiên, và xóa mật khẩu cục bộ của tài khoản đó ở mỗi lần đăng nhập. Với một email khác, chúng tạo một tài khoản mới và không động đến tài khoản cục bộ.
- Lần đăng nhập LDAP, SAML hoặc OIDC đầu tiên có email là email phụ của một tài khoản khác sẽ bị từ chối: nó không đăng nhập vào tài khoản đó.
- OIDC liên kết với một tài khoản và giữ nguyên mật khẩu của tài khoản đó, vì vậy tài khoản cục bộ được liên kết với OIDC có thể đăng nhập theo cả hai cách. Tài khoản được liên kết bằng nút Link trên trang cài đặt, hoặc ở lần đăng nhập OIDC đầu tiên khi email khớp. Xem Xác thực OIDC để biết cách liên kết.
- Tài khoản do quản trị viên tạo dưới dạng tài khoản cục bộ sẽ nhận được email kích hoạt: việc kích hoạt sẽ đặt mật khẩu cho tài khoản theo cùng cách như đặt lại qua email.
- Khi bật nhiều phương thức, ví dụ
EXTERNAL_AUTH=ldap saml oidc, các quy tắc trên vẫn giữ nguyên: chỉ mật khẩu cục bộ của tài khoản được tính, và tài khoản không có mật khẩu cục bộ không thể đặt mật khẩu, kể cả tài khoản do OIDC tạo. - Nếu IdP của bạn đóng các tài khoản cần mất quyền truy cập, chẳng hạn của nhân viên cũ, hãy đặt
OVERLEAF_DISABLE_LOCAL_LOGIN=truetrên phiên bản dùng OIDC: nếu không, người đã đặt mật khẩu cục bộ vẫn có thể đăng nhập sau khi IdP đóng tài khoản. - Đặt lại qua email cần các thiết lập email (
OVERLEAF_EMAIL_*). Không có chúng thì không email nào được gửi, dù trang báo đã gửi: thay vào đó, quản trị viên sao chép liên kết đặt lại hoặc đặt mật khẩu trong Admin → Manage Users. OVERLEAF_DISABLE_LOCAL_LOGIN=trueẩn hình thức đăng nhập bằng email và mật khẩu, nhưng vẫn giữ các mật khẩu: chúng sẽ hoạt động trở lại khi hình thức đăng nhập này được hiển thị lại.- Khi đặt
EXTERNAL_AUTH, người dùng không thể nhập email mới trên trang cài đặt, bất kể phương thức nào: lần đăng nhập OIDC đầu tiên của người dùng sẽ liên kết tài khoản có email của người dùng. Quản trị viên đổi email trong Admin → Manage Users. Với thiết lập email, người dùng thêm email và xác nhận bằng mã, và có thể đặt một email làm chính trên phiên bản không có LDAP và SAML. - Trên phiên bản có OIDC, hãy dùng đăng ký với email kích hoạt, chẳng hạn
OVERLEAF_ALLOW_PUBLIC_REGISTRATION=@<domain>hoặc@*(email kích hoạt chứng minh địa chỉ email) thay vìtrue, hoặc không cho phép đăng ký công khai: vớitrue, bất kỳ ai cũng có thể đăng ký bằng email của một đồng nghiệp trước lần đăng nhập OIDC đầu tiên của đồng nghiệp đó, khiến đồng nghiệp bị liên kết với tài khoản đó.
Hỏi & Đáp
Tôi có thể bật CAPTCHA cho đăng nhập hoặc đăng ký không?
Tôi có thể bật CAPTCHA cho đăng nhập hoặc đăng ký không?
Trả lời: Có, từ v6.4.0. Đặt
RECAPTCHA_SITE_KEY và RECAPTCHA_SECRET_KEY từ một khóa reCAPTCHA v2 vô hình (invisible), xem reCAPTCHA. Tính năng này áp dụng cho đăng nhập bằng email và mật khẩu, đăng nhập LDAP, đăng ký và đặt lại mật khẩu. Các phiên bản trước không có thiết lập cho tính năng này; đăng nhập được giới hạn tốc độ ở mọi phiên bản: 20 lần thử mỗi phút cho mỗi địa chỉ IP và 10 lần thử mỗi 2 phút cho mỗi email.
