Загрузка

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)

Самый популярный вариант.


Примеры:

  • Google
  • 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

Что происходит:

  1. Redirect в Google
  2. Вход в Google
  3. Google возвращает данные
  4. Authentik создаёт пользователя

Что передаётся из OAuth

Обычно:

Поле Пример
email 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 системы
  • автоматическое создание аккаунтов

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

Часть 9. Proxy Outpost и реальные продакшн-схемы: Docker, Nginx, Traefik и защита всей инфраструктуры целиком (домашний сервер + кооператив + сайт).