Загрузка

Authentik для начинающих. Часть 5. OAuth2 и OpenID Connect (OIDC) на практике

Authentik для начинающих. Часть 5. OAuth2 и OpenID Connect (OIDC) на практике

Версия курса: Authentik 2025.12.x


Что мы делаем в этой части

Теперь переходим от теории к реальной интеграции.

Цель главы:

Подключить реальный сервис к Authentik через OIDC (OpenID Connect)

И понять, как единый вход (SSO) работает на практике.


Почему именно OAuth2 / OIDC

Большинство современных сервисов используют:

  • OAuth2 (авторизация)
  • OpenID Connect (идентификация поверх OAuth2)

Простое объяснение

  • OAuth2 = “можно ли дать доступ?”
  • OIDC = “кто именно вошёл?”

Как это выглядит в реальности

Пользователь → Authentik → выдаёт токен → сервис доверяет входу

Что такое токены

После входа Authentik выдаёт:

  • ID Token (кто пользователь)
  • Access Token (что можно делать)
  • Refresh Token (обновление сессии)

Главная схема OIDC

User
 ↓
Authentik (логин + 2FA)
 ↓
OIDC Provider
 ↓
Token (JWT)
 ↓
Application (Nextcloud / Immich / etc.)

Где мы это настраиваем в Authentik

В интерфейсе:

  • Провайдеры (Providers)
  • Приложения (Applications)

Шаг 1. Создаём Provider (провайдер)

Откройте:

Провайдеры (Providers)

или:

Providers

Нажмите:

Создать (Create)

Выберите:

👉 OAuth2/OpenID Provider


Заполняем:

Имя

Nextcloud OIDC

Client ID

Можно оставить автоматически:

nextcloud

Client Secret

Сгенерируется автоматически.


Redirect URI

Очень важно.

Пример для Nextcloud:

https://cloud.example.com/apps/user_oidc/code

Scopes (области доступа)

Обычно:

  • openid
  • profile
  • email

Шаг 2. Создаём Application

Откройте:

Приложения (Applications)

или:

Applications

Нажмите:

Создать (Create)


Заполняем:

Name

Nextcloud

Slug (идентификатор)

nextcloud

Provider

Выбираем созданный:

Nextcloud OIDC

Шаг 3. Настройка Nextcloud (пример сервиса)

Теперь идём в:

Nextcloud


Устанавливаем модуль OIDC

В Nextcloud обычно используется:

  • OpenID Connect Login plugin

Заполняем данные:

Issuer URL

https://auth.example.com/application/o/nextcloud/

Client ID

nextcloud

Client Secret

из Authentik


Login Button

Можно назвать:

Login via Authentik

Шаг 4. Первый вход пользователя

Теперь происходит магия:


Пользователь открывает:

https://cloud.example.com

Дальше:

  1. Redirect на Authentik
  2. Ввод логина
  3. Ввод пароля
  4. 2FA (если включено)
  5. Возврат в Nextcloud

Результат:

Пользователь автоматически создаётся или связывается.


Что происходит внутри (очень важно понять)

Authentik → проверяет пользователя
        → проверяет группы
        → создаёт токен
        → отдаёт Nextcloud

Атрибуты пользователя в OIDC

OIDC может передавать:

Поле Пример
email alex@example.com
name Александр
groups Family, Board

Группы в OIDC (очень важно)

Группы можно передавать как:

"groups": ["Family", "Board"]

И сервисы могут использовать это для:

  • прав доступа
  • ролей
  • ограничений

Частая ошибка №1

❌ Неправильный Redirect URI

Даже одна лишняя буква ломает вход.


Частая ошибка №2

❌ Несовпадение Client ID

Client ID должен совпадать:

  • в Authentik
  • в сервисе

Частая ошибка №3

❌ Не тот Issuer URL

Должен быть именно Authentik:

https://auth.example.com/application/o/<slug>/

