> 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.md).

# إدارة المستخدمين

## إنشاء مستخدم مسؤول

عمليات نشر Overleaf Toolkit:

{% code title="Overleaf Toolkit" overflow="wrap" %}

```bash
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com"
```

{% endcode %}

عمليات نشر docker-compose.yml القديمة:

{% code title="docker-compose القديمة" overflow="wrap" %}

```bash
$ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com"
```

{% endcode %}

سيقوم الأمر بإنشاء مستخدم باستخدام عنوان البريد الإلكتروني المقدم إذا لم يكن موجودًا بالفعل، وسيجعله مسؤولًا. يتضمن ناتج الأمر عنوان URL تزوره حيث يمكنك تعيين كلمة المرور لهذا المستخدم وتسجيل الدخول للمرة الأولى.

{% hint style="info" %}
لمنهج برمجي، يمكنك استخدام النص البرمجي نفسه لإنشاء مستخدمين عاديين وكذلك مسؤولين. بالنسبة للمستخدمين العاديين، احذف الوسم --admin.
{% endhint %}

إذا كنت تستخدم حسابات داخلية للمصادقة وتحتاج إلى ترقية مستخدم موجود إلى مسؤول مثيل أو إلغاء أذونات المسؤول، فافعل ما يلي:

{% stepper %}
{% step %}

### عبر واجهة مسؤول النظام

* سجّل الدخول بصفته مسؤولًا موجودًا.
* انقر على مسؤول -> إدارة المستخدمين.
* ابحث عن المستخدم وانقر على عنوان بريده الإلكتروني.
* مرّر لأسفل إلى قسم مسؤول الموقع وانقر على الرابط (عرض).
* حدّد مربع الاختيار هل هو مسؤول الموقع.
* انقر على حفظ للإنهاء.
  {% endstep %}
  {% endstepper %}

***

## حذف المستخدمين

