Authentik для начинающих. Часть 4. Архитектура: Flows, Stages, Policies, Providers, Applications
Версия курса: Authentik 2025.12.x
Почему эта глава ключевая
Если раньше Authentik казался набором отдельных разделов, то сейчас мы соберём его в единую систему.
После этой главы должно появиться понимание:
Authentik — это не “настройки входа”, а конструктор сценариев авторизации.
Главная идея Authentik
Вся система строится как цепочка:
Flow → Stages → Policies → Provider → Application
И всё это работает вокруг пользователя:
User → проходит Flow → получает доступ к Application
1. Flows (Потоки)
Что такое Flow
Flow (Поток) — это сценарий действий.
Простыми словами:
Flow = последовательность шагов входа или регистрации
Пример Flow
1. Ввод логина
2. Ввод пароля
3. Проверка 2FA
4. Успешный вход
Где это в интерфейсе
Откройте:
Потоки и этапы (Flows and Stages)
или
Flows and Stages
Важно понять
Flow — это “режиссёр”.
Он не делает сам действия, он управляет процессом.
2. Stages (Этапы)
Что такое Stage
Stage (Этап) — это конкретный шаг внутри Flow.
Примеры Stage
| Русский (English) | Что делает |
|---|---|
| Ввод пароля (Password stage) | Проверка пароля |
| Ввод логина (Identification stage) | Определение пользователя |
| TOTP (Authenticator stage) | 2FA код |
| Успешный вход (Login stage) | Завершение |
| Ошибка (Error stage) | Отказ |
Пример Flow со Stage
Identification Stage
→ Password Stage
→ TOTP Stage
→ Login Stage
Аналогия
- Flow = фильм
- Stage = сцены фильма
3. Policies (Политики)
Что такое Policy
Policy (Политика) — это правило.
Вопрос, на который отвечает Policy:
Можно ли пользователю пройти дальше?
Примеры Policies
- пользователь в группе Admins
- пользователь прошёл 2FA
- доступ разрешён только с определённого IP
- доступ только в рабочее время
Пример логики
IF user in group "Board"
→ allow access
ELSE
→ deny
Где это в интерфейсе
Политики (Policies)
или
Policies
Важно
Policy не выполняет действия.
Policy только отвечает:
True / False
4. Providers (Провайдеры)
Что такое Provider
Provider (Провайдер) — это мост между Authentik и вашим сервисом.
Простыми словами:
Provider = способ подключить приложение
Типы Provider
| Тип | Использование |
|---|---|
| OAuth2 / OIDC | Nextcloud, Immich, Grafana |
| SAML | корпоративные системы |
| Proxy Provider | защита сайтов без SSO |
| LDAP Provider | старые системы |
Пример
Authentik → Provider → Nextcloud
Важно
Provider НЕ является приложением.
Он только “обслуживает подключение”.
5. Applications (Приложения)
Что такое Application
Application — это то, что видит пользователь.
Простое объяснение:
Application = сервис в списке входа
Примеры:
- Immich
- Nextcloud
- Gramps Web
- Stocktorg
- Кооперативная система
Где это в интерфейсе
Приложения (Applications)
или
Applications
Связь с Provider
Application всегда связан с Provider:
Application → Provider → Service
Полная схема Authentik
Теперь соберём всё вместе:
User
↓
Flow
↓
Stages
↓
Policies
↓
Provider
↓
Application
Пример из вашей инфраструктуры
Допустим есть пользователь:
alex
Он открывает Nextcloud.
Что происходит:
1. Application
Nextcloud (Application)
2. Provider
OIDC Provider for Nextcloud
3. Flow
Login Flow
4. Stages
1. Identification
2. Password
3. TOTP
5. Policies
User must be in group Family
6. Итог
Allow access → Nextcloud
Где это всё в интерфейсе (очень важно)
Чтобы не запутаться:
Потоки (Flows and Stages)
Flows and Stages
👉 логика входа
Политики (Policies)
Policies
👉 правила доступа
Провайдеры (Providers)
Providers
👉 подключение к сервисам
Приложения (Applications)
Applications
👉 то, что видит пользователь
Частая ошибка новичков
Ошибка №1
Создали Application → ждут входа
❌ не работает
Почему
Потому что нет цепочки:
Application без Provider = мёртвый пункт меню
Правильный порядок
1. Flow
2. Policy
3. Provider
4. Application
Практическое задание №4
Шаг 1
Откройте:
Потоки и этапы (Flows and Stages)
Посмотрите:
- login flow
- default flows
Шаг 2
Откройте:
Политики (Policies)
Найдите:
- default policies
Шаг 3
Откройте:
Провайдеры (Providers)
Посмотрите, какие есть типы.
Шаг 4
Откройте:
Приложения (Applications)
Найдите:
- встроенные приложения Authentik
Мини-вывод этой главы
Если упростить максимально:
Flow = как входить
Policy = можно или нельзя
Stage = шаг внутри входа
Provider = как подключить сервис
Application = что видит пользователь
Что должно остаться в голове после 4-й части
Главное понимание:
Authentik — это не список настроек, а система управления сценариями доступа.
Следующая глава
Там начнётся самая интересная часть — реальная интеграция твоих сервисов в одну систему входа.