Authentik: стадия MFA Validation переведена в режим configure с TOTP — при входе пользователь без устройства проходит настройку по QR. Откат описан в ops/auth/2FA.md. Gitea: удалены пустые репозитории root/buryan-infra и root/runbooks, главному репозиторию задано описание и темы. README переписан как индекс: карта инфраструктуры, ссылки на все разделы документации, принципы. Яндекс: зафиксирован статус — чтение работает, управление через API 403 (нет scope iot), управление голосом и Zigbee работают.
70 lines
3.1 KiB
Markdown
70 lines
3.1 KiB
Markdown
# Двухфакторная аутентификация (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` позже (ключи вместо кодов).
|