Часть 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 |
| Электронная почта | |
| Активен | Active |
| Суперпользователь | Superuser |
| Группы | Groups |
| Атрибуты | Attributes |
Username и Name — это не одно и то же
Очень частая ошибка новичков.
Например:
| Поле | Значение |
|---|---|
| Username | alex |
| Name | Александр Левченко |
Username
Уникальный идентификатор.
Обычно используется для входа.
Пример:
alex
Name
Отображаемое имя.
Пример:
Александр Левченко
Его будут видеть приложения.
Что такое Superuser
Поле:
Суперпользователь (Superuser)
даёт полный доступ к Authentik.
Практический совет:
Создайте отдельную учётную запись администратора.
Например:
admin
А свою повседневную учётную запись используйте без прав суперпользователя.
Это безопаснее.
Создаём первого пользователя
Переходим:
Каталог (Directory) → Пользователи (Users)
Нажимаем:
Создать (Create)
Заполняем:
| Поле | Пример |
|---|---|
| Username | test |
| Name | Тестовый пользователь |
| 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.
Следующая глава
После неё вы сможете правильно защитить свою инфраструктуру и подготовить Authentik к работе с реальными пользователями.