Перейти к основному содержимому

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

Забытый пароль​

OpSee полностью делегирует аутентификацию Keycloak. Сброс пароля должен выполняться через Keycloak:

  • Если на странице входа отображается ссылка «Забыли пароль», нажмите её и пройдите процедуру сброса по электронной почте. Для этого в Keycloak должен быть настроен почтовый сервер.
  • Если ссылка для сброса не отображается, администратор Keycloak должен сбросить ваш пароль вручную: Keycloak Admin Console → Users → выберите вашу учётную запись → Credentials → Reset Password.

Сессия истекла​

Токены OAuth2 имеют ограниченное время жизни. Когда сессия истекает, запросы к API возвращают 401, и интерфейс может перенаправить вас на страницу входа без предупреждения.

Решение: явно выйдите из системы через меню аватара (в правом верхнем углу), затем войдите снова. Закрытие и повторное открытие вкладки браузера без предварительного выхода также может устранить устаревшую сессию.

401 на каждой странице после входа​

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

Решение:

  1. Откройте инструменты разработчика браузера → Application → Cookies — удалите все Cookie для домена OpSee.
  2. Откройте Local Storage — удалите все записи для домена OpSee.
  3. Закройте вкладку, откройте её снова и войдите ещё раз.

403 после входа (можно войти, но ничего не доступно)​

Ошибка 403 сразу после успешного входа в Keycloak означает, что учётная запись существует и аутентифицирована корректно, но в OpSee ей не назначены роли.

Решение: администратор Keycloak должен назначить роли вашей учётной записи:

  1. Откройте Keycloak Admin Console.
  2. Перейдите в Users → выберите вашу учётную запись → Role Mappings.
  3. Под клиентом OpSee назначьте подходящие роли (например, menu:production, menu:oee, menu:admin).
  4. Попросите пользователя выйти из системы и войти снова, чтобы новые роли вступили в силу.

Keycloak недоступен​

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

Решение:

  1. Подключитесь к серверу по SSH и выполните docker ps, чтобы посмотреть, какие контейнеры запущены.
  2. Если контейнер Keycloak отсутствует в списке или имеет статус Exited, перезапустите его: docker compose up -d keycloak.
  3. Просмотрите журналы контейнера Keycloak на предмет ошибок запуска: docker compose -f infra/docker-compose.yml logs keycloak.
  4. Подождите, пока Keycloak полностью запустится (это может занять 30–60 секунд), прежде чем снова пытаться войти.

Цикл перенаправлений​

Если браузер постоянно переключается между приложением OpSee и страницей входа Keycloak, не задерживаясь ни на одной из них, скорее всего, в OAuth2 Proxy или в настройках клиента Keycloak есть ошибка конфигурации.

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

  • URI перенаправления, зарегистрированный в клиенте Keycloak, не совпадает с фактическим URL приложения.
  • Секрет Cookie OAuth2 Proxy был изменён или отсутствует.
  • Переменная окружения SERVER_DOMAIN не соответствует домену, который использует браузер.

Решение: обратитесь к администратору инфраструктуры. Проблемы такого рода требуют доступа к конфигурации Docker Compose и к консоли администрирования Keycloak для исправления настроек клиента.