استعادة الحساب

إذا مُنعت من الدخول إلى SnapOtter (غالبًا بسبب سياسة MFA لم تعد تستطيع تلبيتها)، يمكنك الاستعادة من داخل الحاوية بدون عميل قاعدة بيانات. أوامر الاستعادة تعمل دون اتصال وتتطلب وصولًا إلى صدفة الحاوية، وهو ما يعني بالفعل التحكم الكامل في المثيل.

أيّ حاجز أواجه؟

يطبّق تسجيل الدخول في SnapOtter بوابتَي MFA مستقلتين. شخّص أولًا:

docker exec -it snapotter snapotter-admin status

يطبع هذا سياسة MFA الحالية وأي المستخدمين قد سجّلوا TOTP.

• "يجب التسجيل في MFA قبل تسجيل الدخول" (ولم تُعدّ أبدًا تطبيقًا): السياسة تتطلب MFA لكن ليس لديك تسجيل. خفّف السياسة.
• يُطلب منك رمز لا يمكنك إنتاجه (فقدت هاتفك ورموز الاستعادة الخاصة بك): حسابك مسجَّل. امسح ذلك التسجيل.

تخفيف سياسة MFA

docker exec -it snapotter snapotter-admin reset-mfa-policy

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

مسح تسجيل TOTP لمستخدم واحد

docker exec -it snapotter snapotter-admin disable-mfa <username>

إذا كانت السياسة لا تزال تتطلب MFA لذلك المستخدم، فسيصطدم بحاجز التسجيل بعد ذلك، لذا شغّل أيضًا reset-mfa-policy، وسجّل الدخول، وأعد التسجيل من الإعدادات.

الصور الأقدم والبدائل الاحتياطية

على صورة بُنيت قبل وجود غلاف snapotter-admin، استدعِ السكربت مباشرة:

docker exec -w /app/apps/api snapotter ./node_modules/.bin/tsx \
  src/scripts/mfa-recover.ts reset-mfa-policy

كملاذ أخير على أي إصدار، اضبط السياسة في قاعدة البيانات. على الصورة الشاملة يعمل Postgres داخل الحاوية:

docker exec -it snapotter psql -h 127.0.0.1 -U snapotter -d snapotter \
  -c "UPDATE settings SET value = 'optional' WHERE key = 'mfaPolicy';"

على الإعداد متعدد الحاويات، وجّه psql إلى DATABASE_URL الخاص بك بدلًا من ذلك.

مُنعت من SSO وليس MFA؟

إذا كان تسجيل دخول SSO الملزَم يفشل، فاستخدم حساب الطوارئ المحلي بدلًا من ذلك: اضبط ssoBreakGlassUsername إلى مسؤول محلي ضمن الإعدادات > الأمان قبل أن تفرض SSO، وسجّل الدخول بكلمة مرور ذلك الحساب.