Ana içeriğe atla
Desteklenen 3 kimlik doğrulama yöntemi vardır. Yapılandırmadan sonra, aşağıdaki görselde gösterildiği gibi şu seçeneklerle giriş yapabilirsiniz.
En genel yöntem olduğu için OIDC kullanmanızı şiddetle öneririz.

OIDC Kimlik Doğrulaması

SAML Kimlik Doğrulaması

LDAP Kimlik Doğrulaması

Herkese Açık Erişim

reCAPTCHA

Parola kısıtlamaları

Genel Yapılandırma

Belirli kimlik doğrulama modülünü etkinleştirmek için EXTERNAL_AUTH ortam değişkeni gereklidir. Bu ortam değişkeni hangi harici kimlik doğrulama yöntemlerinin etkinleştirileceğini belirtir. Kullanılabilir seçenekler şunlardır (küçük harfle):
  • saml
  • ldap
  • oidc
Kullanıcıların yalnızca bu yöntemlerle oturum açmasını sağlamak için OVERLEAF_DISABLE_LOCAL_LOGIN=true olarak ayarlayın. Bu, e-posta ve parola ile oturum açmayı gizler. EXTERNAL_AUTH en az bir yöntemi etkinleştirmediği sürece hiçbir etkisi yoktur (6.3.1 sürümünde eklendi).

Hesaplar ve parolalar

EXTERNAL_AUTH ayarlandığında bir örnek, yerel parolası olan ve olmayan hesapları barındırabilir. Bir hesabın parola belirleyip değiştirebilmesi yalnızca buna bağlıdır: yerel parolası olan hesap onu yönetir, olmayan hesap yalnızca SSO ile giriş yapar ve bir yöneticiden parola alamaz. Tek yöntemi OIDC olan bir örnekte, OVERLEAF_DISABLE_LOCAL_LOGIN=true olmadığı sürece, sıfırlama e-postasıyla kendisi bir parola belirleyebilir.
  • LDAP ve SAML, aynı e-postaya sahip yerel hesabı ilk oturum açmada devralır ve her oturum açmada yerel parolasını kaldırır. Farklı bir e-postayla yeni bir hesap oluştururlar ve yerel hesaba dokunmazlar.
  • E-posta adresi başka bir hesabın ikincil e-postası olan ilk LDAP, SAML veya OIDC girişi reddedilir: o hesaba giriş yapmaz.
  • OIDC bir hesaba bağlanır ve parolasını korur; bu nedenle OIDC’ye bağlı yerel bir hesap her iki yolla da oturum açabilir. Hesap, ayarlar sayfasındaki Link ile veya e-posta eşleştiğinde ilk OIDC oturum açmasında bağlanır. Bağlama için OIDC Kimlik Doğrulaması sayfasına bakın.
  • Bir yöneticinin yerel hesap olarak oluşturduğu hesaba bir etkinleştirme e-postası gönderilir: hesabı etkinleştirmek, parolasını e-posta ile sıfırlamayla aynı şekilde belirler.
  • Birden fazla yöntem etkin olduğunda, örneğin EXTERNAL_AUTH=ldap saml oidc, yukarıdaki kurallar aynı kalır: yalnızca hesabın yerel parolası önemlidir ve yerel parolası olmayan bir hesap, OIDC tarafından oluşturulmuş olsa bile, parola belirleyemez.
  • IdP’niz erişimini kaybetmesi gereken hesapları, örneğin eski çalışanlarınkini kapatıyorsa, OIDC kullanan bir örnekte OVERLEAF_DISABLE_LOCAL_LOGIN=true ayarlayın: aksi halde yerel parola belirlemiş biri, IdP hesabı kapattıktan sonra da giriş yapabilir.
  • E-postayla sıfırlama, e-posta ayarlarını (OVERLEAF_EMAIL_*) gerektirir. Bunlar olmadan, sayfa öyle dese de hiçbir e-posta gönderilmez: bunun yerine bir yönetici bir sıfırlama bağlantısı kopyalar veya parolayı Admin → Manage Users içinde belirler.
  • OVERLEAF_DISABLE_LOCAL_LOGIN=true, e-posta ve parola ile oturum açmayı gizler ancak parolaları korur: oturum açma yeniden gösterildiğinde parolalar yeniden çalışır.
  • EXTERNAL_AUTH ayarlandığında kullanıcılar, yöntem ne olursa olsun, ayarlar sayfasına yeni bir e-posta yazamaz: bir kullanıcının ilk OIDC girişi, kullanıcının e-postasına sahip hesabı bağlar. Yöneticiler e-postaları Admin → Manage Users içinde değiştirir. E-posta ayarlarıyla kullanıcılar bir kodla onayladıkları e-postalar ekler ve LDAP ile SAML olmayan bir örnekte bunlardan birini birincil yapabilir.
  • OIDC kullanan bir örnekte true yerine OVERLEAF_ALLOW_PUBLIC_REGISTRATION=@<domain> veya @* gibi etkinleştirme e-postasıyla kayıt kullanın (etkinleştirme e-postası adresi kanıtlar) veya herkese açık kaydı hiç açmayın: true ile herkes, bir meslektaşının ilk OIDC oturum açmasından önce o meslektaşın e-postasıyla kaydolabilir ve bu da meslektaşı o hesaba bağlar.

Q&A

Yanıt: Evet, v6.4.0 sürümünden itibaren. Bir reCAPTCHA v2 görünmez anahtarından RECAPTCHA_SITE_KEY ve RECAPTCHA_SECRET_KEY değerlerini ayarlayın; bkz. reCAPTCHA. Bu, e-posta ve parola ile oturum açmayı, LDAP ile oturum açmayı, kaydı ve parola sıfırlamayı kapsar. Önceki sürümlerde bunun için bir ayar yoktur; oturum açma denemeleri her sürümde hız sınırlamasına tabidir: IP adresi başına dakikada 20 deneme ve e-posta başına 2 dakikada 10 deneme.
Son değiştirilme tarihi 13 Kasım 2026