تسجيل الدخول الموحد
في إعداده الافتراضي، Mitra مخصص لشخص واحد ولا يتطلب تسجيل الدخول، وهذا مناسب ما دمت وحدك من يستطيع الوصول إليه. ولمشاركة خادم واحد مع عائلتك أو فريقك، اربطه بمزوّد OpenID Connect (OIDC). عندها يسجّل كل شخص الدخول بحساب يملكه بالفعل، ويحصل على تقويماته الخاصة التي لا يراها أحد غيره.
يعمل Mitra مع أي مزوّد OIDC قياسي. ويستخدمه الناس مع Pocket ID وAuthelia وAuthentik وKeycloak وGoogle وغيرها.
CAUTION
تفعيل تسجيل الدخول يمنح كل شخص حسابًا جديدًا فارغًا، وأنت منهم. وكل ما أعددته عندما كان Mitra لشخص واحد يبقى مع ذلك الحساب القديم ولا ينتقل: حساباتك المرتبطة، وإعداداتك، وكل عنصر في تقويمات Mitra الخاصة بك. من السهل إضافة الحسابات المرتبطة من جديد، لكن العناصر في تقويمات Mitra لا يمكن أن تنتقل معك. فعّل تسجيل الدخول قبل أن تبدأ بملء Mitra، أو انقل تلك العناصر أولًا إلى تقويم مرتبط (نقل العناصر إلى… من قائمة ⋯ الخاصة بالتقويم)، ثم اربط ذلك الحساب من جديد بعد ذلك.
تفعيل تسجيل الدخول
Section titled “تفعيل تسجيل الدخول”اضبط متغيرات OIDC في الحاوية:
services: mitra: image: ghcr.io/a11delavar/mitra:latest environment: MITRA_URL: 'https://mitra.example.com' # the address people use to reach Mitra MITRA_OIDC_ISSUER: 'https://auth.example.com' # your provider's issuer URL MITRA_OIDC_CLIENT_ID: 'mitra' MITRA_OIDC_CLIENT_SECRET: '…' # leave out for a public clientلدى مزوّدك، سجّل MITRA_URL متبوعًا بالمسار /auth/callback كعنوان لإعادة التوجيه:
https://mitra.example.com/auth/callbackهذا كل ما يحتاجه المزوّد. أعد تشغيل Mitra بالأمر docker compose up -d، وسيطلب من الجميع تسجيل الدخول.
ضبط MITRA_OIDC_ISSUER هو ما يفعّل تسجيل الدخول، ويحتاج معه إلى MITRA_OIDC_CLIENT_ID وMITRA_URL أيضًا. وإذا غاب أحدهما، يرفض Mitra البدء. فالعمل بصمت دون تسجيل دخول سيكون أسوأ بكثير.
المفتاح السري للعميل والنطاقات
Section titled “المفتاح السري للعميل والنطاقات”إذا سجّلت مفتاحًا سريًا للعميل لدى مزوّدك، فاضبط MITRA_OIDC_CLIENT_SECRET. وإذا سجّلت عميلًا عامًا، فاتركه؛ فهذا مدعوم بالكامل، لأن Mitra يستخدم PKCE دائمًا.
يطلب Mitra النطاقات openid profile email. والنطاق openid إلزامي، ويعطي النطاقان الآخران Mitra اسم كل شخص وبريده الإلكتروني. لا تغيّرها عبر MITRA_OIDC_SCOPES إلا إذا كان مزوّدك يحتاج إلى غيرها.
من يمكنه تسجيل الدخول
Section titled “من يمكنه تسجيل الدخول”كل من يسمح له مزوّدك بالمرور يحصل على حساب في Mitra عند أول تسجيل دخول له. ولا توجد في Mitra قائمة مستخدمين تديرها، لذا حدّد من يُسمح له بتسجيل الدخول لدى مزوّدك، حسب المجموعة أو تعيين التطبيق أو أي طريقة يدير بها الوصول. ويُحدَّث اسم كل شخص وبريده الإلكتروني من المزوّد في كل مرة يسجّل فيها الدخول.
كيف يعمل تسجيل الدخول
Section titled “كيف يعمل تسجيل الدخول”يتم تسجيل الدخول نفسه على الخادم (تدفق رمز التفويض مع PKCE). ولا يحصل متصفحك إلا على ملف تعريف ارتباط، ولا تُحفظ أي رموز في مساحة تخزينه، فلا يجد أي برنامج نصي ضار في الصفحة شيئًا يسرقه.
تدوم الجلسة 30 يومًا من آخر مرة استخدمت فيها Mitra. ويُعلَّم ملف تعريف الارتباط كآمن عندما يبدأ MITRA_URL بالبادئة https://، ويُسمح بجهة إصدار تبدأ بالبادئة http:// للمزوّدين الموجودين على شبكتك الخاصة دون HTTPS. وإذا كان مزوّدك يدعم ذلك، فإن تسجيل الخروج من Mitra يسجّل خروجك منه أيضًا.
استكشاف الأخطاء وإصلاحها
Section titled “استكشاف الأخطاء وإصلاحها”- لا يبدأ Mitra ويذكر متغيرًا مفقودًا. عند ضبط
MITRA_OIDC_ISSUER، يجب ضبطMITRA_OIDC_CLIENT_IDوMITRA_URLأيضًا. - يعترض المزوّد على عنوان إعادة التوجيه. يجب أن يكون
MITRA_URLمتبوعًا بالمسار/auth/callbackتمامًا. - يذكر السجل أن الاكتشاف فشل. يبحث Mitra عن مزوّدك عند أول تسجيل دخول، ويحاول مجددًا في التسجيل التالي، فالمزوّد الذي يبدأ بعد Mitra تُحل مشكلته من تلقاء نفسها. وإذا استمر الفشل، فتحقق من عنوان URL لجهة الإصدار ومن قدرة Mitra على الوصول إليه، مع ضبط مستوى السجل على
debug. - اختفت تقويماتي بعد تفعيل تسجيل الدخول. هذا متوقع: فالجميع يبدأ بحساب جديد. اربط حساباتك من جديد.