---
url: https://docs.snapotter.com/ru/guide/account-recovery.md
---

# Восстановление доступа к аккаунту {#account-recovery}

Если вы потеряли доступ к SnapOtter (чаще всего из-за политики MFA, требования
которой вы больше не можете выполнить), восстановить его можно изнутри контейнера,
без клиента базы данных. Команды восстановления работают офлайн и требуют доступа
к оболочке контейнера, что уже означает полный контроль над экземпляром.

## С какой стеной я столкнулся? {#which-wall-am-i-hitting}

Вход в SnapOtter применяет два независимых барьера MFA. Сначала выясните причину:

```bash
docker exec -it snapotter snapotter-admin status
```

Это выведет текущую политику MFA и то, у каких пользователей подключён TOTP.

* **«Перед входом необходимо настроить MFA» (а вы никогда не настраивали приложение):**
  политика требует MFA, но у вас нет подключения. Ослабьте политику.
* **У вас запрашивают код, который вы не можете получить** (потеряли телефон и
  резервные коды): ваш аккаунт подключён. Сбросьте это подключение.

## Ослабьте политику MFA {#relax-the-mfa-policy}

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

Это вернёт политику к значению `optional`. Оно применится при следующем входе, без
перезапуска. Команда всегда устанавливает только `optional`, поэтому она не включит принудительное требование обратно.

## Сбросьте подключение TOTP одного пользователя {#clear-one-user-s-totp-enrollment}

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

Если политика по-прежнему требует MFA для этого пользователя, при следующем входе
он упрётся в стену настройки, поэтому также выполните `reset-mfa-policy`, войдите и настройте заново в Настройках.

## Сбросьте забытый пароль {#reset-a-forgotten-password}

```bash
docker exec -it snapotter snapotter-admin reset-password <username> [password]
```

Если не указывать `[password]`, CLI выведет сгенерированный временный пароль. В обоих случаях активные сессии пользователя, API-ключи и окно ограничения после неудачных попыток входа сбрасываются, а SnapOtter потребует сменить пароль при следующем входе.

## Создайте учётную запись администратора {#bootstrap-an-admin-account}

```bash
docker exec -it snapotter snapotter-admin create-admin [username] [password]
```

Используйте эту команду, когда ни один существующий администратор не может войти. По умолчанию `[username]` равен `DEFAULT_USERNAME` (`admin`), а при пропуске `[password]` выводится временный пароль, который необходимо сменить при первом входе.

## Разблокируйте ограниченного или отключённого пользователя {#unlock-a-throttled-or-disabled-user}

```bash
docker exec -it snapotter snapotter-admin unlock-user <username>
```

Это очищает окно `LOGIN_THROTTLED` в Redis и восстанавливает роль аккаунта, если пользователь был отключён.

## Старые образы и запасные варианты {#older-images-and-fallbacks}

На образе, собранном до появления обёртки `snapotter-admin`, вызовите скрипт
напрямую:

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

В крайнем случае на любой версии задайте политику в базе данных. В образе
all-in-one 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? {#locked-out-of-sso-not-mfa}

Если принудительный вход через SSO не срабатывает, воспользуйтесь резервным локальным аккаунтом:
задайте `ssoBreakGlassUsername` для локального администратора в разделе Настройки > Безопасность, прежде чем
вы включите принудительный SSO, и войдите с паролем этого аккаунта.
