Устранение неполадок

ℹ️ О разделе

В этом разделе описаны типичные проблемы, с которыми вы можете столкнуться при работе с IDENTYX, и способы их решения. Если описанные решения не помогли, обратитесь к системному администратору.

Проблемы с входом в систему

Неправильные учетные данные

⚠️ Симптомы

При попытке входа появляется сообщение «Аутентификация не пройдена» или «Неправильные учетные данные».

Возможные причины и решения:

  • Неверный пароль — убедитесь, что вы вводите правильный пароль. Проверьте раскладку клавиатуры и регистр букв (Caps Lock).
  • Неверное имя пользователя — проверьте правильность написания имени пользователя. Помните, что система различает регистр.
  • Использование email вместо username — если вы пытаетесь войти по email, убедитесь, что для вашей учетной записи включена возможность входа по email.
  • LDAP-формат входа — для входа через LDAP используйте формат DOMAIN\username или username@domain.

Учетная запись заблокирована

🚫 Симптомы

При попытке входа появляется сообщение «Учетная запись заблокирована».

Возможные причины и решения:

  • Превышено количество неудачных попыток входа — система автоматически блокирует учетную запись после нескольких неудачных попыток ввода пароля. Обратитесь к администратору для разблокировки.
  • Длительное отсутствие входа — если настроена автоматическая блокировка при неактивности, учетная запись может быть заблокирована после длительного отсутствия входов. Администратор может разблокировать учетную запись в разделе Субъекты доступа → Пользователи.
  • Административная блокировка — администратор мог заблокировать вашу учетную запись вручную. Обратитесь к администратору для выяснения причин.

Проблемы с двухфакторной аутентификацией

⚠️ Симптомы

Код двухфакторной аутентификации не принимается или не приходит на email.

Проблемы с TOTP (приложения-аутентификаторы):

  • Неверное время на устройстве — TOTP коды зависят от точного времени. Убедитесь, что время на вашем устройстве синхронизировано с точным временем (включите автоматическую синхронизацию времени).
  • Старый код — коды TOTP действительны только 30 секунд. Дождитесь генерации нового кода и попробуйте снова.
  • Потерян доступ к приложению-аутентификатору — обратитесь к администратору для сброса TOTP настроек.

Проблемы с Email 2FA:

  • Письмо не приходит — проверьте папку «Спам» или «Нежелательная почта». Убедитесь, что указан правильный email адрес в вашем профиле.
  • Код истек — коды имеют ограниченный срок действия. Запросите новый код.
  • Неверный email — убедитесь, что в вашем профиле указан правильный и подтвержденный email адрес.

Проблемы с LDAP/Active Directory

Не удается подключиться к LDAP

🚫 Симптомы

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

Возможные причины и решения:

  • Неверный адрес сервера — убедитесь, что адрес LDAP/AD сервера указан правильно в настройках домена. Проверьте доступность сервера из сети.
  • Неверные учетные данные сервисной учетной записи — проверьте правильность логина и пароля сервисной учетной записи для подключения к LDAP.
  • Сетевые проблемы — убедитесь, что сервер IDENTYX может достичь LDAP/AD сервера по сети. Проверьте настройки файрвола.
  • Неверное имя домена — убедитесь, что поле "Имя домена" заполнено правильно (например, example.com для AD или dc=example,dc=com для FreeIPA).
  • Проблемы с SSL/TLS — если используется защищенное подключение (LDAPS), убедитесь, что сертификат сервера действителен.

Пользователь не найден в LDAP

⚠️ Симптомы

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

Возможные причины и решения:

  • Пользователь находится в другом OU (организационном подразделении) — проверьте настройки поиска пользователей в конфигурации LDAP домена.
  • Пользователь отключен в AD — убедитесь, что учетная запись пользователя активна в Active Directory.
  • Недостаточно прав у сервисной учетной записи — убедитесь, что сервисная учетная запись имеет права на чтение информации о пользователях в LDAP.
  • Неверный формат имени пользователя — используйте правильный формат: DOMAIN\username или username@domain.com.

Проблемы с массовым импортом из LDAP

Возможные проблемы:

  • Не все пользователи импортированы — убедитесь, что сервисная учетная запись имеет доступ ко всем необходимым проектам.
  • Дубликаты пользователей — если пользователь уже существует в системе, он не будет импортирован повторно. Система проверяет уникальность по username.
  • Неверные данные пользователей — убедитесь, что в LDAP заполнены все обязательные поля (например, displayName).

Проблемы с доменом на площадке

⚠️ Симптомы

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

