Загрузка

Часть 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 к работе с реальными пользователями.