Recuperación de la cuenta
Si te quedas fuera de SnapOtter (lo más habitual, por una política de MFA que ya no puedes cumplir), puedes recuperar el acceso desde dentro del contenedor sin un cliente de base de datos. Los comandos de recuperación son sin conexión y requieren acceso al shell del contenedor, lo que ya implica control total de la instancia.
¿Con qué muro me estoy topando?
El inicio de sesión de SnapOtter aplica dos controles de MFA independientes. Diagnostica primero:
bash
docker exec -it snapotter snapotter-admin statusEsto imprime la política de MFA actual y qué usuarios tienen TOTP registrado.
- "Es obligatorio registrar la MFA antes de iniciar sesión" (y nunca configuraste una app): la política exige MFA pero no tienes ningún registro. Relaja la política.
- Se te pide un código que no puedes generar (perdiste el teléfono y tus códigos de recuperación): tu cuenta está registrada. Elimina ese registro.
Relaja la política de MFA
bash
docker exec -it snapotter snapotter-admin reset-mfa-policyEsto restablece la política a optional. Se aplica en tu siguiente inicio de sesión sin reiniciar. Solo llega a establecer optional, así que no puede reactivar la obligatoriedad.
Elimina el registro de TOTP de un usuario
bash
docker exec -it snapotter snapotter-admin disable-mfa <username>Si la política sigue exigiendo MFA a ese usuario, se topará con el muro del registro a continuación, así que ejecuta también reset-mfa-policy, inicia sesión y vuelve a registrarte desde Configuración.
Restablece una contraseña olvidada
bash
docker exec -it snapotter snapotter-admin reset-password <username> [password]Si omites [password], la CLI imprime una contraseña temporal generada. En ambos casos, se borran las sesiones activas, las claves de API y la ventana de bloqueo por intentos fallidos del usuario, y SnapOtter exige cambiar la contraseña en el siguiente inicio de sesión.
Crea una cuenta de administrador inicial
bash
docker exec -it snapotter snapotter-admin create-admin [username] [password]Úsalo cuando ninguna cuenta de administrador existente pueda iniciar sesión. [username] toma por defecto DEFAULT_USERNAME (admin), y omitir [password] imprime una contraseña temporal que debe cambiarse en el primer inicio de sesión.
Desbloquea un usuario limitado o deshabilitado
bash
docker exec -it snapotter snapotter-admin unlock-user <username>Esto borra la ventana LOGIN_THROTTLED en Redis y restaura el rol de la cuenta si el usuario estaba deshabilitado.
Imágenes antiguas y alternativas
En una imagen creada antes de que existiera el envoltorio snapotter-admin, llama al script directamente:
bash
docker exec -w /app/apps/api snapotter ./node_modules/.bin/tsx \
src/scripts/admin-recovery.ts reset-mfa-policyComo último recurso en cualquier versión, establece la política en la base de datos. En la imagen todo en uno, Postgres se ejecuta dentro del contenedor:
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'En la configuración multicontenedor, apunta psql a tu propio DATABASE_URL en su lugar.
¿Sin acceso a SSO, no a MFA?
Si un inicio de sesión SSO obligatorio está fallando, usa la cuenta local de emergencia: establece ssoBreakGlassUsername como administrador local en Configuración > Seguridad antes de imponer SSO, e inicia sesión con la contraseña de esa cuenta.
