Устранение неполадок
В этом разделе описаны типичные проблемы, с которыми вы можете столкнуться при работе с 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в разделе Управление сервисом.
Проверка настроек:
- Перейдите в Настройки → Email настройки
- Нажмите кнопку Проверить отправку
- Укажите тестовый email адрес
- Проверьте результат тестовой отправки
Письма попадают в спам
Письма от 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 сессии.
- Дождитесь истечения старых сессий — старые сессии автоматически закроются после истечения времени их действия.
- Обратитесь к администратору — администратор может увеличить лимит одновременных сессий для вас или глобально в настройках безопасности.
Анализ логов
Журнал событий
Для диагностики проблем с аутентификацией и доступом используйте журнал событий безопасности:
- Перейдите в раздел Журнал событий
- Используйте фильтры для поиска событий:
- По пользователю — найдите события конкретного пользователя
- По типу события — отфильтруйте события аутентификации, управления пользователями и т.д.
- По результату — посмотрите только неудачные попытки (ошибки)
- По дате — укажите временной диапазон
- По IP адресу — найдите события с конкретного IP
- Просмотрите детали события для понимания причины ошибки
В журнале фиксируются следующие типы событий:
- Успешные и неудачные попытки входа
- Блокировки учетных записей
- Изменения в учетных записях пользователей
- Операции с правами доступа
- События двухфакторной аутентификации
- Завершение сессий
Расшифровка типичных сообщений об ошибках
| Сообщение | Значение | Решение |
|---|---|---|
Аутентификация не пройдена |
Неверные учетные данные | Проверьте правильность логина и пароля |
Учетная запись заблокирована |
Учетная запись отключена администратором или автоматически | Обратитесь к администратору для разблокировки |
В аутентификации пользователя отказано |
Пользователю запрещен вход выбранным методом | Используйте другой метод входа или обратитесь к администратору |
Пользователю не разрешено входить используя почту |
Для пользователя отключен вход по email | Используйте username для входа или обратитесь к администратору |
Пользователю не разрешено входить через ввод пароля |
Для пользователя отключен вход по паролю | Используйте альтернативный метод аутентификации (LDAP, внешние провайдеры) |
Домен не найден |
LDAP домен не существует или удален | Проверьте правильность имени домена или обратитесь к администратору |
У вас нет прав для доступа к этому домену |
Локальный администратор пытается получить доступ к домену другой проекты | Обратитесь к суперадминистратору |
Возникла непредвиденная ошибка |
Внутренняя ошибка сервера | Обратитесь к системному администратору для проверки логов |
Неверный redirect_uri |
URL перенаправления не разрешен для OIDC приложения | Администратор должен добавить URL в список разрешенных |
Код не прошел проверку |
Неверный код TOTP или код Email 2FA | Проверьте правильность кода, убедитесь, что время на устройстве синхронизировано |
Данная почта уже используется |
Email адрес уже зарегистрирован на другого пользователя | Используйте другой email адрес |
Ссылка просрочена |
Код подтверждения или ссылка истекли | Запросите новую ссылку для подтверждения |
Обращение за помощью
Если описанные решения не помогли:
- Соберите информацию о проблеме:
- Точное текст сообщения об ошибке
- Шаги для воспроизведения проблемы
- Время возникновения проблемы
- Скриншоты (если применимо)
- Обратитесь к системному администратору — предоставьте собранную информацию
- Администратор может:
- Проверить журнал событий
- Просмотреть системные логи
- Проверить конфигурацию системы
- Связаться с технической поддержкой IDENTYX
Профилактические меры
Чтобы избежать проблем в будущем:
- Используйте надежные пароли — создавайте сложные пароли и храните их в безопасности
- Регулярно обновляйте пароли — меняйте пароли согласно политике безопасности проекты
- Настройте 2FA — двухфакторная аутентификация значительно повышает безопасность
- Подтверждайте email адрес — подтвержденный email позволяет восстановить доступ к учетной записи
- Следите за активными сессиями — регулярно проверяйте и закрывайте неиспользуемые сессии
- Используйте современный браузер — держите браузер обновленным для обеспечения безопасности и производительности
- Очищайте кэш браузера — периодически очищайте кэш и cookies для предотвращения проблем