Проблема Возможные причины Решение
«Шлюз площадки «X» не на связи, поэтому контроллер домена сейчас недоступен». Пользователи на форме входа видят «Вход по доменной учётной записи сейчас недоступен, обратитесь к администратору» Шлюз на машине площадки остановлен, машина выключена или площадка потеряла сетевую связь. Контроллер домена при этом может быть полностью исправен Проверьте состояние площадки и её шлюза в приложении, которое их публикует (INFRAX), и восстановите связь. Настройки домена в IDENTYX менять не нужно: после восстановления связи вход и синхронизация продолжатся сами
В карточке домена красным: «Площадка не найдена в справочнике — вход через этот домен работать не будет», в списке площадка подписана «Площадка не найдена (<ключ>)», при сохранении — «Площадка не найдена в справочнике: <ключ>» Площадку отозвали или удалили в приложении. Публикация заменяет словарь площадок целиком, поэтому исчезнувшая площадка пропадает и из IDENTYX. Сохранить домен с неизвестной площадкой нельзя — это не обходится подтверждением Откройте карточку домена, выберите в поле Площадка действующую площадку либо очистите поле крестиком, чтобы вернуть домен к прямому подключению, и сохраните. Список площадок см. в разделе Словарь «Площадки»
LDAPS-домен на площадке не подключается, в тексте ошибки: «…положите сертификат УЦ (PEM) в /opt/identyx/data/ldap-ca и перезапустите identyx» Для домена на площадке имя сервера в сертификате не проверяется, поэтому подлинность контроллера домена подтверждает только его удостоверяющий центр. Пока сертификат УЦ не задан, подключение отклоняется Положите PEM-файл сертификата удостоверяющего центра в каталог /opt/identyx/data/ldap-ca и перезапустите IDENTYX. Галочка Не проверять сертификат (на всю установку) для домена на площадке не показывается и делу не помогает: при заданных сертификатах она отвергается с ошибкой
«Домен привязан к площадке «X», поэтому в поле «Адрес КД» нужен IP-адрес контроллера домена внутри площадки: имена при подключении через площадку не разрешаются. Сейчас указано «…»» либо «Для домена на площадке порт контроллера домена задаётся флагом LDAPS и равен 636, а в адресе указан 389…» В поле Адрес КД осталось DNS-имя или явно указан порт — обычно после переключения ранее работавшего домена на площадку Укажите в поле Адрес КД IP-адрес контроллера домена внутри сети площадки и не дописывайте порт: он определяется флагом LDAPS (порт 636)
ℹ️ Где смотреть подробности

Полный текст последней ошибки синхронизации виден в карточке домена в блоке Состояние синхронизации (кнопка Обновить), в строке Последняя ошибка. На форме входа причина намеренно не показывается — она записывается в журнал событий. Настройка домена на площадке описана в разделе Доменная авторизация через площадку.

Проблемы с OIDC приложениями

Ошибка перенаправления (redirect_uri)

🚫 Симптомы

При попытке входа в приложение через OIDC появляется ошибка «Неверный redirect_uri» или вы перенаправляетесь на неправильный адрес.

Возможные причины и решения:

  • URL не указан в разрешенных — убедитесь, что URL, на который перенаправляется пользователь после аутентификации, указан в списке разрешенных URL в настройках приложения (раздел Приложения → OIDC приложения).
  • Опечатка в URL — проверьте правильность написания URL. Даже один лишний слеш или неправильный протокол (http вместо https) может вызвать ошибку.
  • Параметры в URL — redirect_uri не должен содержать параметры запроса (query parameters). Используйте только базовый URL без параметров.

Истек срок действия токена

⚠️ Симптомы

Приложение сообщает, что токен истек или недействителен.

Решения:

  • Обновите токен — приложение должно использовать refresh token для получения нового access token.
  • Войдите заново — если refresh token также истек, потребуется повторная аутентификация.
  • Проверьте настройки времени жизни токенов — администратор может настроить время жизни токенов в параметрах системы.

Нет доступа к приложению

⚠️ Симптомы

После успешного входа приложение сообщает об отсутствии прав доступа.

Возможные причины и решения:

  • Не назначены права доступа — убедитесь, что вам (или вашей группе) назначены права на действия в данном приложении. Администратор может проверить и назначить права в разделе Права доступа.
  • Приложение не запрашивает scope permissions — приложение должно запрашивать scope permissions при аутентификации для получения информации о правах пользователя.
  • Изменились права после входа — если ваши права были изменены после входа в приложение, необходимо выйти и войти заново для обновления токена.

Проблемы с IDENTYX Proxy

⚠️ Симптомы

