Общие параметры системы

ℹ️ О документе

В этом разделе описываются базовые настройки системы IDENTYX, включая название системы, URL для интеграций и временную зону.

Доступ к настройкам

Для доступа к настройкам системы:

  1. Войдите в систему под учетной записью администратора
  2. Перейдите в раздел Настройки через главное меню
  3. Откройте вкладку Настройки
  4. Найдите секцию Общее в дереве параметров
⚠️ Права доступа

Изменение общих параметров системы доступно только пользователям с правами суперадминистратора IAM. Обычные пользователи и локальные администраторы не имеют доступа к этим настройкам.

Название системы

Параметр: system_name

Этот параметр определяет название системы, которое отображается в интерфейсе пользователя. По умолчанию установлено значение "Identyx", но вы можете изменить его на название вашей проекты или проекта.

Где отображается название системы

  • Заголовок веб-интерфейса — в шапке административной панели
  • Страница входа — при аутентификации пользователей
  • Email-уведомления — в письмах, отправляемых системой
  • Страница "О системе" — в информации о продукте

Как изменить название

  1. Перейдите в раздел Настройки → Настройки
  2. Разверните секцию Общее
  3. Найдите поле Название системы
  4. Введите новое название (например, "IAM Компания XYZ")
  5. Нажмите кнопку Сохранить внизу страницы
✅ Рекомендация

Используйте короткое и понятное название, которое легко идентифицируется вашими пользователями. Избегайте слишком длинных названий, которые могут некорректно отображаться в интерфейсе.

Эндпоинты для интеграций

Параметр: iam_url

Этот параметр определяет базовый URL вашей системы IDENTYX, который используется для интеграции с внешними приложениями и сервисами. URL должен быть доступен из сети, где работают интегрируемые приложения.

Для чего используется URL

🔐 OIDC интеграция

Формирование эндпоинтов OpenID Connect для авторизации, токенов и информации о пользователе:

  • /oidc/authorize
  • /oidc/token
  • /oidc/userinfo
  • /.well-known/openid-configuration
🌐 OAuth провайдеры

Формирование redirect_uri для российских OAuth провайдеров:

  • Сбер ID: /login/sber
  • ЕСИА: /login/esia
  • Яндекс ID: /login/yandex
  • VK ID: /login/vk
📧 Email-уведомления

Формирование ссылок в письмах для:

  • Сброса пароля
  • Подтверждения email
  • Активации учетной записи
🔗 Backchannel Logout

Автоматическое завершение сессий в приложениях при выходе пользователя из IAM системы.

Формат URL

URL должен соответствовать следующим требованиям:

  • Начинаться с https:// (использование HTTP не рекомендуется по соображениям безопасности)
  • Содержать доменное имя или IP-адрес
  • Не должен заканчиваться на слеш (/)
  • Должен быть доступен из сети интегрируемых приложений

Примеры правильных URL:

  • https://iam.mycompany.ru
  • https://identyx.example.com
  • https://192.168.1.100
  • https://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

Как изменить временную зону

  1. Перейдите в раздел Настройки → Настройки
  2. Разверните секцию Общее
  3. Найдите поле Временная зона работы проекты
  4. Введите идентификатор временной зоны (например, Asia/Yekaterinburg)
  5. Нажмите кнопку Сохранить внизу страницы
  6. Дождитесь перезапуска сервиса (происходит автоматически после сохранения)
⚠️ Влияние на существующие записи

Изменение временной зоны влияет только на новые записи в журнале событий. Существующие записи сохраняют временные метки в той зоне, которая была активна на момент их создания.

Показывать раздел «Объекты доступа» в меню

Параметр: show_security_objects_menu

Этот параметр управляет отображением раздела «Объекты доступа» в боковом меню. По умолчанию этот раздел скрыт, так как предназначен для разработчиков, создающих кастомные интеграции с IDENTYX.

Когда включать этот параметр

Включите отображение раздела «Объекты доступа», если вам необходимо:

  • Создавать кастомные объекты безопасности для интеграции приложений
  • Управлять иерархией действий для кастомных правил доступа
  • Просматривать полную структуру объектов и действий системы
  • Отлаживать настройки прав доступа
ℹ️ Для обычного использования не требуется

Объекты и действия безопасности создаются автоматически при добавлении приложений, проектов и настройке прав доступа. Для обычного администрирования системы этот раздел не нужен.

