Загрузка

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 — это не список настроек, а система управления сценариями доступа.


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

Часть 5. OAuth2 и OpenID Connect на практике: подключаем первый реальный сервис (Immich или Nextcloud).

Там начнётся самая интересная часть — реальная интеграция твоих сервисов в одну систему входа.