Відновлення доступу до облікового запису
Якщо ви втратили доступ до SnapOtter (найчастіше через політику MFA, якій ви більше не можете відповідати), ви можете відновити доступ зсередини контейнера без клієнта бази даних. Команди відновлення працюють офлайн і потребують доступу до оболонки контейнера, а це вже означає повний контроль над екземпляром.
На яку перешкоду я наштовхнувся?
Вхід у SnapOtter застосовує два незалежні бар'єри MFA. Спершу діагностуйте:
bash
docker exec -it snapotter snapotter-admin statusЦе виводить поточну політику MFA та те, які користувачі мають зареєстрований TOTP.
- «MFA enrollment is required before login» (а ви ніколи не налаштовували застосунок): політика вимагає 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>Це очищує вікно LOGIN_THROTTLED у Redis і відновлює роль облікового запису, якщо користувача було вимкнено.
Старіші образи та резервні варіанти
На образі, зібраному до того, як з'явилася обгортка 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.
Заблоковано доступ до SSO, а не MFA?
Якщо примусовий вхід через SSO не працює, скористайтеся натомість аварійним локальним обліковим записом: задайте ssoBreakGlassUsername для локального адміністратора в Налаштування > Безпека, перш ніж ви увімкнете примусове застосування SSO, і увійдіть з паролем цього облікового запису.