Приложение, работающее через IDENTYX Proxy, недоступно или работает некорректно.

Возможные причины и решения:

  • Неверный порт — убедитесь, что вы обращаетесь к правильному порту, указанному в настройках приложения (поле "Порт входящих подключений").
  • Конфликт портов — убедитесь, что порт не используется другим приложением или сервисом.
  • Неверные маршруты — проверьте настройки маршрутов в разделе "Маршруты прокси". Обязательно должен быть настроен маршрут для пути /.
  • Целевой сервер недоступен — убедитесь, что целевое приложение (указанное в маршрутах) работает и доступно.
  • Сервис прокси не запущен — обратитесь к администратору для проверки статуса сервиса прокси.

Проблемы с Email

Письма не отправляются

🚫 Симптомы

Система не отправляет письма (уведомления, коды подтверждения, сброс пароля).

Возможные причины и решения (для администраторов):

  • Неверные настройки SMTP — проверьте правильность настроек SMTP сервера в разделе Настройки → Email настройки:
    • Адрес SMTP сервера
    • Порт (обычно 25, 465, или 587)
    • Тип шифрования (none, SSL, TLS)
    • Логин и пароль для SMTP
  • SMTP сервер недоступен — убедитесь, что SMTP сервер доступен из сети, где установлен IDENTYX.
  • Блокировка файрволом — проверьте, что исходящие подключения к SMTP серверу не заблокированы файрволом.
  • Неверный адрес отправителя — убедитесь, что email адрес отправителя существует и разрешен для отправки с SMTP сервера.
  • Сервис отправки не запущен — проверьте статус сервиса send.emails.service в разделе Управление сервисом.

Проверка настроек:

  1. Перейдите в Настройки → Email настройки
  2. Нажмите кнопку Проверить отправку
  3. Укажите тестовый email адрес
  4. Проверьте результат тестовой отправки

Письма попадают в спам

⚠️ Симптомы

Письма от IDENTYX попадают в папку "Спам" у получателей.

Рекомендации для администраторов:

  • Настройте SPF, DKIM, DMARC — это записи DNS, которые подтверждают легитимность отправителя.
  • Используйте корректный адрес отправителя — используйте реальный email адрес из домена вашей проекты.
  • Избегайте спам-триггеров — не используйте большое количество восклицательных знаков, капслок и спам-слова в теме и тексте письма.
  • Настройте reverse DNS — убедитесь, что для IP адреса SMTP сервера настроена обратная DNS запись.

Проблемы с подтверждением email

⚠️ Симптомы

Ссылка для подтверждения email не работает или уже недействительна.

Решения:

  • Ссылка просрочена — ссылки для подтверждения действительны ограниченное время (обычно 1 час). Запросите повторную отправку письма с подтверждением в настройках профиля.
  • Ссылка повреждена — убедитесь, что вы скопировали ссылку полностью, без разрывов. Попробуйте скопировать ссылку напрямую из адресной строки письма.
  • Email уже подтвержден — возможно, вы уже подтвердили этот email ранее. Проверьте статус в настройках профиля.

Проблемы с производительностью

Медленный вход в систему

⚠️ Симптомы

Процесс входа в систему занимает много времени.

Возможные причины:

  • Медленный LDAP сервер — если используется LDAP аутентификация, проверьте скорость ответа LDAP/AD сервера.
  • Медленное сетевое подключение — проверьте качество сетевого соединения.
  • Высокая нагрузка на сервер — сервер IDENTYX может быть перегружен. Обратитесь к администратору для проверки нагрузки.
  • Большое количество прав доступа — если у пользователя или его групп очень много правил доступа, их вычисление может занять время.

Медленная работа интерфейса

⚠️ Симптомы

Административный интерфейс IDENTYX работает медленно, страницы долго загружаются.

Возможные причины и решения:

  • Медленное интернет-соединение — проверьте скорость вашего интернет-соединения.
  • Большое количество данных — при работе с большими таблицами (например, тысячи пользователей) используйте фильтры и поиск для уменьшения объема отображаемых данных.
  • Устаревший браузер — убедитесь, что вы используете современную версию браузера (Chrome, Firefox, Edge).
  • Расширения браузера — некоторые расширения могут замедлять работу. Попробуйте отключить расширения или использовать режим инкогнито.

Проблемы с сессиями

Частые выходы из системы

⚠️ Симптомы

Вас часто выбрасывает из системы, приходится входить заново.