Почему OIDC лучше паролей

Без OIDC:

  • каждый сервис хранит пароль
  • нужно 10 аккаунтов
  • сложно контролировать доступ

С OIDC:

  • один вход
  • одна точка контроля
  • централизованные правила

Пример твоей инфраструктуры

Ты можешь подключить:

  • Immich
  • Nextcloud
  • Gramps Web
  • Element
  • iRedMail

Все они будут использовать:

Authentik → OIDC → единый вход

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

Шаг 1

Создать Provider:

  • тип: OAuth2/OpenID
  • имя: Nextcloud OIDC

Шаг 2

Создать Application:

  • Nextcloud
  • привязать Provider

Шаг 3

Настроить Nextcloud OIDC плагин


Шаг 4

Попробовать вход


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

OIDC = способ входа без пароля в каждом сервисе
Provider = соединение Authentik и сервиса
Application = сервис в списке входа
Token = цифровое доказательство личности

Итог части 5

Если всё сделано правильно:

  • пользователь входит через Authentik
  • Nextcloud не знает пароль вообще
  • доступ управляется централизованно

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

Часть 6. Proxy Provider: защита любых сайтов (даже без поддержки SSO) + пример защиты Stocktorg и админ-панелей.

Authentik для начинающих. Часть 4. Архитектура: Flows, Stages, Policies, Providers, Applications

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).

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

Authentik для начинающих. Часть 3. Аутентификация (Authentication), авторизация (Authorization), пароли, 2FA, TOTP и Passkeys

Authentik для начинающих. Часть 3. Аутентификация (Authentication), авторизация (Authorization), пароли, 2FA, TOTP и Passkeys

Версия курса: Authentik 2025.12.x


Почему эта глава важна

Большинство проблем безопасности возникают не из-за взлома серверов.

Обычно происходит что-то гораздо проще:

  • слабый пароль;
  • одинаковый пароль на нескольких сайтах;
  • пароль попал в утечку;
  • пользователь сам сообщил пароль мошеннику.

Поэтому современная защита строится не только на пароле.

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


Аутентификация и авторизация — это разные вещи

Новички часто считают эти слова синонимами.

На самом деле это два разных процесса.


Аутентификация (Authentication)

Вопрос:

Кто вы?

Система проверяет личность пользователя.

Например:

Логин: alex
Пароль: ********

Если пароль верный:

Да, это действительно alex

Это аутентификация.


Авторизация (Authorization)

Вопрос:

Что вам разрешено делать?

После входа система проверяет права.

Например:

Пользователь: alex
Группа: Board

Разрешено:

  • просмотр отчётов;
  • управление кооперативом;
  • просмотр платежей.

Простой способ запомнить:

Authentication = Кто ты?
Authorization = Что тебе можно?

Как выглядит процесс входа

Когда пользователь открывает сервис, происходит примерно такая последовательность:

Пользователь
      ↓
Authentik
      ↓
Проверка пароля
      ↓
Проверка 2FA
      ↓
Проверка групп
      ↓
Выдача токена
      ↓
Приложение

В большинстве случаев именно Authentik принимает решение, можно ли впустить пользователя.


Что такое фактор аутентификации

Фактор — это способ доказать свою личность.

Существует три основных категории.


То, что вы знаете

Например:

  • пароль;
  • PIN-код;
  • секретный ответ.

То, что у вас есть

Например:

  • телефон;
  • аппаратный ключ;
  • приложение-аутентификатор.

То, чем вы являетесь

Например:

  • отпечаток пальца;
  • лицо;
  • сетчатка глаза.

Что такое двухфакторная аутентификация (2FA)

2FA (Two-Factor Authentication) означает использование двух факторов одновременно.

Например:

Пароль
+
Код из телефона

Даже если злоумышленник узнает пароль, без телефона он не сможет войти.


Почему 2FA нужен даже дома

Часто можно услышать:

