الترحيل إلى LDAP أو SAML

{
  _id:        '123',
  email:      '[e-mail]'
  first_name: 'Alice',
  last_name:  'Jones'
}

الآن، تريد التكامل مع نظام LDAP/Active Directory الخاص بشركتك. في ذلك النظام، تكون بيانات Alice كما يلي:

Alice:
  - uid:  'alicejones'
  - mail: '[e-mail]'
  - givenName:   'Alice'
  - sn: 'Jones'

هدفك هو أن تسجّل Alice الدخول باستخدام اسم المستخدم في LDAP (alicejones) وكلمة المرور الخاصة به بدلًا من بيانات اعتماد Overleaf القديمة، دون فقدان أي من أعمالها. إليك كيفية تحقيق ذلك.

ستتطلب هذه العملية إعادة إنشاء حاوية sharelatex، مما سيؤدي إلى بعض التوقف. نوصي بشدة بالتعرف على هذه العملية من خلال تنفيذها أولًا في بيئة اختبار/تجهيز (staging).

1. اطلب من المستخدمين تحديث عناوين بريدهم الإلكتروني

   ترتبط حسابات Overleaf بعناوين البريد الإلكتروني، لذا فإن الخطوة الأولى هي جعل عناوين البريد الإلكتروني للمستخدمين في Overleaf متطابقة مع عناوينهم في LDAP أو SAML.

   في مثالنا، ستطلب من Alice تسجيل الدخول إلى حسابها في Overleaf وتغيير بريدها الإلكتروني من [e-mail] إلى [e-mail].

   لا تنسَ نفسك! إذا كنت مسؤولًا، فستحتاج إلى تحديث عنوان بريدك الإلكتروني أيضًا.

   إذا كان لديك عدد كبير من المستخدمين، فيمكنك استخدام سكربت ترحيل أسماء المستخدمين لتغيير عنوان البريد الإلكتروني الأساسي للمستخدمين بشكل جماعي.

2. فعّل وحدة LDAP أو SAML

   بمجرد تحديث عناوين البريد الإلكتروني للجميع، حان وقت التبديل! ستحتاج إلى ضبط متغيرات البيئة المناسبة لطريقة المصادقة الجديدة، ثم إعادة إنشاء حاوية sharelatex باستخدام الأمر bin/up -d.

   يستبدل ذلك نموذج تسجيل الدخول القياسي في Overleaf بنموذج LDAP أو SAML الجديد.

   يمكنك العثور على المعلومات ذات الصلة بتفعيل LDAP هنا، وبتفعيل SAML 2.0 هنا.

3. يمكن للمستخدمين الآن تسجيل الدخول عبر LDAP أو SAML

   في المرة التالية التي تسجّل فيها Alice الدخول، سترى النموذج الجديد.

   

   يمكنها إدخال اسم المستخدم في LDAP (alicejones) وكلمة المرور، ولأن عنوان بريدها الإلكتروني يطابق الآن العنوان الموجود في LDAP، فستُسجَّل الدخول مباشرةً إلى حسابها الحالي في Overleaf. وستكون جميع مشاريعها في مكانها تمامًا كما تركتها.

   إذا فعّلت SAML 2.0، فسيرى المستخدمون زرًا يعيد توجيههم عند النقر عليه إلى مزوّد الهوية (IdP) لإدخال بيانات اعتمادهم. وعند نجاح المصادقة، سيُعاد توجيههم إلى نسخة Overleaf الخاصة بك وتسجيل دخولهم إلى حساباتهم.

   

   راجع صفحة متغيرات البيئة للحصول على معلومات حول تخصيص تجربة صفحة تسجيل الدخول.

   وإذا احتجت يومًا إلى التراجع، فما عليك سوى تعليق تكوين LDAP/SAML وإعادة إنشاء حاوية sharelatex باستخدام الأمر bin/up -d. سيتمكن المستخدمون بعد ذلك من تسجيل الدخول باستخدام عنوان بريدهم الإلكتروني الحالي وكلمة المرور الخاصة بـ Overleaf.

​

الاتجاه المعاكس: التبديل من LDAP/SAML إلى المصادقة الأصلية

ماذا لو كنت تستخدم LDAP أو SAML منذ فترة وتريد الانتقال إلى نظام تسجيل الدخول المدمج في Overleaf (ربما لأنك أوقفت استخدام LDAP)؟ لا مشكلة! إليك كيفية إجراء هذا التبديل.

1. تحقق من صحة البريد الإلكتروني لكل مستخدم

   حسابات المستخدمين مرتبطة بالفعل بعناوين بريدهم الإلكتروني في LDAP أو SAML. وهذا هو البريد الذي سيستخدمونه لتسجيل الدخول من الآن فصاعدًا، لذا تأكد فقط من أن كل شيء يبدو صحيحًا.

2. عطّل وحدة LDAP أو SAML

   ببساطة، أزل إعدادات تكوين LDAP/SAML أو ألغِ ضبطها، وأعد إنشاء حاوية sharelatex باستخدام الأمر bin/up -d. سيعيد ذلك نموذج تسجيل الدخول الأصلي في Overleaf بالبريد الإلكتروني وكلمة المرور.

   
3. اطلب من المستخدمين إعادة تعيين كلمات المرور

   عندما يزور المستخدمون صفحة تسجيل الدخول الآن، سيرون نموذج تسجيل الدخول في Overleaf بدلًا من نموذج LDAP/SAML.

   ونظرًا لأنهم ربما لم يمتلكوا قط كلمة مرور أصلية في Overleaf، فسيحتاجون إلى إنشاء واحدة. يجب على كل مستخدم:

   • النقر على رابط “Forgot your password?”.
   • إدخال عنوان البريد الإلكتروني المرتبط بحسابه (العنوان القادم من LDAP/SAML).
   • اتباع الرابط في رسالة إعادة تعيين كلمة المرور لتعيين كلمة مرور جديدة.

   إذا لم تفعل ذلك بعد، فراجع دليلنا حول تفعيل إرسال البريد الإلكتروني.

   بمجرد الانتهاء من ذلك، يمكنهم تسجيل الدخول باستخدام بريدهم الإلكتروني وكلمة المرور الجديدة الخاصة بـ Overleaf للوصول إلى جميع مشاريعهم.