> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/ar/idarh-almstkhdmyn-walmsharya/user-management/migrating-to-ldap-or-saml.md).

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

```
{
  _id:        '123',
  البريد الإلكتروني:      'alice@example.com'
  الاسم الأول: 'Alice',
  اسم العائلة:  'Jones'
}
```

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

```
Alice:
  - uid:  'alicejones'
  - mail: 'alicejones@tech.example.com'
  - givenName:   'Alice'
  - sn: 'Jones'
```

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

{% hint style="warning" %}
ستتطلب هذه العملية إعادة إنشاء **sharelatex** الحاوية، مما سيؤدي إلى بعض التوقف المؤقت. نوصي بشدة بأن تتعرّف على هذه العملية عبر تنفيذها أولاً في بيئة اختبار/تجهيز.
{% endhint %}

{% stepper %}
{% step %}

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

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

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

{% hint style="warning" %}
ولا تنسَ نفسك! إذا كنتَ مسؤولاً، فستحتاج أيضاً إلى تحديث عنوان بريدك الإلكتروني.
{% endhint %}

{% hint style="success" %}
إذا كان لديك عدد كبير من المستخدمين، فيمكنك استخدام [ترحيل أسماء المستخدمين](/on-premises/ar/idarh-almstkhdmyn-walmsharya/user-management/username-migration.md) البرنامج النصي لتغيير عنوان البريد الإلكتروني الأساسي للمستخدم دفعةً واحدة.
{% endhint %}
{% endstep %}

{% step %}

### فعّل وحدة LDAP أو SAML

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

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

{% hint style="info" %}
يمكنك العثور على المعلومات ذات الصلة بتمكين LDAP [هنا](/on-premises/ar/althyeh/overleaf-toolkit/authentication/ldap-authentication.md)، وSAML 2.0 [هنا](/on-premises/ar/althyeh/overleaf-toolkit/authentication/saml-authentication.md).
{% endhint %}
{% endstep %}

{% step %}

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

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

![صفحة تسجيل الدخول إلى LDAP/Active Directory](/files/71cb4c5c74615859ad4b72bcf04582a3c83214e5)

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

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

![صفحة تسجيل الدخول إلى SAML](/files/7e2b82c0c273c7f5e95c7ef913cb39020cca1aa0)

{% hint style="info" %}
راجع [متغيرات البيئة](broken://pages/b05c7e9a460367b742c0f9bae29e6a07c8704c4e) الصفحة للاطّلاع على معلومات حول تخصيص تجربة صفحة تسجيل الدخول.

وإذا احتجتَ في أي وقت إلى التراجع، فما عليك سوى تعليق إعدادات LDAP/SAML ثم إعادة إنشاء **sharelatex** الحاوية باستخدام `bin/up -d` الأمر. عندها سيتمكّن المستخدمون من تسجيل الدخول باستخدام عنوان بريدهم الإلكتروني الحالي وكلمة مرور Overleaf الخاصة بهم.
{% endhint %}
{% endstep %}
{% endstepper %}

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

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

{% stepper %}
{% step %}

### تحقّق من صحة بريد الجميع الإلكتروني

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

{% step %}

### عطّل وحدة LDAP أو SAML

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

![صفحة تسجيل الدخول للمصادقة الأصلية](/files/5d01b8c5d92a2d13ce6ec3fbdc781adb96be2f95)
{% endstep %}

{% step %}

### اطلب من المستخدمين إعادة تعيين كلمات المرور الخاصة بهم

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

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

* ينقر على رابط «هل نسيت كلمة المرور؟».
* يدخل عنوان البريد الإلكتروني المرتبط بحسابه (الذي من LDAP/SAML).
* يتبع الرابط الموجود في رسالة البريد الإلكتروني الخاصة بإعادة تعيين كلمة المرور لتعيين كلمة مرور جديدة.

{% hint style="info" %}
إذا لم تكن قد فعلت ذلك بالفعل، فاطّلع على دليلنا حول تمكين [تسليم البريد الإلكتروني](/on-premises/ar/althyeh/overleaf-toolkit/email-delivery.md).
{% endhint %}

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/ar/idarh-almstkhdmyn-walmsharya/user-management/migrating-to-ldap-or-saml.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.