У меня домашний сервер, кому он нужен?

Но если на сервере есть:

  • почта;
  • семейные фотографии;
  • документы;
  • доступ к VPS;
  • VPN;

то компрометация одной учётной записи может дать доступ ко всей инфраструктуре.


Какие способы 2FA поддерживает Authentik

В Authentik есть несколько вариантов.


TOTP

Time-based One-Time Password.

Самый распространённый вариант.

Приложение каждые 30 секунд генерирует новый код.

Например:

482731

Через 30 секунд код станет другим.


Популярные приложения:

  • Aegis Authenticator
  • 2FAS
  • Google Authenticator
  • Microsoft Authenticator

WebAuthn

Современный стандарт аутентификации.

Поддерживает:

  • отпечаток пальца;
  • распознавание лица;
  • аппаратные ключи безопасности.

Passkeys

Passkeys — наиболее современный способ входа.

Фактически это развитие WebAuthn.

Пользователь может войти:

  • отпечатком пальца;
  • Face ID;
  • Windows Hello;
  • Touch ID.

Без ввода пароля.


Что я рекомендую для домашней инфраструктуры

На практике:

Для администратора

Обязательно:

  • пароль;
  • TOTP.

Дополнительно:

  • Passkeys.

Получается:

Пароль
+
TOTP
+
Passkey (по желанию)

Для семьи

Достаточно:

Пароль
+
TOTP

Для пожилых родственников

Иногда лучше оставить:

Только пароль

чем настроить сложную защиту, которую человек не сможет использовать.

Безопасность должна быть разумной.


Где управляются способы входа

В Authentik пользователь может настроить собственные устройства.

Откройте:

Каталог (Directory) → Пользователи (Users)

или свой профиль:

Пользователь (User) → Настройки (Settings)


Там появятся разделы вроде:

  • Пароли (Passwords)
  • TOTP Devices
  • WebAuthn Devices
  • Recovery Codes

Названия могут немного отличаться между версиями.


Что такое Recovery Codes

Очень важная вещь.

После настройки 2FA Authentik предложит сохранить резервные коды.

Например:

XF4P-A2KQ
L7MT-P8WN
...

Каждый код можно использовать один раз.


Представьте ситуацию:

  • телефон сломался;
  • приложение-аутентификатор удалено;
  • резервной копии нет.

Тогда именно Recovery Codes спасут доступ к системе.


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

На этом этапе не будем ничего ломать и перестраивать.

Наша цель — защитить администратора.


Шаг 1

Создайте отдельную учётную запись администратора.

Например:

admin

Шаг 2

Убедитесь, что у неё:

  • сложный пароль;
  • уникальный пароль.

Шаг 3

Войдите под этой учётной записью.


Шаг 4

Подключите TOTP через:

  • Aegis (Android)
  • 2FAS
  • Google Authenticator
  • Microsoft Authenticator

Шаг 5

Сохраните Recovery Codes.

Не на сервере.

Не в браузере.

Лучше:

  • распечатать;
  • сохранить в менеджере паролей;
  • хранить офлайн.

Практический пример для вашей инфраструктуры

Представим:

alex

Имеет доступ к:

  • Stocktorg
  • Immich
  • Nextcloud
  • Gramps
  • Кооперативной системе
  • Почте

Если пароль украден:

без 2FA злоумышленник получает доступ ко всему.


Если включён TOTP:

ему потребуется ещё и ваш телефон.


Частая ошибка новичков

Сначала подключают:

  • Immich;
  • Nextcloud;
  • Matrix;
  • десятки приложений.

И только потом думают о безопасности.

Правильный порядок обратный:

1. Пользователи
2. Группы
3. Защита аккаунтов
4. Интеграции

Что должно остаться в голове после третьей главы

Запомните три вещи:

Authentication = Кто вы?
Authorization = Что вам разрешено?
2FA = Защита от украденного пароля

