Authentik для начинающих. Часть 8. Sources — внешние пользователи (Google, LDAP, GitHub и другие)
Версия курса: Authentik 2025.12.x
Зачем нужна эта часть
До этого момента мы жили в мире, где:
- пользователи создаются вручную в Authentik
- группы тоже создаются вручную
- всё под контролем одной системы
Это хорошо для домашнего сервера.
Но в реальности часто нужно:
подключить внешние источники пользователей
Например:
- Google аккаунты
- корпоративный LDAP / Active Directory
- GitHub / GitLab логин
- внешние базы пользователей
Что такое Source (Источник)
Source (Источник) — это способ “подтянуть” пользователей извне.
Простое объяснение
Source = внешний поставщик пользователей
Пример
Google → Authentik → локальные сервисы
Где это в интерфейсе
Откройте:
Источники (Directory → Federation & Social Login)
или:
Directory → Federation & Social Login
Какие бывают Sources
1. OAuth Source (Google, GitHub, GitLab)
Самый популярный вариант.
Примеры:
- GitHub
- GitLab
2. LDAP Source
Для корпоративных сетей:
- Active Directory
- FreeIPA
- OpenLDAP
3. SAML Source
Используется в:
- крупных компаниях
- университетах
- государственных системах
4. Built-in Users (локальные)
Это те пользователи, которые мы создавали в Части 2.
Как работает Source
Поток данных
External Provider
↓
Authentik (Source)
↓
User created / linked
↓
Groups assigned
↓
Access to services
OAuth Source (самый важный для тебя)
Пример: Google login
Пользователь нажимает:
Login with Google
Что происходит:
- Redirect в Google
- Вход в Google
- Google возвращает данные
- Authentik создаёт пользователя
Что передаётся из OAuth
Обычно:
| Поле | Пример |
|---|---|
| alex@gmail.com | |
| name | Alexander |
| avatar | URL |
| id | Google ID |
Автоматическое создание пользователей
В Authentik можно включить:
- Create user on login
- Update user attributes
- Sync groups (если настроено)
LDAP Source (корпоративный уровень)
Где используется
Office network → Active Directory → Authentik
Что даёт LDAP
- единые пользователи в компании
- централизованная авторизация Windows/Linux
- интеграция с внутренними сервисами
Пример схемы
AD (Windows Server)
↓
Authentik LDAP Source
↓
Nextcloud / internal apps
GitHub Source (для разработчиков)
Пример
GitHub login → Authentik → доступ к dev tools
Полезно для:
- CI/CD систем
- внутренних dev панелей
- тестовых сред
Как связываются внешние пользователи с группами
Очень важный момент.
Автоматическое правило
Можно задать:
IF email endswith @stocktorg.com.ua
→ add to group Admins
Или вручную
После первого входа:
- пользователь появляется в Authentik
- ты добавляешь его в нужные группы
Сценарий для твоей системы
Вариант 1: семья
Google login → Family group
Вариант 2: кооператив
email domain → CooperativeMembers
Вариант 3: админы сайта
Stocktorg
GitHub login → Admins group
Безопасность Sources
Очень важно.
Риск №1
❌ Любой Google аккаунт получает доступ
Решение
- фильтр по email домену
- ручное подтверждение пользователей
- политики групп
Риск №2
❌ Автоматическое создание админов
Решение
default group = User
not Admin
Где это настраивается в Authentik
Основной раздел
Sources → Create
Настройки:
- Provider (Google / LDAP / GitHub)
- Mapping (как создавать пользователей)
- Group assignment rules
Mapping (очень важная часть)
Mapping = правила преобразования данных.
Пример:
return {
"username": email,
"name": name,
}
Или:
if email.endswith("@company.com"):
groups = ["Admins"]
Частые ошибки
Ошибка №1
❌ Подключили Google, но пользователи не создаются
Причина:
- не включен “Create users”
Ошибка №2
❌ Пользователь есть, но нет групп
Причина:
- не настроен mapping
Ошибка №3
❌ Все становятся Admin
Причина:
- неправильное правило групп
Как это выглядит в полной системе
Google / LDAP / GitHub
↓
Source
↓
Authentik Users
↓
Groups (Family / Board / Admins)
↓
Policies
↓
Applications
Практическое задание №8
Шаг 1
Выбрать источник:
- Google OAuth (рекомендуется)
Шаг 2
Создать Source в Authentik
Шаг 3
Настроить:
- client id
- client secret
- redirect URI
Шаг 4
Протестировать вход
Шаг 5
Добавить правила групп:
- Family
- Users
- Admins
Что должно остаться в голове
Source = внешний источник пользователей
Mapping = правила преобразования данных
Groups = назначение прав
Итог части 8
Теперь Authentik умеет:
- локальные пользователи
- внешние логины (Google / GitHub)
- корпоративные LDAP системы
- автоматическое создание аккаунтов