Настройки авторизации

Журнал аудита, OAuth-клиенты, JWKS, провайдеры входа и сессии

bg-dots
bg-dots

Раздел Система → Настройки авторизации — место, где администратор смотрит, кто входил в систему, какие приложения имеют доступ, какими ключами подписываются токены, откуда разрешён внешний вход и какие сессии сейчас активны. Вкладки: “Журнал аудита”, “OAuth-клиенты”, “JWKS”, “Провайдеры входа”, “Сессии”.

Журнал аудита

Хронология событий входа и управления доступом. Нужна, чтобы ответить на вопросы: «кто вошёл», «почему вход не удался», «кто создал/удалил OAuth-клиента», «когда ротировали ключи».

Фильтры

  • “Тип события” – сужает список до одного кода. Типовые группы:
    • вход: login, login_failed, logout;
    • токены: token_issued, token_refreshed, token_revoked, token_introspected, refresh_replay;
    • пароль и 2FA: password_changed, totp_enrolled, totp_disabled, totp_recovery_used;
    • OAuth-клиенты и провайдеры: client_*, provider_*;
    • роли и учётные записи: role_*, identity_*, admin_*;
    • ключи и сессии: jwks_*, session_expired, client_session_policy_updated, sso_admin_role_removed.
  • “Пользователь” – только события выбранной учётной записи.
  • “С (UTC)” / “По (UTC)” – период в UTC.

Таблица

  • “Время” – когда произошло событие.

  • “Событие” – код события.

  • “Инициатор” – кто выполнил действие.

  • “IP” – адрес, с которого пришёл запрос.

  • “Экспорт CSV” – выгрузка текущего отбора в файл для разбора вне интерфейса.

  • “← Назад” / “Далее →” – страницы журнала.

OAuth-клиенты

Список приложений, которым разрешено получать токены у службы аутентификации (веб-кабинет, мобильные и desktop-клиенты и свои интеграции). Без записи в этом списке приложение не сможет пройти OAuth-вход через сервер.

  • “ID” – технический идентификатор клиента.
  • “Название” – понятное имя в списке.
  • “Тип” – confidential (есть секрет) или public (без секрета, обычно с PKCE).
  • “Разрешения” – какие grant types разрешены (например authorization_code, refresh_token).
  • “Активен” – “Да” / “Нет”; неактивный клиент токены не выдаёт.
  • “Изменить” / “Удалить” – правка или удаление.
  • “Создать клиента” – форма нового клиента.

Создание OAuth-клиента

  • “Тип клиента” – “Публичный — без секрета, требуется PKCE-S256 (нативные приложения, SPA)” или “Конфиденциальный — сгенерированный секрет или private_key_jwt”.
  • “Название” – имя в списке.
  • “URI перенаправления (по одному в строке)” – адреса, на которые IdP может вернуть браузер после входа; лишний URI отклонит обмен кода.
  • “Типы разрешений” – флажки authorization_code, refresh_token, client_credentials.
  • “Области доступа (через пробел)” – scopes, которые клиент может запросить.
  • “Срок действия access token (секунды)” – время жизни access-токена.
  • “Методы аутентификации” – как клиент доказывает свою личность: client_secret_basic, client_secret_post, private_key_jwt.
  • “Отменить” – закрыть без создания.
  • “Создать” – сохранить клиента.

Шаг 1. На вкладке “OAuth-клиенты” нажать “Создать клиента”.
Шаг 2. Выбрать тип, указать “Название”, redirect URI, grant types и scopes.
Шаг 3. Нажать “Создать” и убедиться, что строка появилась в таблице.

JWKS

Ключи, которыми служба подписывает JWT. Клиенты и ресурcы проверяют подпись по набору ключей JWKS. На вкладке видны счётчики активных и выведенных ключей.

  • “kid” – идентификатор ключа в наборе.
  • “alg” – алгоритм подписи (например RS256).
  • “статус” – например “активный”.
  • “действует с” / “действует до” – окно действия ключа.
  • “Ротировать” – плавная смена ключей: старый ключ ещё некоторое время остаётся в наборе (на срок жизни access token), чтобы уже выданные токены продолжали проверяться.
  • “Отозвать” – немедленно убрать ключ из доверенных (после отзыва токены с этой подписью перестанут приниматься).

Ротацию выполняют планово или при компрометации; отзыв — когда ключ нужно вывести из обращения сразу.

Провайдеры входа

Подключение внешнего IdP (корпоративный OIDC / OAuth 2.0), чтобы администраторы или пользователи входили через него, а не только локальным паролем. Пока провайдеры не заданы, на вкладке сообщение “Провайдеры входа не настроены.”

  • “Добавить провайдер” – открыть форму.

Добавление провайдера

  • “Название” – имя в списке.
  • “Тип” – “OIDC” или “OAuth 2.0”.
  • “URL издателя” – issuer URL провайдера (откуда читаются метаданные).
  • “Идентификатор клиента” – client ID, выданный у провайдера.
  • “Секрет клиента (только запись)” – client secret; после сохранения значение снова не показывается.
  • “Области доступа (через пробел)” – scopes запроса к провайдеру.
  • “Сопоставление атрибутов (JSON)” – как поля профиля IdP соответствуют полям пользователя на сервере.
  • “Сопоставление ролей (JSON)” – как роли/группы IdP превращаются в роли на сервере.
  • “Автоматически создавать пользователей” – при первом успешном входе заводить учётную запись, если её ещё нет.
  • “Включён” – провайдер участвует в сценарии входа.
  • “Проверить метаданные” – запросить discovery у издателя и убедиться, что URL доступен и корректен.
  • “Отменить” / “Сохранить” – закрыть без записи или сохранить.

Сессии

Кто сейчас (или недавно) имел активные сессии: системные пользователи админки, абоненты, SSO. Строка выбирается кликом; действия пишутся в журнал аудита от имени текущей учётной записи администратора.

  • “Фильтр” – “все типы”, “Системный пользователь”, “Абонент”, “SSO”.
  • “активные за заданный сервером период” – только сессии в окне недавней активности.
  • “по людям” – группировка строк по пользователям.
  • “автообновление” – список обновляется сам.
  • “Обновить” – обновить вручную.

Таблица

  • “Пользователь” – учётная запись.
  • “Тип” – тип субъекта (например user).
  • “Сессии” – всего и активных.
  • “Клиенты” – через какие OAuth-клиенты открыты сессии.
  • “Последняя активность” – когда сессией пользовались в последний раз.

Над таблицей — сводка: сколько людей с сессиями и сколько сессий использовалось за последние минуты.

Пользователи Электронная почта