Возможные причины:

  • Превышен лимит сессий — если настроено ограничение на количество одновременных сессий, при входе с нового устройства старые сессии закрываются. Закройте неиспользуемые сессии или обратитесь к администратору для увеличения лимита.
  • Истекло время сессии — сессии имеют ограниченное время жизни. После длительного бездействия потребуется повторный вход.
  • Блокировка экрана при неактивности — если для приложения настроена блокировка экрана при неактивности, вам нужно будет повторно войти после определенного времени бездействия.
  • Cookies отключены — убедитесь, что в вашем браузере включены cookies для сайта IDENTYX.

Не могу войти из-за превышения лимита сессий

🚫 Симптомы

При попытке входа появляется сообщение о превышении лимита одновременных сессий.

Решения:

  • Закройте старые сессии — попросите администратора принудительно завершить ваши активные сессии в разделе Сессии → IAM сессии.
  • Дождитесь истечения старых сессий — старые сессии автоматически закроются после истечения времени их действия.
  • Обратитесь к администратору — администратор может увеличить лимит одновременных сессий для вас или глобально в настройках безопасности.

Анализ логов

Журнал событий

Для диагностики проблем с аутентификацией и доступом используйте журнал событий безопасности:

  1. Перейдите в раздел Журнал событий
  2. Используйте фильтры для поиска событий:
    • По пользователю — найдите события конкретного пользователя
    • По типу события — отфильтруйте события аутентификации, управления пользователями и т.д.
    • По результату — посмотрите только неудачные попытки (ошибки)
    • По дате — укажите временной диапазон
    • По IP адресу — найдите события с конкретного IP
  3. Просмотрите детали события для понимания причины ошибки
ℹ️ Полезная информация

В журнале фиксируются следующие типы событий:

  • Успешные и неудачные попытки входа
  • Блокировки учетных записей
  • Изменения в учетных записях пользователей
  • Операции с правами доступа
  • События двухфакторной аутентификации
  • Завершение сессий

Расшифровка типичных сообщений об ошибках

Сообщение Значение Решение
Аутентификация не пройдена Неверные учетные данные Проверьте правильность логина и пароля
Учетная запись заблокирована Учетная запись отключена администратором или автоматически Обратитесь к администратору для разблокировки
В аутентификации пользователя отказано Пользователю запрещен вход выбранным методом Используйте другой метод входа или обратитесь к администратору
Пользователю не разрешено входить используя почту Для пользователя отключен вход по email Используйте username для входа или обратитесь к администратору
Пользователю не разрешено входить через ввод пароля Для пользователя отключен вход по паролю Используйте альтернативный метод аутентификации (LDAP, внешние провайдеры)
Домен не найден LDAP домен не существует или удален Проверьте правильность имени домена или обратитесь к администратору
У вас нет прав для доступа к этому домену Локальный администратор пытается получить доступ к домену другой проекты Обратитесь к суперадминистратору
Возникла непредвиденная ошибка Внутренняя ошибка сервера Обратитесь к системному администратору для проверки логов
Неверный redirect_uri URL перенаправления не разрешен для OIDC приложения Администратор должен добавить URL в список разрешенных
Код не прошел проверку Неверный код TOTP или код Email 2FA Проверьте правильность кода, убедитесь, что время на устройстве синхронизировано
Данная почта уже используется Email адрес уже зарегистрирован на другого пользователя Используйте другой email адрес
Ссылка просрочена Код подтверждения или ссылка истекли Запросите новую ссылку для подтверждения

Обращение за помощью

✅ Как получить помощь

Если описанные решения не помогли:

  1. Соберите информацию о проблеме:
    • Точное текст сообщения об ошибке
    • Шаги для воспроизведения проблемы
    • Время возникновения проблемы
    • Скриншоты (если применимо)
  2. Обратитесь к системному администратору — предоставьте собранную информацию
  3. Администратор может:
    • Проверить журнал событий
    • Просмотреть системные логи
    • Проверить конфигурацию системы
    • Связаться с технической поддержкой IDENTYX

Профилактические меры

Чтобы избежать проблем в будущем:

  • Используйте надежные пароли — создавайте сложные пароли и храните их в безопасности
  • Регулярно обновляйте пароли — меняйте пароли согласно политике безопасности проекты
  • Настройте 2FA — двухфакторная аутентификация значительно повышает безопасность
  • Подтверждайте email адрес — подтвержденный email позволяет восстановить доступ к учетной записи
  • Следите за активными сессиями — регулярно проверяйте и закрывайте неиспользуемые сессии
  • Используйте современный браузер — держите браузер обновленным для обеспечения безопасности и производительности
  • Очищайте кэш браузера — периодически очищайте кэш и cookies для предотвращения проблем