Chuyển đến nội dung chính
Có 3 phương thức xác thực được hỗ trợ. Sau khi cấu hình, bạn có thể đăng nhập bằng các tùy chọn sau, như hình bên dưới.
Chúng tôi đặc biệt khuyên bạn sử dụng OIDC, vì đây là phương thức phổ biến nhất.

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ường EXTERNAL_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
Để chỉ cho phép người dùng đăng nhập bằng các phương thức này, hãy đặt 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 đặt EXTERNAL_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=true trê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ới true, 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

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.
Lần sửa đổi cuối 13 tháng 11, 2026