Загрузка

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

Шаг 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

Дальше:

  1. Redirect на Authentik
  2. Ввод логина
  3. Ввод пароля
  4. 2FA (если включено)
  5. Возврат в Nextcloud

Результат:

Пользователь автоматически создаётся или связывается.


Что происходит внутри (очень важно понять)

Authentik → проверяет пользователя
        → проверяет группы
        → создаёт токен
        → отдаёт Nextcloud

Атрибуты пользователя в OIDC

OIDC может передавать:

Поле Пример
email 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 не знает пароль вообще
  • доступ управляется централизованно

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

Часть 6. Proxy Provider: защита любых сайтов (даже без поддержки SSO) + пример защиты Stocktorg и админ-панелей.