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
Шаг 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
Дальше:
- Redirect на Authentik
- Ввод логина
- Ввод пароля
- 2FA (если включено)
- Возврат в Nextcloud
Результат:
Пользователь автоматически создаётся или связывается.
Что происходит внутри (очень важно понять)
Authentik → проверяет пользователя
→ проверяет группы
→ создаёт токен
→ отдаёт Nextcloud
Атрибуты пользователя в OIDC
OIDC может передавать:
| Поле | Пример |
|---|---|
| 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 не знает пароль вообще
- доступ управляется централизованно