Files
buryan-infra/ops/auth/2FA.md
buryan-agent d967d4ed3f 2FA включён, Gitea прибран, README-индекс, статус Яндекс API
Authentik: стадия MFA Validation переведена в режим configure с TOTP —
при входе пользователь без устройства проходит настройку по QR. Откат
описан в ops/auth/2FA.md.

Gitea: удалены пустые репозитории root/buryan-infra и root/runbooks,
главному репозиторию задано описание и темы. README переписан как индекс:
карта инфраструктуры, ссылки на все разделы документации, принципы.

Яндекс: зафиксирован статус — чтение работает, управление через API 403
(нет scope iot), управление голосом и Zigbee работают.
2026-10-20 23:32:33 +03:00

3.1 KiB
Raw Permalink Blame History

Двухфакторная аутентификация (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-токен администратора работает независимо от входа, поэтому откат возможен всегда:

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:

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 позже (ключи вместо кодов).