كما هو موضح في دليلنا حول [فهم استخدام الترخيص](broken://pages/0aa901403245f84b5be7563ffb7e5cf98ba0cbdd)، يُنصح عمومًا بعدم حذف الحسابات إلا إذا لم تعد مطلوبة. يؤدي حذف الحساب إلى إزالة الحساب ويتسبب في فقدان المتعاونين الوصول إلى المشاريع. لا توجد حاليًا طريقة لتعطيل الحسابات — فهي إما موجودة مع الاحتفاظ ببياناتها أو يتم حذفها.

افتراضيًا، تُحذف الحسابات حذفًا غير نهائي. للحصول على معلومات حول الإزالة الدائمة للمستخدمين من المثيل الخاص بك، راجع `ENABLE_CRON_RESOURCE_DELETION` في [متغيرات البيئة](broken://pages/b05c7e9a460367b742c0f9bae29e6a07c8704c4e) الدليل.

{% hint style="info" %}
تُحذف الحسابات حذفًا غير نهائي افتراضيًا. راجع `ENABLE_CRON_RESOURCE_DELETION` لسلوك الحذف الدائم.
{% endhint %}

### عبر مسؤول -> إدارة المستخدمين

{% stepper %}
{% step %}

* سجّل الدخول بصفتك مسؤولًا.
* انقر على مسؤول -> إدارة المستخدمين.
* ابحث عن المستخدم وحدد مربع الاختيار بجوار عنوان بريده الإلكتروني.
* انقر على أيقونة سلة المهملات.
* انقر على حذف للتأكيد.
  {% endstep %}
  {% endstepper %}

### عبر سطر الأوامر

يمكن حذف حسابات المستخدمين (ومشاريعهم) باستخدام الأوامر التالية.

عمليات نشر Overleaf Toolkit:

{% code title="Overleaf Toolkit" %}

```bash
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com"
```

{% endcode %}

عمليات نشر docker-compose.yml القديمة:

{% code title="docker-compose القديمة" %}

```bash
$ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com"
```

{% endcode %}

{% hint style="danger" %}
يستخدم نص الحذف البرمجي خيار force مُضمنًا بشكل ثابت يضمن استمرار الحذف حتى إذا فشل إرسال رسالة البريد الإلكتروني الخاصة بحذف الحساب (على سبيل المثال، عندما لا يعود بريد المستخدم الإلكتروني قيد الخدمة).
{% endhint %}

{% hint style="info" %}
بدءًا من الإصدار 5.5.0، يمكن استخدام الخيار --skip-email لمنع إرسال رسالة بريد إلكتروني توضيحية إلى المستخدم المحذوف.
{% endhint %}

***

## استعادة مستخدم محذوف حذفًا غير نهائي

إذا كان المستخدم قد حُذف حذفًا غير نهائي فقط، فيمكنك استعادة حسابه ومشاريعه.

{% stepper %}
{% step %}

* سجّل الدخول بصفتك مسؤولًا.
* انقر على مسؤول -> إدارة المستخدمين.
* ابحث عن المستخدم الذي تريد استعادته.
* انقر على زر عرض المستخدمين المحذوفين.
* انقر على عنوان البريد الإلكتروني للمستخدم المحذوف.
* انقر على استرداد هذا الحساب.
* انقر على استرداد للتأكيد.
  {% endstep %}
  {% endstepper %}

{% hint style="danger" %}
عندما تكون ENABLE\_CRON\_RESOURCE\_DELETION مضبوطة على true، يمكن استعادة الحسابات المحذوفة حذفًا غير نهائي خلال نافذة مدتها 90 يومًا. بعد 90 يومًا، لا تكون استعادة الحساب ممكنة.
{% endhint %}

***

## عدّ المستخدمين

يمكنك الحصول على أعداد المستخدمين عبر واجهة المسؤول على <https://you-instance-url/admin/user#license>. بالنسبة إلى عمليات التحقق والتصدير البرمجية، قد تساعدك الأمثلة التالية.

إجمالي عدد المستخدمين:

{% code title="إجمالي عدد المستخدمين" %}

```bash
echo 'db.users.countDocuments()' | docker exec -i mongo mongosh --quiet localhost/sharelatex
# overleaf [direct: primary] sharelatex> 16
```

{% endcode %}

إجمالي عدد المستخدمين باستخدام نقطة النهاية الخاصة بالمقاييس:

{% code title="عدد المستخدمين النشطين من المقاييس" %}

```bash
docker exec sharelatex curl http://127.0.0.1:3000/metrics | grep num_active_users
# # HELP num_active_users num_active_users
# # TYPE num_active_users gauge
# num_active_users{app="web-api",host="b3ae4ff549d8"} 16
```

{% endcode %}

إجمالي عدد المستخدمين النشطين (مثال: المستخدمون النشطون خلال آخر 365 يومًا):

{% code title="إجمالي عدد المستخدمين النشطين" %}

```bash
echo 'db.users.countDocuments({ lastActive: { $gte: new Date(new Date().getTime() - (365 * 24 * 60 * 60 * 1000)) } })' | docker exec -i mongo mongosh --quiet localhost/sharelatex
# overleaf [direct: primary] sharelatex> 10
```

{% endcode %}

***

## تحديث معلومات حساب المستخدم

يعتمد تنفيذ تحديثات الحساب على ما إذا كان تسجيل الدخول الأحادي SSO مفعّلًا.

* إذا لم يكن SSO مستخدمًا:
  * يمكن للمسؤولين تعديل معلومات حساب المستخدم عبر مسؤول -> إدارة المستخدمين (البريد الإلكتروني، الاسم الأول، الاسم الأخير، وإنشاء رابط إعادة تعيين كلمة المرور).
  * يمكن للمستخدمين العاديين تحديث تفاصيلهم الخاصة عبر الحساب -> إعدادات الحساب (بما في ذلك تغيير كلمة المرور وإنشاء رموز مصادقة Git).
* إذا كان SSO مستخدمًا:
  * يمكن إعداد Server Pro لتحديث الاسم الأول والأخير للمستخدم أثناء تسجيل الدخول بناءً على نظام المصادقة.
  * عندما تكون OVERLEAF\_SAML\_UPDATE\_USER\_DETAILS\_ON\_LOGIN أو OVERLEAF\_LDAP\_UPDATE\_USER\_DETAILS\_ON\_LOGIN مضبوطة على true، يتم تعطيل نموذج تفاصيل المستخدم على <https://your-instance-url/user/settings> ولا يمكن تعيين الاسم الأول/الأخير إلا في نظام إدارة الهوية الخاص بك.

لمزيد من التفاصيل، راجع:

* تهيئة SAML 2.0: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/saml-2.0>
* تهيئة LDAP: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/ldap>

***

آخر تحديث قبل 4 أشهر

تحتوي صفحة التوثيق هذه على روابط إلى أدلة وصفحات تهيئة خارجية. يتم الاحتفاظ بجميع الروابط ومعلمات الاستعلام كما هي في المحتوى الأصلي.


---

# 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.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.