> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

```text theme={null}
{
  _id:        '123',
  email:      'alice@example.com'
  first_name: 'Alice',
  last_name:  'Jones'
}
```

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

```text theme={null}
Alice:
  - uid:  'alicejones'
  - mail: 'alicejones@tech.example.com'
  - givenName:   'Alice'
  - sn: 'Jones'
```

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

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

<Steps>
  <Step title="اطلب من المستخدمين تحديث عناوين بريدهم الإلكتروني">
    ترتبط حسابات Overleaf بعناوين البريد الإلكتروني، لذا فإن الخطوة الأولى هي جعل عناوين البريد الإلكتروني للمستخدمين في Overleaf متطابقة مع عناوينهم في LDAP أو SAML.

    في مثالنا، ستطلب من Alice تسجيل الدخول إلى حسابها في Overleaf وتغيير بريدها الإلكتروني من `alice@example.com` إلى `alicejones@tech.example.com`.

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

    <Check>
      إذا كان لديك عدد كبير من المستخدمين، فيمكنك استخدام سكربت [ترحيل أسماء المستخدمين](/ar/on-premises/user-and-project-management/user-management/username-migration) لتغيير عنوان البريد الإلكتروني الأساسي للمستخدمين بشكل جماعي.
    </Check>
  </Step>

  <Step title="فعّل وحدة LDAP أو SAML">
    بمجرد تحديث عناوين البريد الإلكتروني للجميع، حان وقت التبديل! ستحتاج إلى ضبط متغيرات البيئة المناسبة لطريقة المصادقة الجديدة، ثم إعادة إنشاء حاوية **sharelatex** باستخدام الأمر `bin/up -d`.

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

    <Info>
      يمكنك العثور على المعلومات ذات الصلة بتفعيل LDAP [هنا](/ar/on-premises/configuration/overleaf-toolkit/authentication/ldap-authentication)، وبتفعيل SAML 2.0 [هنا](/ar/on-premises/configuration/overleaf-toolkit/authentication/saml-authentication).
    </Info>
  </Step>

  <Step title="يمكن للمستخدمين الآن تسجيل الدخول عبر LDAP أو SAML">
    في المرة التالية التي تسجّل فيها Alice الدخول، سترى النموذج الجديد.

    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-4.jpg?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=d1ff36e97d059a8833611541dfcdc317" alt="صفحة تسجيل الدخول عبر LDAP/Active Directory" width="348" height="261" data-path="images/on-premises/image-4.jpg" />

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

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

    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-5.jpg?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=5a3486d88ffd5fe90549a596c05d7aa9" alt="صفحة تسجيل الدخول عبر SAML" width="353" height="198" data-path="images/on-premises/image-5.jpg" />

    <Info>
      راجع صفحة [متغيرات البيئة](/ar/on-premises/configuration/overleaf-toolkit/environment-variables) للحصول على معلومات حول تخصيص تجربة صفحة تسجيل الدخول.

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

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

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

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

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

    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-6.jpg?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=6ab39d406809e864fc337f47bbd3b03b" alt="صفحة تسجيل الدخول بالمصادقة الأصلية" width="407" height="279" data-path="images/on-premises/image-6.jpg" />
  </Step>

  <Step title="اطلب من المستخدمين إعادة تعيين كلمات المرور">
    عندما يزور المستخدمون صفحة تسجيل الدخول الآن، سيرون نموذج تسجيل الدخول في Overleaf بدلًا من نموذج LDAP/SAML.

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

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

    <Info>
      إذا لم تفعل ذلك بعد، فراجع دليلنا حول تفعيل [إرسال البريد الإلكتروني](/ar/on-premises/configuration/overleaf-toolkit/email-delivery).
    </Info>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.