> 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.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 %}

### عبر واجهة إدارة المستخدم

* سجّل الدخول كمُدير موجود بالفعل.
* انقر على Admin -> Manage Users.
* ابحث عن المستخدم وانقر على عنوان بريده الإلكتروني.
* مرّر لأسفل إلى قسم Site Admin وانقر على الرابط (show).
* حدّد مربع Is Site Admin.
* انقر Save للانتهاء.
  {% endstep %}
  {% endstepper %}

***

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

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

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

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

### عبر Admin -> Manage Users

{% stepper %}
{% step %}

* سجّل الدخول كمسؤول.
* انقر على Admin -> Manage Users.
* ابحث عن المستخدم وحدد المربع بجوار عنوان بريده الإلكتروني.
* انقر على أيقونة سلة المهملات.
* انقر Delete للتأكيد.
  {% 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 %}

* سجّل الدخول كمسؤول.
* انقر على Admin -> Manage Users.
* ابحث عن المستخدم الذي تريد استعادته.
* انقر على زر عرض المستخدمين المحذوفين.
* انقر على عنوان البريد الإلكتروني للمستخدم المحذوف.
* انقر على استعادة هذا الحساب.
* انقر استعادة للتأكيد.
  {% 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 مستخدمًا:
  * يمكن للمسؤولين تعديل معلومات حساب المستخدم عبر Admin -> Manage Users (البريد الإلكتروني، الاسم الأول، اسم العائلة، وتوليد رابط لإعادة تعيين كلمة المرور).
  * يمكن للمستخدمين العاديين تحديث تفاصيلهم عبر Account -> Account Settings (بما في ذلك تغيير كلمة المرور وتوليد رموز مصادقة 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://ayakaleaf-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.