Files
buryan-infra/ops/auth/2FA.md
T
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

70 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Двухфакторная аутентификация (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` позже (ключи вместо кодов).