# تسجيل الدخول والوصول

أعدّ مزوّدي تسجيل الدخول والبريد الإلكتروني لخادم Oleafly Server، وحدّد مَن يدخل عبر قواعد الوصول والتسجيل المفتوح والأدوار والضيوف، وفعّل الوصول عبر المتصفح، وأدر الخادم من وحدة تحكم المشرف.

يسجّل الأشخاص الدخول إلى خادم Oleafly Server عبر مزوّدين تُعدّهم أنت، ولذلك لا يتعامل الخادم مع كلمات المرور مطلقًا. وتقرّر أنت بقواعد الوصول مَن يدخل. ويتولّى المشرفون إدارة ما تبقّى من وحدة تحكم المشرف داخل Oleafly.

## مزوّدو تسجيل الدخول

أعدّ مزوّدًا واحدًا على الأقل. لن يبدأ الخادم دونه، ويذكر سجلّه الإعدادات الواجب إضافتها. يسجّل أول مشرف الدخول به، لأن [تسجيل الدخول عبر رابط بريدي](#sign-in-by-email-link) يبقى معطّلًا حتى يفعّله مشرف. ويعيد كل مزوّد الأشخاص إلى عنوان ردّ اتصال على خادمك:

`https://collab.example.org/auth/callback/<provider>`

إذا كان `OLEAFLY_PUBLIC_URL` يتضمّن مسارًا، فإن عنوان ردّ الاتصال يتضمّنه أيضًا، كما في `https://www.cs.example.edu/oleafly/auth/callback/github`.

### GitHub

1. في GitHub، اختر صورتك الشخصية ثم **Settings › Developer settings › OAuth apps**، واختر **New OAuth App**. إذا كان التطبيق مملوكًا لمؤسسة، فاستخدم **Developer settings** في إعدادات المؤسسة بدلًا من ذلك.
2. املأ **Application name** (مثل `Smith Lab Oleafly`) و**Homepage URL** (`https://collab.example.org`) و**Authorization callback URL** (`https://collab.example.org/auth/callback/github`). اترك **Enable Device Flow** معطّلًا.
3. اختر **Register application**. انسخ **Client ID**، ثم اختر **Generate a new client secret** وانسخ السرّ.
4. عيّن `OLEAFLY_GITHUB_CLIENT_ID` و`OLEAFLY_GITHUB_CLIENT_SECRET`، ثم أعد تشغيل الخادم.

يطلب الخادم من GitHub الملف الشخصي وعناوين البريد الإلكتروني الخاصة بالشخص فقط (`read:user` و`user:email`). ويغيّر `OLEAFLY_GITHUB_LABEL` النص الظاهر على زر تسجيل الدخول.

بالنسبة إلى GitHub Enterprise Server، سجّل التطبيق هناك وعيّن أيضًا `OLEAFLY_GITHUB_URL` بعنوانه، مثل `https://github.example.edu`. لا تعيّن `OLEAFLY_GITHUB_API_URL` إلا إذا كان عنوان API لديك غير معتاد.

### OpenID Connect

يغطّي OpenID Connect كلاً من GitLab وGoogle وMicrosoft Entra ID وKeycloak وAuthentik وOkta ومعظم أنظمة تسجيل الدخول الموحّد في الجامعات. إذا كانت جامعتك لا تقدّم سوى SAML، فضَع Keycloak أو Dex وسيطًا بينهما.

1. اختر اسمًا قصيرًا من أحرف وأرقام، مثل `GITLAB`. يصبح هذا الاسم جزءًا من أسماء المتغيّرات، ويصبح بأحرف صغيرة جزءًا من عنوان ردّ الاتصال. في ملف `.env` الخاص بـ Compose، أعد تسمية أسطر `UNIVERSITY` أو أضف كتلة ثانية.
2. سجّل تطبيقًا لدى مزوّدك. اختر تطبيقًا سريًا أو تطبيق ويب، وعيّن redirect URI إلى `https://collab.example.org/auth/callback/gitlab`، واسم بالنطاقات `openid` و`email` و`profile`.
3. أضف تفاصيل المزوّد:

   ```ini
   OLEAFLY_OIDC_GITLAB_ISSUER=https://gitlab.com
   OLEAFLY_OIDC_GITLAB_CLIENT_ID=example-client-id
   OLEAFLY_OIDC_GITLAB_CLIENT_SECRET=example-client-secret
   OLEAFLY_OIDC_GITLAB_LABEL=GitLab
   ```

4. أعد تشغيل الخادم.

التسمية (label) هي النص الظاهر على زر تسجيل الدخول، مثل `University login`. أما المُصدِر (issuer) فهو العنوان الذي ينشر المزوّد تحته `/.well-known/openid-configuration`. بعض الأمثلة الشائعة:

| المزوّد | المُصدِر |
| --- | --- |
| GitLab.com | `https://gitlab.com` |
| GitLab مُدار ذاتيًا | عنوان GitLab لديك، مثل `https://gitlab.example.edu` |
| Google | `https://accounts.google.com` |
| Microsoft Entra ID | `https://login.microsoftonline.com/` يليه معرّف المستأجر الخاص بك ثم `/v2.0` |
| Keycloak | `https://sso.example.edu/realms/` يليه اسم realm |

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

تطابق إدخالات قائمة المسموح لهم وقواعد النطاقات عناوين البريد الإلكتروني الموثّقة فقط. ولا يعتبر الخادم عنوانًا موثّقًا إلا عندما يقول المزوّد ذلك: بأن يعلّمه GitHub موثّقًا، أو بأن تكون مطالبة `email_verified` في OpenID Connect بالقيمة `true`.

تُغفل بعض مزوّدي المؤسسات هذه المطالبة. إذا كان مزوّدك كذلك، وكان لا يوزّع إلا عناوين تتحكّم بها مؤسستك، فعليك تعيين `OLEAFLY_OIDC_<NAME>_TRUST_EMAIL=true`. لا تعيّنه أبدًا لمزوّد يتيح للأشخاص كتابة أي عنوان بريد إلكتروني يشاؤونه، فقد يستطيع أي شخص حينها تسجيل الدخول بصفته شخصًا من قائمة المسموح لهم.

### شهادات توقّعها جامعتك

إذا كانت جامعتك توقّع شهاداتها بنفسها، لخادمها الوسيط أو لخدمة تسجيل الدخول الخاصة بها، فيجب أن يثق الخادم بجهة إصدار الشهادات تلك. ويجب ذلك أيضًا على كل حاسوب يشغّل Oleafly.

من دون Docker، أضف الشهادة إلى نظام التشغيل. فعلى Debian وUbuntu، انسخها إلى `/usr/local/share/ca-certificates/` باسم ينتهي بـ `.crt` ثم شغّل `sudo update-ca-certificates`.

لا تتضمّن صورة Docker مدير حزم، لذا زوّدها بقائمة شهادات تشمل شهادتك. بجوار `docker-compose.yml`، وعلى جهاز Debian أو Ubuntu:

```sh
cat /etc/ssl/certs/ca-certificates.crt university-ca.pem > ca-bundle.pem
chmod 644 ca-bundle.pem
```

ثم أضف الملف إلى الخادم في `docker-compose.override.yml` وشغّل `docker compose up -d` من جديد:

```yaml
services:
  oleafly-server:
    volumes:
      - ./ca-bundle.pem:/etc/ssl/certs/ca-certificates.crt:ro
```

## البريد الإلكتروني

البريد الإلكتروني اختياري، وكل شيء آخر يعمل بدونه. فمن دون بريد إلكتروني ترسل أنت عنوان الخادم إلى الأشخاص بنفسك، ويعرض Oleafly المشروعات المشتركة مع كل شخص تحت **Shared with you**.

لإعداده، أعطِ الخادم حساب SMTP:

```ini
OLEAFLY_SMTP_URL=smtps://oleafly%40example.org:example-app-password@smtp.example.org:465
OLEAFLY_MAIL_FROM=Smith Lab <oleafly@example.org>
```

عيّن السطرين معًا أو لا تعيّن أيًّا منهما. واكتب المحارف الخاصة في اسم المستخدم وكلمة المرور بصيغة URL، مثل `%40` بدلًا من `@`.

- يستخدم `smtps://` وضع TLS من البداية، على المنفذ 465 ما لم تُسمّ منفذًا آخر.
- يستخدم `smtp://` المنفذ 587 ما لم تُسمّ آخر، ثم ينتقل إلى TLS عبر STARTTLS. إذا كان خادم البريد لا يقدّم STARTTLS فلن يرسل الخادم.
- مُرحّل البريد على الجهاز نفسه هو الاستثناء: ترسل `smtp://localhost` و`smtp://127.0.0.1` و`smtp://[::1]` من دون TLS.
- يمكن لمُرحّل على الشبكة الخاصة نفسها تخطّي TLS عند إضافة `?tls=none`، كما في `smtp://mailpit:1025?tls=none`. ولا يمكن أن يحمل العنوان حينها اسم مستخدم أو كلمة مرور، لأنهما سيعبران الشبكة غير مشفّرين. استخدمه فقط عندما لا يستطيع أحد غيرك الوصول إلى تلك الشبكة.

يتحقّق الخادم من شهادة خادم البريد مقابل الشهادات الموثوق بها في النظام.

### ما يرسله الخادم

هناك ستة أنواع من رسائل البريد الإلكتروني. لا تذهب الرسالة الموجّهة إلى شخص لديه حساب بالفعل إلا إلى عناوينه الموثّقة، وتُتخطى دائمًا عناوين noreply الخاصة بـ GitHub.

| البريد الإلكتروني | متى تُرسل |
| --- | --- |
| الإضافة إلى الخادم | يضيف مشرف شخصًا إلى قائمة المسموح لهم بعنوان بريده الإلكتروني. تحمل الرسالة اسم الخادم ورابط **Add to Oleafly** وعنوان الخادم. أما إضافة شخص باسم مستخدم GitHub أو عبر قاعدة نطاق فلا ترسل شيئًا، لأن الخادم لا يملك عنوانًا له بعد. |
| مشاركة مشروع | يضيف مالك مشروع شخصًا إلى مشروع. تحمل الرسالة عنوان المشروع ومَن شاركه ودور الشخص ورابطًا يفتح المشروع، إضافة إلى صفحة ويب المشروع للحالات التي لا يفتح فيها الرابط التطبيق. تغيير الدور لاحقًا لا يرسل شيئًا. يمكن لكل شخص إيقاف هذه الرسائل من بطاقة الخادم في **Settings → Collaboration**. |
| جهاز جديد | يسجّل حساب الدخول على جهاز آخر. تحمل الرسالة اسم الجهاز ونظام تشغيله والوقت وفق المنطقة الزمنية للخادم، مع تذكير بتسجيل خروج ذلك الجهاز إذا لم يكن صاحبه هو من استخدمه. الجهاز الأول لحساب جديد لا تصله رسالة. عيّن `TZ`، مثل `TZ=Europe/Berlin`، لاختيار المنطقة الزمنية. |
| دعوة ضيف | يدعو مالك مشروع ضيفًا. تحمل الرسالة عنوان المشروع ومَن أرسل الدعوة ورابط **Add to Oleafly** والعنوان الذي سيُسجّل الدخول به. عندما تكون الموافقة مفعّلة، تُرسل الرسالة بعد الموافقة على الدعوة. |
| ذكر | يذكر شخص عضوًا في تعليق أو ردّ. تسمّي الرسالة مَن ذكر الشخص، والمشروع، والملف، والنص الذي يقع عليه التعليق، والتعليق نفسه، مع رابط يفتح التعليق في Oleafly. تُرسل الرسالة بعد نحو دقيقة من وصول التعليق إلى الخادم، وتجتمع الذكر الخاص بالشخص نفسه خلال تلك الدقيقة في رسالة واحدة. لا يحصل أحد على رسالة عن تعليقاته الخاصة أو عن مشروع لا يستطيع فتحه، وتعديل تعليق لا يرسل الذكر نفسه مرتين أبدًا. يمكن لكل شخص إيقاف هذه الرسائل عبر **Email me when someone mentions me in a comment** على بطاقة الخادم في **Settings → Collaboration**. |
| رابط تسجيل الدخول | يطلب شخص رابطًا من صفحة تسجيل الدخول إلى الخادم. |

يمكن للمشرفين إيقاف كل نوع عدا روابط تسجيل الدخول عبر **Email notifications** في إعدادات الخادم. أما روابط تسجيل الدخول فتُرسل دائمًا، لأن الأشخاص لا يستطيعون تسجيل الدخول بدونها.

### اختبره

في [وحدة تحكم المشرف](#admin-console)، افتح **Email**. تعرض الصفحة ما إذا كان البريد الإلكتروني مفعّلًا وعنوان المرسل (From)، ولا تعرض كلمة المرور أبدًا. ويمكن لمشرف اختيار **Send test email** لإرسال رسالة إلى عنوانه الموثّق. تخبرك الصفحة حينها بما إذا كانت الرسالة قد أُرسلت أو بما أجاب به خادم البريد.

وعندما يكون البريد الإلكتروني معطّلًا، تعرض الصفحة رابط **Add to Oleafly** وعنوان الخادم، لتتمكّن من إرسالهما بنفسك.

### عندما يتعطّل خادم البريد

الإرسال لا يعطّل الإجراء الكامن خلفه أبدًا. يحتفظ الخادم بالرسائل في قائمة انتظار في الذاكرة ويعيد المحاولة بعد 30 ثانية ودقيقتين و10 دقائق و30 دقيقة وساعتين. كل محاولة فاشلة تحذير في سجلّ الخادم، وتعرض صفحة **Email** آخر فشل. وإذا فشلت المحاولة الأخيرة أيضًا، سجّل الخادم خطأً وتخلّص من تلك الرسالة. والرسائل التي لا تزال في الانتظار عند إعادة تشغيل الخادم تُفقد.

## تسجيل الدخول عبر رابط بريدي

يمكن للأشخاص أيضًا تسجيل الدخول برابط يرسله الخادم إليهم بالبريد الإلكتروني، فلا يحتاجون إلى حساب GitHub أو OpenID Connect. ويتطلّب هذا [البريد الإلكتروني](#email). ثم يفعّل مشرف الخيار **Sign in by email** في إعدادات الخادم، وهو معطّل افتراضيًا.

يختار الشخص **Continue with Email** في Oleafly، ويُدخل عنوانه في المتصفّح، ثم يختار **Email me a link**. يعمل الرابط مرة واحدة، ولمدة 15 دقيقة، وعلى الحاسوب الذي طلبه. ويؤدّي فتح الرابط إلى صفحة تحوي زر **Sign in**. فتح الرابط وحده لا يستخدمه، ولذلك لا يمكن لفاحص بريد يتبع الروابط أن يستنفده.

لا تزال قواعد الوصول لديك تقرّر مَن يدخل: إدخال في قائمة المسموح لهم لذلك العنوان، أو قاعدة نطاق، أو دعوة ضيف. والإدخال في قائمة المسموح لهم باسم مستخدم GitHub لا يطابق رابط البريد الإلكتروني. وتقول الصفحة الشيء نفسه سواء سمح الخادم بذلك العنوان أم لم يسمح، فلا يستطيع أحد استخدامها لمعرفة مَن يملك حسابًا.

كما أن تفعيله يفتح الحسابات القائمة أمام روابط البريد الإلكتروني. فالرابط يسجّل الدخول إلى الحساب الذي يملك ذلك العنوان بالفعل بوصفه عنوانًا موثّقًا. ويحتفظ الخادم بكل عنوان موثّق أبلغ عنه مزوّد ما عن حساب، لا الرئيسي وحده، ويبقي العنوان حتى بعد أن يحذفه الشخص من جهة المزوّد. فعلى سبيل المثال، يبلّغ GitHub عن كل عنوان موثّق على حساب GitHub. ولذلك يستطيع أي شخص يقرأ البريد الوارد إلى أحد تلك العناوين تسجيل الدخول إلى ذلك الحساب بالبريد الإلكتروني. قبل تفعيله، تحقّق من أن الأشخاص ما زالوا يتحكّمون بكل عنوان على حساباتهم.

وإذا كان العنوان يعود إلى أكثر من حساب واحد، فلا يسجّل الرابط الدخول إلى أيٍّ منها. وإذا كان الحساب الوحيد الذي يملك ذلك العنوان موقوفًا أو محذوفًا، فسيُرفض الرابط حتى تسمح لذلك الشخص بالعودة.

يرسل الخادم 3 روابط كحدّ أقصى إلى عنوان بريد إلكتروني واحد، و100 رابط إلى عنوان IP واحد، في 15 دقيقة، بحيث يستطيع صف من 50 شخصًا يتشاركون عنوانًا واحدًا تسجيل الدخول جميعًا. ويغيّر `OLEAFLY_EMAIL_LINKS_PER_ADDRESS` و`OLEAFLY_EMAIL_LINKS_PER_IP` هذين الرقمين. وتُحتسب كل عناوين IPv6 في شبكة `/64` واحدة عنوانًا واحدًا. وإيقاف **Sign in by email** يبطل الروابط التي أُرسلت سابقًا.

## تسجيل الدخول برمز

عندما لا يستطيع المتصفّح العودة إلى Oleafly بعد تسجيل الدخول، كما يحدث على حاسوب مقيّد، يمكن للأشخاص تسجيل الدخول برمز. لا يحتاج هذا إلى أي إعداد، ويعمل مع كل خيارات تسجيل الدخول التي يوفّرها الخادم.

يعرض Oleafly عنوان خادمك يليه `/auth/device` ورمزًا من ثمانية أحرف. يفتح الشخص ذلك العنوان على أي هاتف أو حاسوب، ويكتب الرمز، ويتحقّق من اسم الحاسوب الذي تعرضه الصفحة، ثم يسجّل الدخول. ويجب أن يكتمل تسجيل الدخول في المتصفّح الذي كُتب الرمز فيه، ولذلك فإن صفحة تسجيل دخول يرسلها شخص آخر كرابط لا تسجّل دخول أي أحد.

يعمل الرمز مرة واحدة، ويتوقّف عن العمل بعد 10 دقائق، ولا تستطيع إلا النسخة من Oleafly التي طلبته إكمال تسجيل الدخول. وزر **Stop, this wasn't me** يلغيه. يمكن لعنوان IP واحد طلب 100 رمز وكتابة 10 رموز خاطئة في 10 دقائق، وهو ما يكفي لصف من 50 شخصًا يتشاركون عنوانًا واحدًا، ويغيّر `OLEAFLY_DEVICE_CODES_PER_IP` ذلك.

## قواعد الوصول

تسجيل الدخول وحده لا يكفي للدخول، بل يجب أن تسمح قاعدة وصول للشخص بالدخول. أدِر القواعد ضمن **Access rules** في وحدة تحكم المشرف:

- **Allowed people**: أضف شخصًا بعنوان بريده الإلكتروني أو باسم مستخدم GitHub مع الدور الذي سيحصل عليه. وتعمل أسماء المستخدمين مع GitHub فقط، لأن المزوّدين الآخرين يتيحون للأشخاص اختيار أسمائهم أو تغييرها. وإذا كان الخادم يرسل بريدًا إلكترونيًا، فإن إضافة شخص بعنوان بريده ترسل إليه عنوان الخادم ورابط **Add to Oleafly**.
- **Domains**: اسمح لكل مَن يملك عنوان بريد إلكتروني موثّقًا عند نطاق، مثل `cs.example.edu`، بتسجيل الدخول بالدور الذي تختاره.

بعد إضافة الأشخاص، يمكنهم إضافة الخادم في Oleafly وتسجيل الدخول.

وضمن **People** يمكنك تغيير دور شخص أو إيقافه مؤقتًا أو إعادة تنشيطه أو إزالته أو تسجيل خروج أجهزته. ويحتفظ الشخص الموقوف بحسابه لكنه لا يستطيع المزامنة حتى تعيد تنشيطه، وتبقى تغييراته على حاسوبه.

أما الشخص الذي تزيله فيبقى خارجًا حتى لو غطّت قاعدةُ نطاق عنوانَه أو دعاه مالكُ مشروع كضيف. وللسماح له بالعودة، أضِفه مجددًا بعنوان بريده الإلكتروني أو باسم المستخدم، فيستعيد حسابه القديم بكل مشروعاته.

### التسجيل المفتوح

لخادم يجوز لأي شخص استخدامه، عيّن `OLEAFLY_OPEN_SIGNUP=true` وأعد تشغيله. عندئذ يحصل كل من يسجّل الدخول عبر أحد مزوّديك على حساب بدور Member، دون إدخال في قائمة المسموح لهم أو قاعدة نطاق. ومع تفعيل **Sign in by email**، يعمل رابط البريد الإلكتروني بالطريقة نفسها.

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

ويفعّل أيضًا [الحدود لكل حساب](/docs/collaboration/server-operations/#limits-per-account): ما لم تعيّن قيمًا أخرى، يجوز لكل حساب تخزين 100 ميغابايت، وامتلاك 50 مشروعًا مشتركًا، وإجراء 300 عملية رفع في الساعة.

لا تعرض وحدة تحكم المشرف ما إذا كان التسجيل المفتوح مفعّلًا. ويذكر سجلّ الخادم ذلك في كل مرة يبدأ فيها: «Open sign-up is on, so anyone who signs in gets an account as a member.» يستطيع الأعضاء البحث عن بعضهم عند مشاركة مشروع، لذا فكّر في إيقاف **Member directory** في إعدادات الخادم إذا كان الخادم مفتوحًا.

## الأدوار والأذونات

لكل شخص دور واحد على مستوى الخادم يمنحه المشرفون ومشرفو الصيانة. وفي كل مشروع يُضاف إليه له أيضًا دور في المشروع يمنحه مالك ذلك المشروع. وتسرد صفحة [الأدوار](/docs/collaboration/sharing/#roles) أدوار المشروع: Owner وEditor وReviewer وCommenter وViewer.

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

| الإجراء | Admin | Maintainer | Member | Guest |
| --- | --- | --- | --- | --- |
| إضافة الخادم إلى Oleafly | نعم | نعم | نعم | نعم |
| عرض قائمة الأعضاء | نعم | نعم | نعم، إلا إذا أخفاها مشرف | لا |
| مشاركة مشروع | نعم | نعم | نعم | لا |
| قراءة سجلّ الأمان | نعم | نعم | لا | لا |
| إضافة أعضاء إلى الخادم | نعم | نعم | لا | لا |
| تعيين مشرفي الصيانة | نعم | لا | لا | لا |
| تغيير إعدادات الخادم | نعم | لا | لا | لا |
| حذف مشروع لتحرير مساحة التخزين | نعم | لا | لا | لا |
| تسجيل خروج جهاز شخص | نعم | نعم، لكن ليس أجهزة المشرفين أو مشرفي الصيانة الآخرين | أجهزته الخاصة فقط | أجهزته الخاصة فقط |
| قراءة المشروعات المخزّنة بوصول مباشر إلى الخادم | ليس من داخل التطبيق | ليس من داخل التطبيق | ليس من داخل التطبيق | ليس من داخل التطبيق |

الصف الأخير هو الأهم. فالمشروعات غير مشفّرة على الخادم، ولذلك يستطيع من يشغّل الجهاز قراءة كل مشروع مخزّن أيًّا كان دوره. ولا يمنح Oleafly أي دور، بما في ذلك المشرف، طريقة لفعل ذلك من داخل التطبيق. وعندما يحذف مشرف مشروعًا لتحرير مساحة التخزين، يُبلَّغ مالك المشروع وأعضاؤه، وتبقى نسخهم الخاصة على حواسيبهم.

## الضيوف

الضيف شخص من خارج خادمك، مثل مؤلف مشارك في جامعة أخرى، يدعوه مالك مشروع إلى مشروع. ولا يرى الضيوف إلا المشروعات التي دُعوا إليها.

### تفعيل الضيوف

الضيوف معطّلون على الخادم الجديد. يفعّلهم مشرف عبر **Allow guests** في إعدادات الخادم. والخيار **Approve guests first** مفعّل افتراضيًا، فيوافق مشرف أو مشرف صيانة على كل دعوة قبل أن تعمل. أوقِفه لتعمل الدعوات فورًا. وعندما يرسل مشرف أو مشرف صيانة دعوة، تُعتمد فورًا.

وإذا أوقفت **Allow guests** لاحقًا، فلن يستطيع المالكون إرسال دعوات جديدة، وتتوقّف الدعوات غير المستخدمة عن العمل. ويحتفظ الضيوف الذين سجّلوا الدخول بالفعل بمشروعاتهم حتى يزيلهم مالك أو تزيلهم أنت ضمن **People**.

### الدعوات

لا يستطيع إلا مالك المشروع دعوة الضيوف إليه، وذلك من مربّع حوار **Share** الخاص بالمشروع.

- الدعوة لعنوان واحد ومشروع واحد، وتنتهي بعد 14 يومًا.
- يستطيع الشخص الواحد إرسال 20 دعوة كحدّ أقصى في الساعة.
- عندما تكون الموافقة مفعّلة، تنتظر الدعوة ضمن **Pending guests** أعلى صفحة **People**. يوافق المشرفون ومشرفو الصيانة هناك على الدعوة أو يرفضونها أو يسحبونها، ويمكن للمالك سحبها أيضًا.
- إذا كان الخادم يرسل بريدًا إلكترونيًا وكان **Email notifications** مفعّلًا، يتلقّى الضيف رسالة دعوة. وإلا فإن Oleafly يعطي المالك رابط **Add to Oleafly** ليرسله بنفسه.
- إذا كان المشروع يضم بالفعل العدد الأقصى من الأشخاص الذي يسمح به الخادم، تنتظر الدعوة، وتعمل في المرة التالية التي يسجّل فيها الشخص الدخول بعد رحيل أحدهم.

يضيف الضيف الخادم ويسجّل الدخول بأي خيار يعطي الخادم العنوان المدعوّ بوصفه عنوانًا موثّقًا: GitHub، أو مزوّد OpenID Connect، أو رابط بريد إلكتروني. والعنوان غير الموثّق لا يُحتسب. وينشئ تسجيل الدخول الأول حساب ضيف ويفتح كل مشروع دُعي إليه ذلك العنوان.

### ما يستطيع الضيوف فعله

يستطيع الضيوف فتح المشروعات التي دُعوا إليها وتجميعها، وتحريرها إذا سمح دورهم بذلك، وتسجيل خروج أجهزتهم الخاصة. ولا يستطيعون عرض دليل الأعضاء أو عنوان البريد الإلكتروني لأي أحد، أو مشاركة مشروعات، أو دعوة أشخاص آخرين، أو الانضمام إلى مشروع عبر رابطه. ولإعطاء ضيف مشروعًا آخر، يدعو مالك ذلك المشروع العنوان نفسه.

وعندما يُزال الضيف من مشروعه الأخير أو يتركه، ينهي الخادم وصوله: يحذف الحساب ويسجّل خروج كل جهاز. وتعيد الدعوة الجديدة الحساب نفسه. أما إذا أزلت ضيفًا ضمن **People** بينما لا يزال لديه مشروعات، فلن تعيده دعوة جديدة.

### الإزالة دائمة الأثر

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

## الوصول عبر المتصفح

عند تفعيل الوصول عبر المتصفح، يستطيع الأشخاص فتح المشروعات المشتركة معهم في متصفح ويب، دون تثبيت Oleafly. فيحررون ويقترحون التغييرات ويعلّقون ويتحادثون ويقرؤون أحدث ملف PDF مجمّع. ويغطي [العمل في متصفح](/docs/collaboration/browser/) ما يرونه.

عيّن `OLEAFLY_WEB=true` وأعد تشغيل الخادم. تتضمّن صورة الحاوية المنشورة تطبيق المتصفح. أما البناء الذي لا يتضمّنه فيسجّل «OLEAFLY_WEB is true, but this build of Oleafly Server has no browser app, so browser access stays off.»

بعد تفعيله:

- يقع تطبيق المتصفح على عنوان خادمك متبوعًا بـ `/web/`، مثل `https://collab.example.org/web/`. وتحصل صفحة كل مشروع تحت `/p/` أيضًا على رابط **Open in browser**.
- يسجّل الأشخاص الدخول على `/web/sign-in` بالمزوّدين وروابط البريد الإلكتروني نفسها التي في Oleafly، وتقرّر قواعد الوصول نفسها مَن يدخل. ويبقى المتصفح مسجّل الدخول 30 يومًا.
- يُحتسب كل متصفح جهازًا من أجهزة ذلك الحساب، باسم مثل «Safari on macOS». ويظهر في قائمة أجهزة الشخص وفي سجلّ الأمان، وتسجيل خروجه يُنهي جلسة ذلك المتصفح.
- يتصل المتصفح بـ `/web/ws` عبر WebSocket وليس له مسار أبطأ، لذا يجب أن يمرّر الوكيل لديك ترقيات WebSocket إلى هناك. ويفعل ذلك بالفعل Caddy وأمثلة nginx وApache في [خلف وكيل عكسي](/docs/collaboration/server-operations/#behind-a-reverse-proxy).
- ملف PDF الذي يقرؤه الأشخاص هو أحدث ملف جمّعه مالك أو محرر في Oleafly. ويشرح [ملفات PDF المجمّعة](/docs/collaboration/server-operations/#compiled-pdfs) كيف يصل إلى هناك.

لا يمكن عرض تطبيق المتصفح داخل إطار في موقع آخر. ولا يتصل إلا بخادمك، باستثناء تحميل الصور الشخصية للأشخاص.

## وحدة تحكم المشرف

وحدة تحكم المشرف نافذة لإدارة خادم واحد من داخل Oleafly، ويستطيع المشرفون ومشرفو الصيانة فتحها. في **Settings → Collaboration**، اختر **Open admin console** على بطاقة الخادم أو أعلى **Manage server**. ويحصل كل خادم على نافذته الخاصة.

| القسم | ما يعرضه وما يفعله |
| --- | --- |
| **Overview** | ما إذا كان الخادم سليمًا، وعدد الأشخاص والأجهزة والمشروعات فيه، ومَن هم المتّصلون، ومقدار مساحة التخزين التي يستخدمها، وخيارات البريد الإلكتروني وتسجيل الدخول فيه، وإعداداته بنظرة سريعة. يحذّر برسالة **Nobody can sign in** عندما لا يكون للخادم خيار تسجيل دخول، وبرسالة **The server can't save files** عندما يتعذّر الكتابة في مجلد البيانات. |
| **People** | كل مَن سجّلوا الدخول. غيّر الأدوار، وأوقف الأشخاص مؤقتًا أو أزلهم، وسجّل خروج أجهزتهم. وتظهر دعوات الضيوف المنتظرة للموافقة في الأعلى. |
| **Access rules** | قائمة المسموح لهم وقواعد النطاقات. |
| **Projects** | كل مشروع مشترك على الخادم، مع مالكه وعدد أشخاصه وحجمه وآخر نشاط له. ابحث بالعنوان أو المالك، واعرض المشروعات المشتركة أو المؤرشفة أو قيد التحميل فقط، وأرشف مشروعًا أو استعده. |
| **Settings** | [إعدادات الخادم](#server-settings). |
| **Email** | ما إذا كان البريد الإلكتروني معدًّا، وعنوان المرسل (From)، وآخر فشل. أرسل رسالة اختبار من هنا. |
| **Security log** | عمليات تسجيل الدخول والمرفوضة منها، والأجهزة، والأشخاص، والإعدادات، والمشروعات، والضيوف. يذكر كل إدخال مَن فعله ومتى ومن أي عنوان IP، مع تفاصيل مثل المشروع وخيار تسجيل الدخول المستخدم أو سبب رفض تسجيل الدخول. |
| **Connection checks** | الفحوص نفسها التي يجريها **Test connection**، من حاسوبك إلى الخادم. |

يستطيع مشرفو الصيانة استخدام كل قسم، لكنهم لا يستطيعون تعيين أي شخص مشرفًا أو مشرف صيانة، ولا عرض أجهزة مشرف أو مشرف صيانة آخر أو تسجيل خروجها، ولا الاطلاع على استخدام التخزين، ولا أرشفة المشروعات أو استعادتها، ولا تغيير إعدادات الخادم، ولا إرسال رسالة اختبار. أما المشرفون فيستطيعون فعل ذلك كله.

أرشفة مشروع توقف مشاركته على الجميع: يتوقّف الأشخاص عن مزامنته ويحتفظون بنسخهم الخاصة، ويحذفه الخادم بعد `OLEAFLY_ARCHIVE_DAYS` يومًا ما لم يستعده مشرف أولًا. والاستعادة تشاركه مجددًا مع الأشخاص أنفسهم. والمشروع الذي لم يكتمل تحميله الأول لا يمكن استعادته. وكلا الأمرين يظهر في سجلّ الأمان.

لا تفتح وحدة التحكم مشروعًا أبدًا، بل تعرض العناوين والمالكين والأحجام، ولا شيء مما في داخلها.

### إعدادات الخادم

تنطبق هذه الإعدادات على كل شخص على الخادم، ولا يستطيع تغييرها إلا المشرفون.

| الإعداد | ما يفعله |
| --- | --- |
| **Allow guests** | يمكن للأعضاء دعوة أشخاص من خارج الخادم إلى مشروعات يملكونها. |
| **Approve guests first** | يوافق مشرف صيانة أو مشرف على كل دعوة ضيف قبل أن تعمل. |
| **Member directory** | يمكن للأعضاء البحث عن بعضهم بالاسم عند مشاركة مشروع. |
| **Show email addresses in the directory** | يرى الأعضاء عناوين البريد الإلكتروني لبعضهم عند البحث عن أحدهم. |
| **Allow link sharing** | يمكن لمالكي المشروعات السماح لأي عضو بفتح مشروع من رابطه. |
| **Allow public note links** | يمكن للأعضاء نشر نسخة للقراءة فقط من ملاحظة على رابط يستطيع أي شخص فتحه دون تسجيل الدخول. وهو معطّل افتراضيًا. وتعطيله يوقف كل رابط منشور إلى أن تعيد تفعيله. انظر [نشر نسخة للقراءة فقط](/docs/notes/projects-and-sharing/#publish-a-read-only-copy). |
| **Allow project access logs** | يمكن لمالكي المشروعات الاحتفاظ بسجلّ لمن فتح مشروعهم. |
| **Allow comments** | يمكن للأشخاص في المشروعات المشتركة التعليق على النص والردّ عليه. وإيقاف هذا الخيار يخفي التعليقات في كل مكان مع إبقائها مخزّنة. |
| **Email notifications** | أوقفه لإيقاف رسائل الخادم للجميع، باستثناء روابط تسجيل الدخول. |
| **Sign in by email** | يمكن للأشخاص تسجيل الدخول برابط يُرسل إلى عنوان بريدهم الإلكتروني، ويتطلّب هذا إعدادات البريد الإلكتروني للخادم. |
