アカウントの復旧
SnapOtter からロックアウトされた場合(多くは、もはや満たせなくなった MFA ポリシーが原因です)、データベースクライアントを使わずにコンテナ内部から復旧できます。復旧コマンドはオフラインで動作し、コンテナへのシェルアクセスが必要です。これはすでにインスタンスを完全に制御できることを意味します。
どの障壁にぶつかっているのか?
SnapOtter のログインは、2 つの独立した MFA ゲートを適用します。まずは切り分けてください。
bash
docker exec -it snapotter snapotter-admin statusこれは現在の MFA ポリシーと、どのユーザーが TOTP を登録済みかを出力します。
- 「ログイン前に MFA の登録が必要です」(そしてアプリを一度も設定していない場合): ポリシーは MFA を要求していますが、登録がありません。ポリシーを緩和してください。
- 生成できないコードの入力を求められる(スマートフォンとリカバリーコードの両方を紛失した場合): あなたのアカウントは登録済みです。その登録を解除してください。
MFA ポリシーを緩和する
bash
docker exec -it snapotter snapotter-admin reset-mfa-policyこれはポリシーを optional に戻します。再起動せずに次回のログインで適用されます。設定するのは常に optional だけなので、強制を再び有効にすることはできません。
特定ユーザーの TOTP 登録を解除する
bash
docker exec -it snapotter snapotter-admin disable-mfa <username>そのユーザーに対してポリシーがまだ MFA を要求している場合、次は登録の障壁にぶつかるので、reset-mfa-policy も実行し、ログインして、設定から再登録してください。
忘れたパスワードをリセットする
bash
docker exec -it snapotter snapotter-admin reset-password <username> [password][password] を省略すると、CLI は生成した一時パスワードを出力します。いずれの場合も、そのユーザーの有効なセッション、API キー、ログイン失敗のスロットルウィンドウが消去され、SnapOtter は次回のログイン時にパスワード変更を要求します。
管理者アカウントを初期作成する
bash
docker exec -it snapotter snapotter-admin create-admin [username] [password]既存の管理者アカウントで一切サインインできない場合に使用します。[username] の既定値は DEFAULT_USERNAME(admin)で、[password] を省略すると初回ログイン時に変更が必要な一時パスワードが出力されます。
スロットル中または無効化されたユーザーを解除する
bash
docker exec -it snapotter snapotter-admin unlock-user <username>これは Redis 内の LOGIN_THROTTLED ウィンドウを消去し、ユーザーが無効化されていた場合はアカウントのロールを復元します。
古いイメージとフォールバック
snapotter-admin ラッパーが存在する前にビルドされたイメージでは、スクリプトを直接呼び出してください。
bash
docker exec -w /app/apps/api snapotter ./node_modules/.bin/tsx \
src/scripts/admin-recovery.ts reset-mfa-policyどのバージョンでも最後の手段として、データベースでポリシーを設定します。オールインワンイメージでは、Postgres はコンテナ内部で動作します。
bash
echo "UPDATE settings SET value = 'optional' WHERE key = 'mfaPolicy';" |
docker exec -i snapotter sh -c 'psql -p "${EMBEDDED_PG_PORT:-5432}" -U snapotter -d snapotter'複数コンテナ構成では、代わりに psql を自分の DATABASE_URL に向けてください。
MFA ではなく SSO からロックアウトされた場合は?
強制された SSO ログインが失敗している場合は、代わりに緊急用のローカルアカウントを使ってください。SSO を強制する前に、設定 > セキュリティで ssoBreakGlassUsername をローカル管理者に設定し、そのアカウントのパスワードでログインします。
