الانتقال إلى المحتوى الرئيسي
هناك 3 طرق مصادقة مدعومة. بعد الإعداد، يمكنك تسجيل الدخول باستخدام الخيارات التالية، كما توضح الصورة أدناه.
نوصي بشدة باستخدام 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.
  • إذا كان مزوّد الهوية لديك يغلق الحسابات التي يجب أن تفقد الوصول، مثل حسابات الموظفين السابقين، فاضبط OVERLEAF_DISABLE_LOCAL_LOGIN=true على مثيل يستخدم OIDC: وإلا فإن من عيّن كلمة مرور محلية يظل قادرًا على تسجيل الدخول بعد أن يغلق مزوّد الهوية الحساب.
  • تتطلب إعادة التعيين عبر البريد الإلكتروني إعدادات البريد الإلكتروني (OVERLEAF_EMAIL_*). وبدونها لا يُرسَل أي بريد، رغم أن الصفحة تقول ذلك: يقوم المسؤول بدلًا من ذلك بنسخ رابط إعادة تعيين أو تعيين كلمة المرور في Admin → Manage Users.
  • يخفي OVERLEAF_DISABLE_LOCAL_LOGIN=true تسجيل الدخول بالبريد الإلكتروني وكلمة المرور، لكنه يحتفظ بكلمات المرور: فهي تعمل مجددًا عند إظهار تسجيل الدخول مرة أخرى.
  • عند ضبط EXTERNAL_AUTH، لا يمكن للمستخدمين كتابة بريد إلكتروني جديد في صفحة الإعدادات، أيًّا كانت الطريقة: إذ يربط أول تسجيل دخول للمستخدم عبر OIDC الحسابَ الذي يحمل بريده الإلكتروني. يغيّر المسؤولون عناوين البريد في Admin → Manage Users. ومع إعدادات البريد الإلكتروني، يضيف المستخدمون عناوين بريد يؤكدونها برمز، ويمكنهم جعل أحدها أساسيًا على مثيل بدون LDAP وSAML.
  • على مثيل يستخدم OIDC، استخدم التسجيل مع رسالة تفعيل عبر البريد الإلكتروني، مثل OVERLEAF_ALLOW_PUBLIC_REGISTRATION=@<domain> أو @* (إذ تثبت رسالة التفعيل ملكية العنوان) بدلًا من true، أو لا تسمح بالتسجيل العام: فمع true يمكن لأي شخص التسجيل ببريد زميل إلكتروني قبل أول تسجيل دخول لذلك الزميل عبر OIDC، مما سيربط الزميل بذلك الحساب.

أسئلة وأجوبة

الإجابة: نعم، بدءًا من الإصدار v6.4.0. اضبط RECAPTCHA_SITE_KEY وRECAPTCHA_SECRET_KEY من مفتاح reCAPTCHA v2 غير مرئي، راجع reCAPTCHA. وهو يشمل تسجيل الدخول بالبريد الإلكتروني وكلمة المرور، وتسجيل الدخول عبر LDAP، والتسجيل، وإعادة تعيين كلمة المرور. لا يوجد إعداد لذلك في الإصدارات الأقدم؛ لكن عمليات تسجيل الدخول محدودة المعدل في جميع الإصدارات: 20 محاولة في الدقيقة لكل عنوان IP و10 محاولات كل دقيقتين لكل بريد إلكتروني.
آخر تعديل في ١٣ نوفمبر ٢٠٢٦