Przejdź do głównej treści
Obsługiwane są 3 metody uwierzytelniania. Po konfiguracji możesz logować się za pomocą następujących opcji, jak pokazano na obrazku poniżej.
Zdecydowanie zalecamy korzystanie z OIDC, ponieważ jest to najbardziej uniwersalna metoda.

Uwierzytelnianie OIDC

Uwierzytelnianie SAML

Uwierzytelnianie LDAP

Dostęp publiczny

reCAPTCHA

Ograniczenia haseł

Konfiguracja globalna

Zmienna środowiskowa EXTERNAL_AUTH jest wymagana do włączenia konkretnego modułu uwierzytelniania. Określa ona, które zewnętrzne metody uwierzytelniania są aktywne. Dostępne opcje (małymi literami):
  • saml
  • ldap
  • oidc
Aby użytkownicy mogli logować się wyłącznie za pomocą tych metod, ustaw OVERLEAF_DISABLE_LOCAL_LOGIN=true. Spowoduje to ukrycie logowania za pomocą adresu e-mail i hasła. Ustawienie nie działa, jeśli EXTERNAL_AUTH nie włącza co najmniej jednej metody (dodane w 6.3.1).

Konta i hasła

Gdy ustawiono EXTERNAL_AUTH, instancja może mieć konta z lokalnym hasłem i bez niego. To, czy konto może ustawić lub zmienić hasło, zależy tylko od tego: konto z lokalnym hasłem zarządza nim, a konto bez lokalnego hasła loguje się tylko przez SSO i nie może go otrzymać od administratora. Na instancji, której jedyną metodą jest OIDC, może je ustawić samo za pomocą wiadomości resetującej, chyba że OVERLEAF_DISABLE_LOCAL_LOGIN=true.
  • LDAP i SAML przejmują konto lokalne o tym samym adresie e-mail przy jego pierwszym logowaniu i usuwają jego lokalne hasło przy każdym logowaniu. Przy innym adresie e-mail tworzą nowe konto i nie zmieniają konta lokalnego.
  • Pierwsze logowanie LDAP, SAML lub OIDC, którego adres e-mail jest dodatkowym adresem e-mail innego konta, zostaje odrzucone: nie loguje do tego konta.
  • OIDC łączy się z kontem i zachowuje jego hasło, więc konto lokalne połączone z OIDC może logować się na oba sposoby. Konto łączy się przyciskiem Link na stronie ustawień lub przy pierwszym logowaniu przez OIDC, gdy adres e-mail się zgadza. Informacje o łączeniu znajdziesz w sekcji Uwierzytelnianie OIDC.
  • Konto utworzone przez administratora jako konto lokalne otrzymuje wiadomość aktywacyjną: aktywacja ustawia jego hasło w taki sam sposób jak reset przez e-mail.
  • Gdy włączonych jest kilka metod, np. EXTERNAL_AUTH=ldap saml oidc, powyższe zasady pozostają takie same: liczy się tylko lokalne hasło konta, a konto bez lokalnego hasła nie może go ustawić, również konto utworzone przez OIDC.
  • Jeśli Twój IdP zamyka konta, które powinny utracić dostęp, np. konta byłych pracowników, ustaw OVERLEAF_DISABLE_LOCAL_LOGIN=true na instancji z OIDC: w przeciwnym razie osoba, która ustawiła lokalne hasło, nadal może się zalogować po zamknięciu konta przez IdP.
  • Resetowanie przez e-mail wymaga ustawień poczty (OVERLEAF_EMAIL_*). Bez nich żadna wiadomość nie jest wysyłana, choć strona tak podaje: administrator kopiuje wtedy link resetujący lub ustawia hasło w Admin → Manage Users.
  • OVERLEAF_DISABLE_LOCAL_LOGIN=true ukrywa logowanie za pomocą adresu e-mail i hasła, ale zachowuje hasła: działają ponownie, gdy logowanie zostanie znów wyświetlone.
  • Gdy ustawiono EXTERNAL_AUTH, użytkownicy nie mogą wpisać nowego adresu e-mail na stronie ustawień, niezależnie od metody: pierwsze logowanie OIDC użytkownika łączy konto, które ma adres e-mail użytkownika. Administratorzy zmieniają adresy e-mail w Admin → Manage Users. Dzięki ustawieniom poczty użytkownicy dodają adresy e-mail, które potwierdzają kodem, i mogą ustawić jeden z nich jako główny na instancji bez LDAP i SAML.
  • W instancji z OIDC używaj rejestracji z wiadomością aktywacyjną, np. OVERLEAF_ALLOW_PUBLIC_REGISTRATION=@<domain> lub @* (wiadomość aktywacyjna potwierdza adres) zamiast true albo wyłącz publiczną rejestrację: przy true każdy mógłby zarejestrować się z adresem e-mail współpracownika przed jego pierwszym logowaniem przez OIDC, co połączyłoby współpracownika z tym kontem.

Pytania i odpowiedzi

Odpowiedź: Tak, od v6.4.0. Ustaw RECAPTCHA_SITE_KEY i RECAPTCHA_SECRET_KEY na podstawie niewidocznego klucza reCAPTCHA v2, zobacz reCAPTCHA. Obejmuje to logowanie za pomocą adresu e-mail i hasła, logowanie LDAP, rejestrację oraz reset hasła. Wcześniejsze wersje nie mają takiego ustawienia; we wszystkich wersjach liczba prób logowania jest ograniczona: 20 prób na minutę na adres IP i 10 prób na 2 minuty na adres e-mail.
Ostatnia modyfikacja 13 listopada 2026