메인 콘텐츠로 건너뛰기
세 가지 인증 방식을 지원합니다. 설정을 마치면 아래 이미지와 같이 다음 옵션으로 로그인할 수 있습니다.
가장 범용적인 방식인 OIDC 사용을 적극 권장합니다.

OIDC 인증

SAML 인증

LDAP 인증

공개 접근

reCAPTCHA

비밀번호 제한

전역 설정

특정 인증 모듈을 활성화하려면 환경 변수 EXTERNAL_AUTH가 필요합니다. 이 환경 변수는 어떤 외부 인증 방식을 활성화할지 지정합니다. 사용 가능한 옵션은 다음과 같습니다(소문자):
  • saml
  • ldap
  • oidc
사용자가 이러한 방법으로만 로그인하도록 하려면 OVERLEAF_DISABLE_LOCAL_LOGIN=true를 설정하세요. 이렇게 하면 이메일 및 비밀번호 로그인이 숨겨집니다. EXTERNAL_AUTH에서 하나 이상의 방법이 활성화되어 있지 않으면 아무런 효과가 없습니다(6.3.1에서 추가됨).

계정과 비밀번호

EXTERNAL_AUTH가 설정되면 인스턴스에는 로컬 비밀번호가 있는 계정과 없는 계정이 함께 있을 수 있습니다. 계정이 비밀번호를 설정하거나 변경할 수 있는지는 이것만으로 결정됩니다. 로컬 비밀번호가 있는 계정은 이를 직접 관리하고, 없는 계정은 SSO로만 로그인하며 관리자에게서도 비밀번호를 받을 수 없습니다. OIDC가 유일한 방식인 인스턴스에서는 OVERLEAF_DISABLE_LOCAL_LOGIN=true가 아니라면 재설정 이메일로 직접 비밀번호를 설정할 수 있습니다.
  • LDAP와 SAML은 첫 로그인 시 같은 이메일을 가진 로컬 계정을 인수하고, 로그인할 때마다 해당 계정의 로컬 비밀번호를 제거합니다. 다른 이메일인 경우에는 새 계정을 만들고 로컬 계정은 그대로 둡니다.
  • 이메일이 다른 계정의 보조 이메일인 첫 LDAP, SAML 또는 OIDC 로그인은 거부되며 그 계정으로 로그인되지 않습니다.
  • OIDC는 계정에 연결되며 비밀번호를 유지하므로, OIDC에 연결된 로컬 계정은 두 가지 방법 모두로 로그인할 수 있습니다. 연결은 설정 페이지의 Link로 하거나, 이메일이 일치하는 경우 첫 OIDC 로그인 시 이루어집니다. 연결에 대해서는 OIDC 인증을 참조하세요.
  • 관리자가 로컬 계정으로 생성한 계정에는 활성화 이메일이 발송됩니다. 계정을 활성화하면 이메일로 재설정할 때와 같은 방식으로 비밀번호가 설정됩니다.
  • 여러 방식을 활성화한 경우(예: EXTERNAL_AUTH=ldap saml oidc)에도 위 규칙은 동일합니다. 계정의 로컬 비밀번호만 중요하며, 로컬 비밀번호가 없는 계정은 OIDC로 생성된 계정을 포함해 비밀번호를 설정할 수 없습니다.
  • IdP가 퇴사자 계정처럼 접근 권한을 잃어야 하는 계정을 폐쇄한다면 OIDC 인스턴스에서 OVERLEAF_DISABLE_LOCAL_LOGIN=true를 설정하세요. 그렇지 않으면 로컬 비밀번호를 설정한 사람은 IdP가 계정을 폐쇄한 뒤에도 로그인할 수 있습니다.
  • 이메일을 통한 재설정에는 이메일 설정(OVERLEAF_EMAIL_*)이 필요합니다. 설정이 없으면 페이지에는 보냈다고 표시되어도 이메일이 발송되지 않습니다. 대신 관리자가 Admin → Manage Users에서 재설정 링크를 복사하거나 비밀번호를 설정합니다.
  • OVERLEAF_DISABLE_LOCAL_LOGIN=true는 이메일 및 비밀번호 로그인을 숨기지만 비밀번호는 유지합니다. 로그인을 다시 표시하면 비밀번호를 다시 사용할 수 있습니다.
  • EXTERNAL_AUTH가 설정되면 방식과 관계없이 사용자는 설정 페이지에서 새 이메일을 입력할 수 없습니다. 사용자의 첫 OIDC 로그인은 해당 사용자의 이메일을 가진 계정과 연결됩니다. 이메일 변경은 관리자가 Admin → Manage Users에서 합니다. 이메일 설정이 있으면 사용자는 코드로 확인한 이메일을 추가할 수 있고, LDAP와 SAML이 없는 인스턴스에서는 그중 하나를 기본 이메일로 지정할 수 있습니다.
  • OIDC를 사용하는 인스턴스에서는 true 대신 OVERLEAF_ALLOW_PUBLIC_REGISTRATION=@<domain> 또는 @*와 같은 활성화 이메일을 통한 가입을 사용하거나(활성화 이메일이 주소를 증명합니다) 공개 가입을 허용하지 마세요. true로 설정하면 동료가 처음 OIDC로 로그인하기 전에 누구나 동료의 이메일로 가입할 수 있으며, 이 경우 동료가 해당 계정에 연결됩니다.

Q&A

답변: 예, v6.4.0부터 가능합니다. reCAPTCHA v2 invisible 키에서 발급받은 RECAPTCHA_SITE_KEY와 RECAPTCHA_SECRET_KEY를 설정하세요. 자세한 내용은 reCAPTCHA를 참조하세요. 이메일 및 비밀번호 로그인, LDAP 로그인, 가입, 비밀번호 재설정에 적용됩니다. 이전 버전에는 이 설정이 없습니다. 모든 버전에서 로그인 시도 횟수는 제한되며, IP 주소당 분당 20회, 이메일당 2분에 10회입니다.
마지막 수정일 2026년 11월 13일