И ещё одно правило:

Администратор Authentik без двухфакторной защиты — плохая идея даже для домашнего сервера.


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

Часть 4. Архитектура Authentik: Flows (Потоки), Stages (Этапы), Policies (Политики), Providers (Провайдеры) и Applications (Приложения).

Это самая сложная и самая важная глава курса. После неё интерфейс Authentik перестанет казаться набором случайных меню.

Authentik для начинающих. Часть 2. Пользователи (Users) и группы (Groups)

Часть 2. Пользователи (Users) и группы (Groups)

Версия курса: Authentik 2025.12.x


Зачем нужны пользователи и группы

После установки Authentik многие сразу пытаются подключить Nextcloud, Immich или другие сервисы.

Но все сервисы работают вокруг двух базовых сущностей:

  • Пользователь (User)
  • Группа (Group)

Если сравнить Authentik с паспортной системой государства, то:

  • User — это гражданин.
  • Group — это категория граждан.

Например:

Пользователь Группы
Александр Family, Admins
Жена Family
Бухгалтер Accountants
Председатель Board

Сам пользователь отвечает на вопрос:

Кто это?

Группа отвечает на вопрос:

Какие права он может получить?


Как я рекомендую организовать пользователей

Для ваших проектов лучше сразу строить структуру на перспективу.

Например:

Users
│
├── Александр
├── Жена
├── Сын
├── Бухгалтер
├── Председатель
└── Тестовый пользователь

Где находятся пользователи

Откройте:

Каталог (Directory) → Пользователи (Users)

или

Directory → Users

Здесь хранится список всех учётных записей.


Что такое пользователь (User)

Пользователь содержит информацию о человеке.

Типичные поля:

Русский Английский
Имя пользователя Username
Имя Name
Электронная почта Email
Активен Active
Суперпользователь Superuser
Группы Groups
Атрибуты Attributes

Username и Name — это не одно и то же

Очень частая ошибка новичков.

Например:

Поле Значение
Username alex
Name Александр Левченко

Username

Уникальный идентификатор.

Обычно используется для входа.

Пример:

alex

Name

Отображаемое имя.

Пример:

Александр Левченко

Его будут видеть приложения.


Что такое Superuser

Поле:

Суперпользователь (Superuser)

даёт полный доступ к Authentik.

Практический совет:

Создайте отдельную учётную запись администратора.

Например:

admin

А свою повседневную учётную запись используйте без прав суперпользователя.

Это безопаснее.


Создаём первого пользователя

Переходим:

Каталог (Directory) → Пользователи (Users)

Нажимаем:

Создать (Create)

Заполняем:

Поле Пример
Username test
Name Тестовый пользователь
Email test@example.com

Сохраняем.


Что такое группа (Group)

Группа объединяет пользователей.

Представьте многоквартирный дом.

Каждому человеку можно выдавать права отдельно.

Но гораздо удобнее создать группы:

  • Жильцы
  • Правление
  • Бухгалтерия
  • Охрана

И назначать права группе.


Где находятся группы

Откройте:

Каталог (Directory) → Группы (Groups)

или

Directory → Groups

Создаём структуру групп

Для вашего случая я бы рекомендовал такую схему.

Семья

Family

Члены семьи.


Администраторы

Admins

Управление инфраструктурой.


Кооператив

CooperativeMembers

Все члены кооператива.


Правление

Board

Правление кооператива.


Бухгалтерия

Accountants

Бухгалтеры.


Тестирование

TestUsers

Тестовые аккаунты.


Почему лучше английские названия групп

Технически можно писать:

Члены кооператива

Но лучше:

CooperativeMembers

Причины:

  • меньше проблем с интеграциями;
  • удобнее писать политики;
  • понятнее в логах;
  • легче использовать API.

Отображаемые названия потом можно сделать любыми.


Добавляем пользователя в группу

Откройте пользователя.

Поле:

