# Двухфакторная аутентификация (Authentik) ## Что включено В потоке входа `default-authentication-flow` есть стадия `default-authentication-mfa-validation` (порядок 30, после логина и пароля). Она настроена так: | Параметр | Значение | |---|---| | `not_configured_action` | **configure** | | `device_classes` | `totp` | | `configuration_stages` | `default-authenticator-totp-setup` | Это значит: при входе любой пользователь, у которого нет TOTP-устройства, сначала попадает на экран настройки — сканирует QR в приложении (Google Authenticator, Aegis, 1Password, Яндекс Ключ) и вводит код. Со следующего входа — просто код. ## Как это выглядит для пользователя 1. Открывает любой сервис (`home.buryans.ru`, `git.buryans.ru`, …). 2. Вводит логин и пароль (или входит через пароль). 3. Если TOTP ещё нет — видит QR и поле для кода. 4. Сканирует, вводит код → попадает в сервис. 5. Дальше при каждом входе — только 6 цифр. ## Откат (если что-то пошло не так) API-токен администратора работает независимо от входа, поэтому откат возможен всегда: ```bash PATCH /api/v3/stages/authenticator/validate/c8d896d3-10a9-491c-99ff-6ef708a2b597/ {"not_configured_action": "skip", "device_classes": ["static","totp","webauthn","duo","sms","email"]} ``` После этого 2FA перестаёт требоваться (но остаётся доступной в профиле). ## Аварийный доступ Если пользователь потерял телефон: 1. Войти как `akadmin` (у него будет свой TOTP). 2. Admin → Directory → Users → пользователь → MFA Devices → удалить. 3. Пользователь войдёт и настроит заново. Если потерян и `akadmin`: ```bash pct exec 114 -- docker exec -it authentik-security-server-1 \ ak shell -c "from authentik.core.models import User; \ print(User.objects.get(username='akadmin').username)" ``` Либо отключить 2FA через PATCH выше. ## Кого это касается Все интерактивные пользователи: `akadmin`, `roman`, `elena`, `sergey`, `daniil`, `polina`, `Nikita`, `AlexTest`. Сервисные аккаунты (`ak-outpost-*`, `ak-Sonarr-client_credentials`) не используют вход через браузер — их 2FA не затрагивает. ## Где менять - Admin → Flows → `default-authentication-flow` → стадия MFA validation. - Admin → Stages → `default-authentication-mfa-validation`. - `webauthn` можно добавить в `device_classes` позже (ключи вместо кодов).