> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/ar/idarh-almstkhdmyn-walmsharya/user-management/migrating-to-ldap-or-saml.md).

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

```
{
  _id:        '123',
  email:      'alice@example.com'
  first_name: 'Alice',
  last_name:  '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/aliadadat/overleaf-toolkit/authentication/ldap-authentication.md)، وSAML 2.0 [هنا](/on-premises/ar/aliadadat/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/aliadadat/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://overleaf-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.