Группы (Groups)

Добавьте:

Family

или

Board

После сохранения пользователь станет членом выбранной группы.


Атрибуты пользователя (Attributes)

Это одна из самых мощных возможностей Authentik.

Большинство новичков её игнорируют.


Что такое атрибут

Дополнительные данные о пользователе.

Например:

{
  "phone": "+380501234567",
  "apartment": "15",
  "member_id": "A-124",
  "role": "chairman"
}

Для кооператива это может оказаться очень полезным.

Например хранить:

  • номер участка;
  • номер квартиры;
  • членский номер;
  • телефон;
  • дату вступления;
  • статус оплаты.

Группы или атрибуты?

Новички часто путаются.

Используйте простое правило.


Если это права доступа

Используем группу.

Пример:

Board

Если это информация о человеке

Используем атрибут.

Пример:

Apartment 15

Правильно:

Group = Board
Attribute = Apartment 15

Неправильно:

Group = Apartment 15

Реальный пример для ваших сервисов

Представим пользователя:

Александр

Он состоит в группах:

Family
Admins
Board

Что это может дать:

Immich

Группа:

Family

Разрешён семейный альбом.


Nextcloud

Группа:

Family

Общий доступ к семейным документам.


Кооператив

Группа:

Board

Доступ к панели управления.


Authentik

Группа:

Admins

Доступ к настройкам инфраструктуры.


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

Создайте следующие группы:

Admins
Family
CooperativeMembers
Board
Accountants
TestUsers

Создайте пользователей:

alex
wife
accountant
chairman
test

Распределите по группам.

Например:

alex
├── Admins
├── Family
└── Board

После выполнения задания вы должны понимать:

  • что такое User;
  • что такое Group;
  • зачем нужны Attributes;
  • почему права удобнее назначать через группы.

Что должно остаться в голове после второй главы

Если забыть все детали, запомните главное:

User = конкретный человек
Group = роль человека
Attributes = данные о человеке

Именно вокруг этих трёх сущностей будет строиться практически вся дальнейшая работа с Authentik.


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

Часть 3. Аутентификация (Authentication), авторизация (Authorization), пароли, двухфакторная защита (2FA), TOTP и Passkeys.

После неё вы сможете правильно защитить свою инфраструктуру и подготовить Authentik к работе с реальными пользователями.

Authentik для начинающих. Часть 1. Что такое Authentik и зачем он нужен

Authentik: Полный практический курс для домашнего сервера и малого бизнеса

Версия курса: Authentik 2025.12.x


Введение

Многие впервые устанавливают Authentik и сразу сталкиваются с десятками незнакомых терминов:

  • Users
  • Groups
  • Flows
  • Policies
  • Providers
  • Applications
  • Sources
  • Outposts

После входа в административную панель возникает закономерный вопрос:

Что вообще делает Authentik и зачем он нужен?

Прежде чем создавать пользователей и подключать приложения, важно понять основную идею системы.


Что такое Authentik

Authentik — это система управления идентификацией пользователей (Identity Provider, IdP) и единым входом (Single Sign-On, SSO).

Простыми словами:

Authentik хранит информацию о пользователях и подтверждает другим сервисам, что пользователь действительно тот, за кого себя выдаёт.

Сам Authentik обычно не хранит ваши файлы, фотографии, письма или документы.

Его задача — отвечать на вопрос:

Кто этот пользователь и что ему разрешено делать?


Пример из реальной жизни

Представим несколько сервисов:

  • Интернет-магазин Stocktorg
  • Immich
  • Nextcloud
  • Gramps Web
  • Matrix / Element
  • Система управления кооперативом

Без Authentik каждый сервис хранит своих пользователей отдельно.

Без Authentik

Сервис Пользователи
Immich Своя база
Nextcloud Своя база
Gramps Своя база
Кооператив Своя база

