Общие параметры системы
В этом разделе описываются базовые настройки системы IDENTYX, включая название системы, URL для интеграций и временную зону.
Доступ к настройкам
Для доступа к настройкам системы:
- Войдите в систему под учетной записью администратора
- Перейдите в раздел Настройки через главное меню
- Откройте вкладку Настройки
- Найдите секцию Общее в дереве параметров
Изменение общих параметров системы доступно только пользователям с правами суперадминистратора IAM. Обычные пользователи и локальные администраторы не имеют доступа к этим настройкам.
Название системы
Параметр: system_name
Этот параметр определяет название системы, которое отображается в интерфейсе пользователя. По умолчанию установлено значение "Identyx", но вы можете изменить его на название вашей проекты или проекта.
Где отображается название системы
- Заголовок веб-интерфейса — в шапке административной панели
- Страница входа — при аутентификации пользователей
- Email-уведомления — в письмах, отправляемых системой
- Страница "О системе" — в информации о продукте
Как изменить название
- Перейдите в раздел Настройки → Настройки
- Разверните секцию Общее
- Найдите поле Название системы
- Введите новое название (например, "IAM Компания XYZ")
- Нажмите кнопку Сохранить внизу страницы
Используйте короткое и понятное название, которое легко идентифицируется вашими пользователями. Избегайте слишком длинных названий, которые могут некорректно отображаться в интерфейсе.
Эндпоинты для интеграций
Параметр: iam_url
Этот параметр определяет базовый URL вашей системы IDENTYX, который используется для интеграции с внешними приложениями и сервисами. URL должен быть доступен из сети, где работают интегрируемые приложения.
Для чего используется URL
Формирование эндпоинтов OpenID Connect для авторизации, токенов и информации о пользователе:
/oidc/authorize/oidc/token/oidc/userinfo/.well-known/openid-configuration
Формирование redirect_uri для российских OAuth провайдеров:
- Сбер ID:
/login/sber - ЕСИА:
/login/esia - Яндекс ID:
/login/yandex - VK ID:
/login/vk
Формирование ссылок в письмах для:
- Сброса пароля
- Подтверждения email
- Активации учетной записи
Автоматическое завершение сессий в приложениях при выходе пользователя из IAM системы.
Формат URL
URL должен соответствовать следующим требованиям:
- Начинаться с
https://(использование HTTP не рекомендуется по соображениям безопасности) - Содержать доменное имя или IP-адрес
- Не должен заканчиваться на слеш (
/) - Должен быть доступен из сети интегрируемых приложений
Примеры правильных URL:
https://iam.mycompany.ruhttps://identyx.example.comhttps://192.168.1.100https://iam.mycompany.ru:8443(с нестандартным портом)
При изменении URL системы необходимо обновить настройки во всех интегрированных приложениях и внешних OAuth провайдерах (Сбер ID, ЕСИА, VK ID и т.д.). В противном случае аутентификация работать не будет.
Работа в Docker окружении
Если IDENTYX развернут в Docker, параметр iam_url может быть переопределен через переменную окружения APP_IDENTYX_URL в файле docker-compose.yml. В этом случае значение из переменной окружения имеет приоритет над значением из базы данных.
environment:
- APP_IDENTYX_URL=https://iam.mycompany.ru
В интерфейсе настроек рядом с полем URL будет показано уведомление, если значение переопределено через переменную окружения.
Временная зона
Параметр: time_zone
Этот параметр определяет временную зону, в которой работает ваша проект. Временная зона используется для корректного отображения времени событий в журнале безопасности, времени создания сессий и других временных меток.
Значение по умолчанию
По умолчанию установлена временная зона Europe/Moscow (UTC+3).
Поддерживаемые временные зоны
IDENTYX поддерживает все стандартные временные зоны PHP. Полный список доступен в документации PHP: https://www.php.net/manual/ru/timezones.php
Примеры часто используемых временных зон:
| Временная зона | Описание | Смещение UTC |
|---|---|---|
Europe/Moscow |
Московское время | UTC+3 |
Europe/Samara |
Самарское время | UTC+4 |
Asia/Yekaterinburg |
Екатеринбургское время | UTC+5 |
Asia/Omsk |
Омское время | UTC+6 |
Asia/Krasnoyarsk |
Красноярское время | UTC+7 |
Asia/Irkutsk |
Иркутское время | UTC+8 |
Asia/Yakutsk |
Якутское время | UTC+9 |
Asia/Vladivostok |
Владивостокское время | UTC+10 |
Europe/Kaliningrad |
Калининградское время | UTC+2 |
UTC |
Всемирное координированное время | UTC+0 |
Как изменить временную зону
- Перейдите в раздел Настройки → Настройки
- Разверните секцию Общее
- Найдите поле Временная зона работы проекты
- Введите идентификатор временной зоны (например,
Asia/Yekaterinburg) - Нажмите кнопку Сохранить внизу страницы
- Дождитесь перезапуска сервиса (происходит автоматически после сохранения)
Изменение временной зоны влияет только на новые записи в журнале событий. Существующие записи сохраняют временные метки в той зоне, которая была активна на момент их создания.
Показывать раздел «Объекты доступа» в меню
Параметр: show_security_objects_menu
Этот параметр управляет отображением раздела «Объекты доступа» в боковом меню. По умолчанию этот раздел скрыт, так как предназначен для разработчиков, создающих кастомные интеграции с IDENTYX.
Когда включать этот параметр
Включите отображение раздела «Объекты доступа», если вам необходимо:
- Создавать кастомные объекты безопасности для интеграции приложений
- Управлять иерархией действий для кастомных правил доступа
- Просматривать полную структуру объектов и действий системы
- Отлаживать настройки прав доступа
Объекты и действия безопасности создаются автоматически при добавлении приложений, проектов и настройке прав доступа. Для обычного администрирования системы этот раздел не нужен.
Как включить отображение раздела
- Перейдите в раздел Настройки → Настройки
- Разверните секцию Общее
- Найдите параметр Показывать раздел «Объекты доступа» в меню
- Установите переключатель в положение Включено
- Нажмите кнопку Сохранить внизу страницы
- Обновите страницу (F5 или Ctrl+R) для применения изменений в меню
После сохранения настройки необходимо обновить страницу браузера, чтобы изменения в меню вступили в силу.
Что содержит раздел «Объекты доступа»
После включения в меню появятся два подраздела:
- Объекты — иерархическое дерево объектов безопасности (ресурсов системы)
- Действия — иерархическое дерево действий, которые можно выполнять над объектами
Подробная информация о работе с объектами и действиями доступна в разделе Объекты и действия безопасности.
Хранение данных
Секция Хранение данных задаёт, как долго система хранит записи, которые накапливаются сами по себе: журнал действий, завершённые сессии приложений и отметки об отправленных уведомлениях. Без ограничения срока такие записи копятся годами, занимают место и замедляют выборки.
Срок хранения журнала действий
Записи журнала старше указанного срока удаляются автоматически, по умолчанию — через 90 дней. Значение 0 отключает удаление, и журнал хранится бессрочно.
Журнал разбит на помесячные части. Когда часть целиком выходит за срок хранения, она удаляется одним действием, поэтому очистка занимает одинаковое время независимо от того, сколько записей накопилось — миллион или сто.
Какие события записывать
Два параметра определяют состав журнала:
- Не записывать в журнал события — выбранные события не попадают в журнал вовсе
- Записывать в журнал только неудачные события — для выбранных событий сохраняются лишь неудачные попытки, успешные не записываются
По умолчанию выключена запись события «Использование API»: приложения обращаются к IDENTYX за списками пользователей и учётными записями десятки тысяч раз в сутки, и все такие записи успешные. Отказы при этом сохраняются — они записываются событием «Проверка прав».
Отключённые события не попадут в журнал и не будут доступны при разборе инцидентов задним числом. Проверьте, не требует ли ваш регламент информационной безопасности хранить эти события.
Срок хранения завершённых сессий приложений
Завершённые сессии приложений старше указанного срока удаляются, по умолчанию — через 365 дней. Действующие сессии не удаляются никогда, независимо от возраста: пользователя не выкинет из системы. Значение 0 отключает удаление.
Срок хранения журнала отправки уведомлений
Записи об отправленных письмах и сообщениях в мессенджеры старше указанного срока удаляются, по умолчанию — через 180 дней. Значение 0 отключает удаление.
Сохранение настроек
После изменения любых параметров в разделе Общее:
- Нажмите кнопку Сохранить, расположенную в правом нижнем углу страницы
- Дождитесь сообщения "Параметры сохранены"
- Система автоматически перезапустит необходимые сервисы (может занять несколько секунд)
Изменения в настройках не применяются автоматически. Если вы закроете страницу настроек без нажатия кнопки Сохранить, все изменения будут потеряны.
Решение проблем
URL системы не работает после изменения
Причина: Интегрированные приложения используют старый URL или новый URL недоступен из сети.
Решение:
- Убедитесь, что новый URL доступен из браузера и из сети интегрированных приложений
- Проверьте настройки DNS и firewall
- Обновите
redirect_uriво всех OAuth провайдерах (Сбер ID, ЕСИА и т.д.) - Обновите настройки OIDC в интегрированных приложениях
Время в журнале отображается неправильно
Причина: Неправильно указана временная зона или изменения еще не применились.
Решение:
- Проверьте правильность написания идентификатора временной зоны (например,
Europe/Moscow, а неMoscow) - Убедитесь, что вы нажали кнопку Сохранить после изменения
- Дождитесь автоматического перезапуска сервиса
- Обновите страницу браузера (Ctrl+F5)
Теперь вы можете настроить параметры безопасности системы. Переходите к разделу Параметры безопасности для настройки политик паролей, двухфакторной аутентификации и других параметров безопасности.