Authentik: стадия MFA Validation переведена в режим configure с TOTP — при входе пользователь без устройства проходит настройку по QR. Откат описан в ops/auth/2FA.md. Gitea: удалены пустые репозитории root/buryan-infra и root/runbooks, главному репозиторию задано описание и темы. README переписан как индекс: карта инфраструктуры, ссылки на все разделы документации, принципы. Яндекс: зафиксирован статус — чтение работает, управление через API 403 (нет scope iot), управление голосом и Zigbee работают.
3.1 KiB
Двухфакторная аутентификация (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, Яндекс Ключ) и вводит код. Со следующего входа — просто код.
Как это выглядит для пользователя
- Открывает любой сервис (
home.buryans.ru,git.buryans.ru, …). - Вводит логин и пароль (или входит через пароль).
- Если TOTP ещё нет — видит QR и поле для кода.
- Сканирует, вводит код → попадает в сервис.
- Дальше при каждом входе — только 6 цифр.
Откат (если что-то пошло не так)
API-токен администратора работает независимо от входа, поэтому откат возможен всегда:
PATCH /api/v3/stages/authenticator/validate/c8d896d3-10a9-491c-99ff-6ef708a2b597/
{"not_configured_action": "skip", "device_classes": ["static","totp","webauthn","duo","sms","email"]}
После этого 2FA перестаёт требоваться (но остаётся доступной в профиле).
Аварийный доступ
Если пользователь потерял телефон:
- Войти как
akadmin(у него будет свой TOTP). - Admin → Directory → Users → пользователь → MFA Devices → удалить.
- Пользователь войдёт и настроит заново.
Если потерян и akadmin:
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позже (ключи вместо кодов).