Проблемы:

  • Нужно помнить много паролей.
  • Пользователей приходится создавать вручную в каждом сервисе.
  • При увольнении или удалении человека нужно удалить его везде.
  • Трудно настроить единые правила безопасности.

С Authentik

Теперь все сервисы доверяют Authentik.

                Authentik
                     │
      ┌──────────────┼──────────────┐
      │              │              │
   Immich       Nextcloud       Gramps
      │              │              │
      └──────────────┼──────────────┘
                     │
            Кооперативная система

Пользователь входит через Authentik один раз.

После этого остальные сервисы получают подтверждение личности автоматически.


Аналогия с паспортом

Очень полезная аналогия.

Представьте:

  • Authentik — паспортный стол.
  • Пользователь — гражданин.
  • Immich — гостиница.
  • Nextcloud — банк.
  • Кооперативная система — государственное учреждение.

Гостиница не выдаёт паспорт.

Банк не выдаёт паспорт.

Учреждение не выдаёт паспорт.

Все они доверяют документу, который выдал паспортный стол.

В этой схеме Authentik и есть паспортный стол.


Основные преимущества

1. Единый вход (SSO)

SSO (Single Sign-On) — единый вход.

Пользователь авторизуется один раз.

После этого может открывать разные сервисы без повторного ввода пароля.


2. Централизованное управление

Создание пользователя выполняется один раз.

Например:

Александр

Создали пользователя в Authentik.

Теперь он может использовать:

  • Immich
  • Nextcloud
  • Gramps
  • Кооперативную систему

без создания отдельных аккаунтов.


3. Единые правила безопасности

Например:

  • обязательная двухфакторная аутентификация;
  • минимальная длина пароля;
  • запрет старых паролей;
  • контроль доступа по группам.

Все эти правила задаются в одном месте.


4. Удобное управление ролями

Вместо настройки прав в каждом сервисе отдельно можно использовать группы.

Например:

Группа Family

Члены семьи.

Группа CooperativeMembers

Члены кооператива.

Группа Board

Правление кооператива.

Группа Accountants

Бухгалтерия.

Далее сервисы получают эти роли автоматически.


Важные термины

На этом этапе не нужно их глубоко изучать.

Важно только понимать назначение.

Английский Русский Назначение
User Пользователь Учётная запись
Group Группа Набор пользователей
Application Приложение Сервис, который подключается к Authentik
Provider Провайдер Способ связи приложения с Authentik
Flow Поток Сценарий входа
Policy Политика Правила доступа
Source Источник Внешний источник пользователей
Outpost Форпост Компонент для Proxy и LDAP

Самая частая ошибка новичков

Новички часто думают:

Сейчас создам Application и всё заработает.

На самом деле в Authentik существует цепочка объектов:

User
 ↓
Group
 ↓
Policy
 ↓
Flow
 ↓
Provider
 ↓
Application

Поэтому в начале обучения нужно понимать не отдельные меню, а взаимосвязь компонентов.


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

Пока ничего не подключаем.

Задача — просто познакомиться с интерфейсом.

Найдите в панели Authentik следующие разделы:

  • Directory → Users
  • Directory → Groups
  • Applications
  • Flows and Stages
  • Customization
  • System

Попробуйте открыть каждый раздел и посмотреть, какие объекты уже созданы системой по умолчанию.

Ничего не удаляйте и не изменяйте.

Цель задания — начать ориентироваться в структуре панели управления.


Что должно остаться в голове после первой главы

Если вы поняли только следующие три вещи — глава изучена успешно:

  1. Authentik не заменяет ваши сервисы, а управляет идентификацией пользователей.
  2. Все сервисы могут использовать одну учётную запись через Authentik.
  3. Основная задача Authentik — отвечать на вопросы:
    • Кто этот пользователь?
    • Что ему разрешено делать?

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

Часть 2. Пользователи (Users) и группы (Groups): создаём первую структуру доступа для семьи, магазина и кооператива.