Pemulihan Akun

Jika Anda terkunci dari SnapOtter (paling sering karena kebijakan MFA yang tidak lagi bisa Anda penuhi), Anda dapat memulihkannya dari dalam kontainer tanpa klien basis data. Perintah pemulihan bersifat offline dan memerlukan akses shell ke kontainer, yang berarti sudah memiliki kendali penuh atas instans tersebut.

Dinding mana yang saya hadapi?

Login SnapOtter menerapkan dua gerbang MFA yang independen. Diagnosis dulu:

docker exec -it snapotter snapotter-admin status

Ini mencetak kebijakan MFA saat ini dan pengguna mana yang telah mendaftarkan TOTP.

• "MFA enrollment is required before login" (dan Anda tidak pernah menyiapkan aplikasi): kebijakan mewajibkan MFA tetapi Anda belum mendaftar. Longgarkan kebijakannya.
• Anda diminta kode yang tidak bisa Anda hasilkan (ponsel hilang dan kode pemulihan Anda juga hilang): akun Anda terdaftar. Hapus pendaftaran itu.

Longgarkan kebijakan MFA

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

Ini mengembalikan kebijakan ke optional. Berlaku pada login Anda berikutnya tanpa perlu restart. Ini hanya pernah menetapkan optional, sehingga tidak dapat mengaktifkan kembali penegakan.

Hapus pendaftaran TOTP satu pengguna

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

Jika kebijakan masih mewajibkan MFA untuk pengguna itu, mereka akan menghadapi dinding pendaftaran berikutnya, jadi jalankan juga reset-mfa-policy, login, dan daftar ulang dari Settings.

Image lama dan cadangan

Pada image yang dibuat sebelum wrapper snapotter-admin ada, panggil skrip secara langsung:

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

Sebagai upaya terakhir pada versi apa pun, tetapkan kebijakan di basis data. Pada image all-in-one, Postgres berjalan di dalam kontainer:

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

Pada penyiapan multi-kontainer, arahkan psql ke DATABASE_URL Anda sendiri.

Terkunci dari SSO, bukan MFA?

Jika login SSO yang ditegakkan gagal, gunakan akun lokal break-glass sebagai gantinya: tetapkan ssoBreakGlassUsername ke admin lokal di Settings > Security sebelum Anda menegakkan SSO, dan login dengan kata sandi akun tersebut.