Authentik для начинающих. Часть 7. Policies (Политики): умные правила доступа
Версия курса: Authentik 2025.12.x
Зачем нужна эта часть
До этого мы уже научились:
- входу (Authentication)
- ролям (Groups)
- подключению сервисов (OIDC)
- защите сайтов (Proxy Provider)
Теперь самое важное:
как заставить систему принимать решения “кому можно, а кому нельзя” автоматически
Что такое Policy
Policy (Политика) — это правило, которое возвращает:
- True (разрешить)
- False (запретить)
Простая формула
Policy = IF условие → разрешить / запретить
Где находятся политики
Откройте:
Политики (Policies)
или:
Policies
Как Policy используется в Authentik
Policy никогда не работает сама по себе.
Она подключается к:
- Flow (потоки входа)
- Provider (доступ к сервисам)
- Application (приложения)
Базовые типы Policies
1. Group Policy (самая важная)
Проверяет группу пользователя.
Пример:
IF user in group "Admins"
→ allow
В интерфейсе:
Политика группы (Group Policy)
2. Expression Policy (самая мощная)
Позволяет писать условия на Python-подобном языке.
Пример:
return "Board" in [g.name for g in user.groups.all()]
3. Time Policy
Ограничение по времени.
Пример:
Разрешить доступ только с 08:00 до 18:00
4. IP Policy
Ограничение по IP адресу.
Пример:
Разрешить только из локальной сети 192.168.1.0/24
5. Authentication Policy
Проверяет:
- вошёл ли пользователь
- прошёл ли 2FA
6. Device / MFA Policy
Проверяет:
- есть ли 2FA
- доверенное ли устройство
Как Policies объединяются
Очень важный момент:
Policies можно комбинировать
Пример логики
User должен:
- быть в группе Board
- пройти 2FA
- заходить с домашнего IP
Как это читается
ALLOW only if:
(Group = Board)
AND (2FA passed)
AND (IP allowed)
Policy Binding (привязка политики)
Политика сама по себе ничего не делает.
Её нужно “подключить”.
Где это делается
В:
- Flow
- Provider
- Application
Пример
Flow → Policies → Decision
Сложная логика (AND / OR)
AND (И)
Все условия должны быть выполнены:
Group = Board
AND 2FA = OK
OR (ИЛИ)
Достаточно одного:
Group = Admin
OR Group = Support
Практические сценарии для твоей системы
Сценарий 1. Админка кооператива
ALLOW IF:
- Group = Board
- AND 2FA enabled
Сценарий 2. Финансовые данные
ALLOW IF:
- Group = Accountants
- AND 2FA enabled
- AND IP = office network
Сценарий 3. Семейные сервисы
Immich
ALLOW IF:
- Group = Family
Сценарий 4. Админка сайта
Stocktorg
ALLOW IF:
- Group = Admins
Expression Policy (самое мощное оружие)
Пример 1: проверка группы
return "Admins" in [g.name for g in user.groups.all()]
Пример 2: проверка email домена
return user.email.endswith("@stocktorg.com.ua")
Пример 3: комбинированное условие
return (
"Board" in [g.name for g in user.groups.all()]
and user.is_active
)
Ошибки новичков
Ошибка №1
❌ Политика создана, но не подключена
Policy сама ничего не делает.
Ошибка №2
❌ Слишком сложные правила сразу
Начинайте с:
- Group Policy
Ошибка №3
❌ Путают Flow и Policy
- Flow = процесс
- Policy = условие
Как правильно думать
Flow — это сценарий
Login → Password → 2FA → Success
Policy — это фильтр
Можно ли дальше?
Реальная схема Authentik с политиками
User
↓
Flow
↓
Stage
↓
Policy (решение)
↓
Provider
↓
Application
↓
Flow
↓
Stage
↓
Policy (решение)
↓
Provider
↓
Application
Практическое задание №7
Шаг 1
Создать политики:
- Admins only
- Board only
- Family only
Шаг 2
Добавить 2FA requirement
Шаг 3
Добавить IP restriction (если есть локальная сеть)
Шаг 4
Подключить политики к:
- Flow входа
- Proxy Provider
- OIDC Provider
Шаг 5
Протестировать:
- разные пользователи
- разные группы
- разные условия
Что должно остаться в голове
Policy = правило доступа
Flow = процесс входа
Group = роль пользователя
Flow = процесс входа
Group = роль пользователя
Итог части 7
Теперь Authentik для тебя — это:
- не просто SSO
- не просто вход
- а система правил доступа уровня организации
Следующая глава
После неё ты сможешь объединять Authentik не только со своими сервисами, но и с внешними системами пользователей.