Как включить отображение раздела

  1. Перейдите в раздел Настройки → Настройки
  2. Разверните секцию Общее
  3. Найдите параметр Показывать раздел «Объекты доступа» в меню
  4. Установите переключатель в положение Включено
  5. Нажмите кнопку Сохранить внизу страницы
  6. Обновите страницу (F5 или Ctrl+R) для применения изменений в меню
⚠️ Обновление страницы

После сохранения настройки необходимо обновить страницу браузера, чтобы изменения в меню вступили в силу.

Что содержит раздел «Объекты доступа»

После включения в меню появятся два подраздела:

  • Объекты — иерархическое дерево объектов безопасности (ресурсов системы)
  • Действия — иерархическое дерево действий, которые можно выполнять над объектами

Подробная информация о работе с объектами и действиями доступна в разделе Объекты и действия безопасности.

Хранение данных

Секция Хранение данных задаёт, как долго система хранит записи, которые накапливаются сами по себе: журнал действий, завершённые сессии приложений и отметки об отправленных уведомлениях. Без ограничения срока такие записи копятся годами, занимают место и замедляют выборки.

Срок хранения журнала действий

Записи журнала старше указанного срока удаляются автоматически, по умолчанию — через 90 дней. Значение 0 отключает удаление, и журнал хранится бессрочно.

ℹ️ Почему удаление не тормозит систему

Журнал разбит на помесячные части. Когда часть целиком выходит за срок хранения, она удаляется одним действием, поэтому очистка занимает одинаковое время независимо от того, сколько записей накопилось — миллион или сто.

Какие события записывать

Два параметра определяют состав журнала:

  • Не записывать в журнал события — выбранные события не попадают в журнал вовсе
  • Записывать в журнал только неудачные события — для выбранных событий сохраняются лишь неудачные попытки, успешные не записываются

По умолчанию выключена запись события «Использование API»: приложения обращаются к IDENTYX за списками пользователей и учётными записями десятки тысяч раз в сутки, и все такие записи успешные. Отказы при этом сохраняются — они записываются событием «Проверка прав».

⚠️ Прежде чем отключать событие

Отключённые события не попадут в журнал и не будут доступны при разборе инцидентов задним числом. Проверьте, не требует ли ваш регламент информационной безопасности хранить эти события.

Срок хранения завершённых сессий приложений

Завершённые сессии приложений старше указанного срока удаляются, по умолчанию — через 365 дней. Действующие сессии не удаляются никогда, независимо от возраста: пользователя не выкинет из системы. Значение 0 отключает удаление.

Срок хранения журнала отправки уведомлений

Записи об отправленных письмах и сообщениях в мессенджеры старше указанного срока удаляются, по умолчанию — через 180 дней. Значение 0 отключает удаление.

Сохранение настроек

После изменения любых параметров в разделе Общее:

  1. Нажмите кнопку Сохранить, расположенную в правом нижнем углу страницы
  2. Дождитесь сообщения "Параметры сохранены"
  3. Система автоматически перезапустит необходимые сервисы (может занять несколько секунд)
🚫 Не забывайте сохранять

Изменения в настройках не применяются автоматически. Если вы закроете страницу настроек без нажатия кнопки Сохранить, все изменения будут потеряны.

Решение проблем

URL системы не работает после изменения

Причина: Интегрированные приложения используют старый URL или новый URL недоступен из сети.

Решение:

  • Убедитесь, что новый URL доступен из браузера и из сети интегрированных приложений
  • Проверьте настройки DNS и firewall
  • Обновите redirect_uri во всех OAuth провайдерах (Сбер ID, ЕСИА и т.д.)
  • Обновите настройки OIDC в интегрированных приложениях

Время в журнале отображается неправильно

Причина: Неправильно указана временная зона или изменения еще не применились.

Решение:

  • Проверьте правильность написания идентификатора временной зоны (например, Europe/Moscow, а не Moscow)
  • Убедитесь, что вы нажали кнопку Сохранить после изменения
  • Дождитесь автоматического перезапуска сервиса
  • Обновите страницу браузера (Ctrl+F5)
✅ Готовы продолжить?

Теперь вы можете настроить параметры безопасности системы. Переходите к разделу Параметры безопасности для настройки политик паролей, двухфакторной аутентификации и других параметров безопасности.