Раздел Система → Настройки авторизации — место, где администратор смотрит, кто входил в систему, какие приложения имеют доступ, какими ключами подписываются токены, откуда разрешён внешний вход и какие сессии сейчас активны. Вкладки: “Журнал аудита”, “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-клиенты открыты сессии.
- “Последняя активность” – когда сессией пользовались в последний раз.
Над таблицей — сводка: сколько людей с сессиями и сколько сессий использовалось за последние минуты.