تسجيل الدخول وكلمات المرور
الإعداد
حدّد كيف يسجّل الناس دخولهم: طول كلمة المرور، واختصار للشبكة المنزلية، وتسجيل الدخول من جهة خارجية. المالك وحده يغيّر هذه الإعدادات، من Settings > Sign-in and security (الإعدادات > تسجيل الدخول والأمان).
تحديد أقصر كلمة مرور
رابط إلى تحديد أقصر كلمة مرور- افتح Settings > Sign-in and security > Passwords (كلمات المرور).
- اكتب رقمًا من 4 إلى 64. الرقم الافتراضي 8.
- اختر Save (حفظ). سترى الرقم الجديد باقيًا بعد إعادة تحميل الصفحة.
يسري الحد الأدنى على كل كلمة مرور جديدة: المالك الأول، والدعوات المقبولة، والتغييرات من My account (حسابي)، والأمر holyarrs reset-owner. تبقى كلمات المرور الحالية صالحة حتى تغييرها التالي. أطول كلمة مرور 1024 حرفًا.
تخطي تسجيل الدخول على شبكتي المحلية
رابط إلى تخطي تسجيل الدخول على شبكتي المحليةتفتح الأجهزة الموجودة على شبكتك المنزلية HolyArrs بصفة المالك، دون كلمة مرور. هذا الخيار متوقف افتراضيًا.
- افتح Settings > Sign-in and security > Local network (الشبكة المحلية).
- اكتب شبكاتك، واحدة في كل سطر، حتى 32 شبكة. استخدم نطاقًا (
192.168.1.0/24،fd00::/8) أو عنوانًا واحدًا (192.168.1.20). - شغّل المفتاح واحفظ. سترى عنوانك أنت على البطاقة.
لا يمكن تشغيل المفتاح والقائمة فارغة، ولا ما دام هناك أي حساب طفل. إنشاء مفاتيح API، وتغيير إعدادات تسجيل الدخول، وقراءة الأسرار أو استبدالها، واستعادة النسخ الاحتياطية، كلها تبقى تطلب كلمة المرور.
تحقق من العنوان أولًا
رابط إلى تحقق من العنوان أولًابعض الإعدادات تجعل كل الأجهزة تظهر بعنوان بوابة واحد: Docker Desktop، و Docker أو Podman في وضع rootless، و Kubernetes NodePort. العناوين المعتادة هي 172.17.0.1، و 172.18.0.1 وما فوقه، و 10.88.0.1، و 10.89.x.1، و 10.0.2.2، و 192.168.65.x.
إذا أدرجت واحدًا منها دخل كل من يصل إلى HolyArrs بصفة المالك. تحذّرك البطاقة حين يبدو أحد المدخلات من هذا النوع. افتح الصفحة من جهاز ثانٍ: إذا أظهرت العنوان نفسه، فأوقف المفتاح وأزل ذلك المدخل.
خلف الوكيل العكسي (reverse proxy)، يقرأ HolyArrs العنوان المُمرَّر من الوكلاء المذكورين في HOLYARRS_TRUSTED_PROXIES وحدهم. وإلا فلن تعرض البطاقة أي عنوان، وستقول إن الوكيل غير موثوق.
تسجيل الدخول الموحّد
رابط إلى تسجيل الدخول الموحّديمكن لمزوّد OpenID Connect واحد أن يسجّل دخول الناس. يظهر زرًّا في صفحة تسجيل الدخول.
- افتح Settings > Sign-in and security > Single sign-on (تسجيل الدخول الموحّد).
- اكتب عنوان المُصدر (issuer) لدى المزوّد واختر Test (اختبار). لا يُرسل أي سر في الاختبار.
- اكتب معرّف العميل (client id) وسر العميل (client secret). ضع علامة على Public client (عميل عام) إذا كان المزوّد لا يستخدم سرًّا.
- انسخ Callback address (عنوان الرجوع) وسجّل هذا العنوان بحروفه لدى المزوّد.
- اكتب كلمة مرورك، ومعها رمز التحقق بخطوتين إن كنت تستخدمه، ثم اختر Save. كل تغيير يطلب ذلك.
ثم اربط حسابك أنت: سجّل الدخول بكلمة مرورك، وافتح My account، ومن Linked sign-ins (طرق الدخول المرتبطة) اختر Link (ربط)، وأكّد كلمة مرورك، ثم اختر Single sign-on.
الخيارات
رابط إلى الخياراتالسماح لأشخاص جدد بالانضمام عبر تسجيل الدخول الموحّد
رابط إلى السماح لأشخاص جدد بالانضمام عبر تسجيل الدخول الموحّدمتوقف افتراضيًا. عند تشغيله يحصل كل من يسجّل المزوّد دخوله على حساب، ولذلك يطلب منك HolyArrs التأكيد. ينضم القادمون الجدد أعضاءً لا يستطيعون إلا الطلب. تسجيل الدخول الموحّد لا يُنشئ مالكًا ولا مشرفًا أبدًا.
تغيير المُصدر أو معرّف العميل
رابط إلى تغيير المُصدر أو معرّف العميلتكتب السر من جديد. تُزال الروابط القديمة ويخرج كل من استخدم تسجيل الدخول الموحّد من حسابه. يربطون من جديد من My account. إيقاف تسجيل الدخول الموحّد يخرجهم أيضًا.
إلغاء ربط طريقة دخول
رابط إلى إلغاء ربط طريقة دخول- طريقتك أنت: My account > Linked sign-ins > Unlink (إلغاء الربط). يحتاج إلى تأكيد حديث بكلمة المرور، ويُرفض إذا كانت هذه طريقتك الوحيدة للدخول.
- طريقة أي شخص: يستخدم المالك Settings > Users and roles (المستخدمون والأدوار). إذا كانت طريقة الشخص الوحيدة للدخول، يسألك HolyArrs مرة أخرى.
إلغاء الربط يسجّل خروج الأجهزة التي استخدمته. إذا كان الانضمام مفتوحًا، يستطيع الشخص نفسه أن يعود عضوًا جديدًا. أوقف الانضمام لتبقيه خارجًا.
إذا لم ينجح الأمر
رابط إلى إذا لم ينجح الأمرالعَرَض: يطلب HolyArrs كلمة مرورك من جديد. السبب: تغييرات الحسابات والمفاتيح والإعدادات تحتاج إلى تأكيد بكلمة المرور خلال آخر 10 دقائق، ومعه التحقق بخطوتين إن كان مفعّلًا. تسجيل الدخول من جهة خارجية واختصار الشبكة المحلية لا يُحتسبان. الحل: أكّد بكلمة مرورك. تسجيل الخروج وإنهاء جلسات الأجهزة لا يطلبان ذلك أبدًا.
العَرَض: فشل الرجوع من المزوّد مع خطأ قصير، وبقيت خارج حسابك. السبب: عنوان الرجوع لدى المزوّد يختلف عن الذي في HolyArrs. الحل: انسخ Callback address من جديد والصقه بحروفه لدى المزوّد.
العَرَض: حساب أُنشئ عبر تسجيل الدخول الموحّد لا يستطيع تعيين كلمة مرور. السبب: غير ممكن في هذا الإصدار من التطبيق. الحل: أنشئ المالك المحلي أولًا، ثم اربط تسجيل الدخول الموحّد به.
العَرَض: سجّلت الخروج من HolyArrs وبقيت مسجّلًا لدى المزوّد. السبب: ينهي HolyArrs تسجيل دخوله هو وحده. الحل: على جهاز مشترك، سجّل الخروج لدى المزوّد أيضًا.
هل فقدت كلمة مرور المالك؟ راجع الجلسات وكلمات المرور.
للخبراء
رابط إلى للخبراءتسجيل الدخول عبر وكيل موثوق
إذا كان وكيل عكسي يسجّل دخول الناس أصلًا، يقبل HolyArrs الاسم الذي يمرّره. اضبطه في متغيرات البيئة وحدها. يظهر زرًّا في صفحة تسجيل الدخول؛ الزيارة لا تسجّل دخول أحد اعتمادًا على الترويسات وحدها أبدًا.
- يحذف الوكيل الترويستين
Remote-UserوRemote-Nameالواردتين ويضع قيمتيه هو بعد تسجيل الدخول. Remote-User: اسم ثابت واحد، 255 بايت على الأكثر.Remote-Name: اسم عرض اختياري، 200 بايت على الأكثر.- تُرفض القيم المكررة أو المضمومة بفواصل أو التي فيها محارف تحكّم. ترويسات الأدوار تُهمل.
أبقِ الوصول إلى HolyArrs ممكنًا عبر ذلك الوكيل وحده. الوثوق بعنوان وكيل يعني الوثوق بكل اسم يرسله. اربطه بحساب من My account > Link trusted proxy sign-in (ربط تسجيل الدخول عبر وكيل موثوق).
متغيرات البيئة
اضبط هذه قبل التشغيل. الطريقتان متوقفتان ما لم تُشغَّلا. الإعداد الخاطئ يمنع HolyArrs من البدء؛ أما تعطّل المزوّد فيترك تسجيل الدخول بكلمة المرور يعمل. إذا ضُبط HOLYARRS_OIDC_ENABLED بأي قيمة، حتى false، صارت البيئة هي المتحكمة في تسجيل الدخول الموحّد، وتكتفي الإعدادات بعرضه.
| المتغير | ما يفعله | الافتراضي |
|---|---|---|
HOLYARRS_OIDC_ENABLED |
تشغيل تسجيل الدخول الموحّد | false |
HOLYARRS_OIDC_ISSUER |
عنوان المُصدر لدى المزوّد بحروفه، عبر HTTPS | لا شيء |
HOLYARRS_OIDC_CLIENT_ID |
معرّف العميل المسجَّل | لا شيء |
HOLYARRS_OIDC_CLIENT_SECRET_FILE |
ملف فيه سر العميل، 4096 بايت على الأكثر. لا تضبطه إذا كان العميل عامًا | لا شيء |
HOLYARRS_OIDC_REDIRECT_URL |
عنوان الرجوع بحروفه عبر HTTPS: عنوانك، ثم URL base إن وُجد، ثم /api/v1/auth/oidc/callback |
لا شيء |
HOLYARRS_OIDC_ALLOW_JOIN |
ينضم الأشخاص الجدد أعضاءً لا يستطيعون إلا الطلب | false |
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK |
السماح بمزوّد على شبكتك الخاصة | false |
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP |
السماح بـ HTTP غير المشفّر على العنوان المحلي للجهاز (loopback)، للاختبار | false |
HOLYARRS_FORWARD_AUTH_ENABLED |
تشغيل تسجيل الدخول عبر وكيل موثوق | false |
HOLYARRS_FORWARD_AUTH_ISSUER |
اسم HTTPS ثابت لهذا الوكيل. القيمة الجديدة تُعدّ مصدرًا جديدًا | لا شيء |
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS |
عناوين الوكلاء أو نطاقاتها، مفصولة بفواصل. مطلوب. يُرفض النطاق الذي يشمل كل العناوين | لا شيء |
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN |
تنضم أسماء الوكيل الجديدة أعضاءً لا يستطيعون إلا الطلب | false |
الإعدادان ALLOW_LOCAL_NETWORK و ALLOW_LOOPBACK_HTTP يسريان أيضًا على تسجيل الدخول الموحّد المضبوط من الإعدادات.
كيف يعمل تسجيل الدخول الموحّد
- يجب أن يدعم المزوّد تسجيل الدخول برمز التفويض (authorization code) مع PKCE S256 ورموز RS256، وأن تكون كل نقاط الاتصال على أصل (origin) المُصدر نفسه.
- تُطابَق الحسابات بمعرّف الحساب لدى المزوّد نفسه، لا بالبريد الإلكتروني أبدًا.
- أدوار المزوّد ومجموعاته لا تُستخدم.
- يُحفظ سر العميل مشفّرًا ولا يُعرض مرة أخرى أبدًا. اترك الحقل فارغًا للإبقاء عليه.
صفحات ذات صلة
رابط إلى صفحات ذات صلةHolyArrs مجاني. إذا وفّر عليك وقتًا، امنحه نجمة على GitHub أو ادعمه ماليًا أو ادعُني إلى فنجان قهوة.