Загрузка

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


Практическое задание №7


Шаг 1

Создать политики:

  • Admins only
  • Board only
  • Family only

Шаг 2

Добавить 2FA requirement


Шаг 3

Добавить IP restriction (если есть локальная сеть)


Шаг 4

Подключить политики к:

  • Flow входа
  • Proxy Provider
  • OIDC Provider

Шаг 5

Протестировать:

  • разные пользователи
  • разные группы
  • разные условия

Что должно остаться в голове

Policy = правило доступа

Flow = процесс входа

Group = роль пользователя


Итог части 7

Теперь Authentik для тебя — это:

  • не просто SSO
  • не просто вход
  • а система правил доступа уровня организации

Следующая глава

Часть 8. Sources и LDAP/OAuth интеграции: подключаем внешних пользователей (Google, GitHub, LDAP, Active Directory).

После неё ты сможешь объединять Authentik не только со своими сервисами, но и с внешними системами пользователей.