IDENTYX Proxy
Этот раздел описывает функциональность IDENTYX Proxy — прозрачного прокси-сервера для приложений с автоматической аутентификацией и расширенными возможностями безопасности.
Что такое IDENTYX Proxy
IDENTYX Proxy — это встроенный прокси-сервер, который обеспечивает единую точку входа для всех ваших приложений с автоматической аутентификацией через IDENTYX.
Прокси-сервер работает как посредник между пользователем и вашим приложением, автоматически проверяя права доступа и обеспечивая безопасное соединение.
Преимущества использования Proxy
Пользователи автоматически проходят аутентификацию через IDENTYX перед доступом к приложению. Не нужно интегрировать OIDC в каждое приложение отдельно.
Все приложения автоматически публикуются через защищенное HTTPS соединение, даже если само приложение работает по HTTP.
Приложение не требует модификации — прокси автоматически добавляет информацию о пользователе в заголовки HTTP запросов.
Настройте различные маршруты для разных частей приложения с индивидуальными требованиями к авторизации.
Как работает Proxy
Схема работы IDENTYX Proxy:
- Пользователь обращается к приложению — вводит адрес приложения в браузере (например,
https://app.company.ru:3000) - Proxy проверяет авторизацию — если пользователь не авторизован, автоматически перенаправляет на страницу входа IDENTYX
- После успешной аутентификации — прокси получает токены доступа от IDENTYX
- Proxy перенаправляет запросы — все запросы пользователя передаются на целевое приложение
- Приложение получает данные о пользователе — через HTTP заголовки или специальные API эндпоинты
Приложение не требует изменений для интеграции с IDENTYX — весь процесс аутентификации берет на себя прокси-сервер.
Включение и отключение Proxy
При создании или редактировании OIDC приложения вы можете выбрать режим работы:
Режим с IDENTYX Proxy (рекомендуется)
В этом режиме приложение публикуется через встроенный прокси-сервер IDENTYX.
Настройка:
- Перейдите в раздел Приложения
- Создайте новое приложение или откройте существующее
- На вкладке Проксирование убедитесь, что флажок "Не использовать IDENTYX Proxy" не установлен
- Укажите Слушающий порт на IAM — порт, через который будет доступно приложение (например,
3000)
Приложение будет доступно по адресу: https://[адрес-identyx]:[указанный-порт]
Например, если IDENTYX установлен на iam.company.ru и указан порт 3000, приложение будет доступно по адресу https://iam.company.ru:3000
Режим без Proxy (прямое подключение)
В этом режиме приложение работает самостоятельно и напрямую интегрируется с IDENTYX через стандартный OIDC протокол.
Настройка:
- На вкладке Проксирование установите флажок "Не использовать IDENTYX Proxy"
- Укажите URL приложения — адрес, на который будет перенаправлен пользователь после аутентификации (например,
https://my-app.company.ru)
В этом режиме приложение должно самостоятельно реализовать OIDC клиент для интеграции с IDENTYX. Подробнее см. раздел OIDC интеграция.
Настройка маршрутов
Маршруты определяют, какие запросы и куда должен перенаправлять прокси-сервер.
Добавление маршрута
Пошаговая инструкция:
- Откройте карточку приложения
- Перейдите на вкладку Проксирование → подвкладка Маршруты
- Нажмите кнопку Добавить путь
- Заполните параметры маршрута
Параметры маршрута
| Параметр | Описание | Пример |
|---|---|---|
| HTTP Путь | Путь запроса, который должен обрабатываться этим маршрутом | / — все запросы/api — только API/admin — административная панель |
| Целевой сервер | URL сервера, на который будут перенаправлены запросы | http://localhost:8080http://192.168.1.100:3000 |
| Требовать авторизации | Флажок, определяющий нужна ли авторизация для доступа к этому пути | ✅ Включено — требуется вход ❌ Отключено — свободный доступ |
| Разрешить самоподписанный сертификат | Разрешить подключение к целевому серверу с самоподписанным SSL сертификатом | ✅ Включено — для тестовых серверов ❌ Отключено — только валидные сертификаты |
Приоритет маршрутов
Если несколько маршрутов могут подходить под один запрос, используется маршрут с самым длинным совпадающим путем.
Пример:
- Маршрут
/— обрабатывает все запросы - Маршрут
/api— обрабатывает запросы начинающиеся с/api - Маршрут
/api/admin— обрабатывает запросы начинающиеся с/api/admin
При запросе /api/admin/users будет выбран маршрут /api/admin, так как он наиболее специфичный.
Первый маршрут с путем / создается автоматически и не может быть удален. Он служит маршрутом по умолчанию для всех запросов.
Публичные маршруты (без авторизации)
Вы можете создать маршруты, которые не требуют авторизации. Это полезно для:
- Публичных страниц приложения
- API эндпоинтов для webhook'ов
- Статических ресурсов (CSS, JS, изображения)
- Health-check эндпоинтов для мониторинга
Настройка: Снимите флажок "Требовать авторизации" для нужного маршрута.
Настройки безопасности
IDENTYX Proxy предоставляет дополнительные функции безопасности для защиты ваших приложений.
Блокировка экрана при неактивности
Автоматическая блокировка экрана приложения, если пользователь неактивен определенное время.
Настройка:
- Перейдите на вкладку Безопасность
- Установите флажок "Блокировать экран приложения при бездействии пользователя"
- Укажите время бездействия в секундах (например,
300для 5 минут) - Опционально: установите флажок "Показывать предупреждение перед блокировкой экрана"
Если пользователь не производит действий (не двигает мышь, не нажимает клавиши) указанное время, экран приложения блокируется и отображается окно для повторного входа.
Ограничение количества сессий
Ограничьте количество одновременных сессий для каждого пользователя в приложении.
Настройка:
- На вкладке Безопасность установите флажок "Ограничить количество сессий для каждого пользователя"
- Укажите максимальное количество сессий (например,
3)
Поведение: При превышении лимита самая старая сессия пользователя автоматически закрывается.
Это ограничение относится только к данному приложению. Пользователь может иметь неограниченное количество сессий в других приложениях IDENTYX.
Передача IP-адреса клиента приложению
IDENTYX Proxy передает целевому приложению реальный IP-адрес пользователя в заголовках X-Real-IP и X-Forwarded-For. Приложение может использовать этот адрес, например, в собственных журналах и механизмах безопасности.
Защита от подделки: заголовки X-Forwarded-For и X-Real-IP, пришедшие вместе с запросом пользователя, прокси удаляет и вместо них проставляет единственное доверенное значение с вычисленным адресом клиента. Таким образом, приложение всегда получает адрес, определенный самим IDENTYX, а не значение, которое мог подставить клиент.
Способ вычисления адреса клиента задается параметром Определение IP клиента в разделе Настройки → секция Информационная безопасность → подсекция Прочее. Если IDENTYX установлен за балансировщиком или реверс-прокси, настройте там режим Доверенные прокси (список ниже) и укажите их адреса. Подробнее см. Параметры безопасности.
Внешний адрес приложения
Прокси сообщает приложению, по какому адресу его видит пользователь, заголовками X-Forwarded-Proto и X-Forwarded-Host. Значения берутся из поля Адрес перенаправления в карточке приложения. Такие же заголовки, пришедшие от пользователя или от внешнего балансировщика (X-Forwarded-Proto, X-Forwarded-Host, X-Forwarded-Port, X-Forwarded-Prefix, X-Forwarded-Scheme, X-Forwarded-Ssl, Forwarded), прокси удаляет. Поэтому пользователь не может подменить адрес, который видит приложение, а во внешнем реверс-прокси не нужно отдельно настраивать передачу X-Forwarded-Host.
Защита от межсайтовых запросов
Прокси отклоняет запросы, которые меняют данные в приложении от имени вошедшего пользователя, но отправлены со страницы постороннего сайта (код ответа 403, код ошибки cross_site_request). Запросы со страниц самого приложения, других приложений установки и IDENTYX, запросы с токеном, вебхуки и нативные клиенты проверку проходят. Режим задается параметром Защита от межсайтовых запросов (CSRF), подробнее см. Параметры безопасности.
Автозаполнение форм авторизации
IDENTYX Proxy может автоматически заполнять формы авторизации в проксируемых приложениях, используя сохраненные учетные записи пользователей.
Включение автозаполнения
Пошаговая инструкция:
- Откройте карточку приложения
- Перейдите на вкладку Авторизация
- В блоке «Автозаполнение форм входа» включите переключатель «Подставлять учётную запись в форму входа приложения»
В большинстве случаев автозаполнение работает автоматически без дополнительных настроек. IDENTYX автоматически обнаруживает стандартные формы входа.
Дополнительные опции автозаполнения
Эти переключатели появляются в блоке «Автозаполнение форм входа» после включения «Подставлять учётную запись в форму входа приложения».
| Опция | Описание |
|---|---|
| Скрыть оригинальную форму входа | Оригинальная форма входа полностью скрывается, пользователи могут войти только через учетные записи IDENTYX. Рекомендуется для корпоративных приложений. |
| Указать CSS-селекторы вручную | Включите только если автоматический поиск форм не работает. Открывает блоки «Селекторы полей» и «Как заполнять», где вручную указываются селекторы для полей входа и параметры заполнения. |
Ручное указание CSS-селекторов
Если автоматическое обнаружение форм не работает, вы можете вручную указать CSS селекторы.
Настройка:
- Включите переключатель «Указать CSS-селекторы вручную»
- В появившемся блоке «Селекторы полей» заполните следующие поля:
| Поле | Описание | Пример |
|---|---|---|
| Контейнер формы | Селектор для контейнера с полями входа (может быть form, div, dialog) | form#login.auth-container[role=dialog] |
| Поле логина | Селектор для поля ввода имени пользователя или email | input[name='username']#login |
| Поле пароля | Селектор для поля ввода пароля | input[type='password']#password |
| Кнопка входа | Селектор для кнопки входа (необязательно) | button[type='submit'].login-button |
Дополнительные настройки автозаполнения
Эти параметры находятся в блоке «Как заполнять». Он появляется вместе с блоком «Селекторы полей» — только после включения переключателя «Указать CSS-селекторы вручную». Пока переключатель выключен, действуют ранее сохраненные значения; у нового приложения это 500 мс перед заполнением, 300 мс перед отправкой и автоматическая отправка формы.
| Параметр | Описание | Рекомендуемое значение |
|---|---|---|
| Задержка перед заполнением, мс | Время ожидания перед автоматическим заполнением полей | 500-1000 мс для динамических форм |
| Задержка перед отправкой, мс | Время ожидания после заполнения полей перед отправкой формы | 300-500 мс |
| Отправлять форму автоматически | Форма отправляется автоматически или требуется ручное нажатие кнопки | Включено (для полностью автоматического входа) |
Для автозаполнения IDENTYX Proxy ищет универсальную учетную запись пользователя (тип «Универсальная»), сохраненную для самого приложения, а не для отдельных его объектов. Записи с типом подключения (RDP, SSH и другие) и записи на объектах внутри приложения сами не подставляются. Личная запись берется раньше групповой. Если подбор дает ровно одну запись, форма заполняется после трёхсекундной паузы, во время которой вход можно прервать кнопкой «Отмена».
Если такой записи нет или их несколько, на странице входа появляется подсказка «IDENTYX обнаружил форму входа» с кнопкой «Войти с IDENTYX» (при включенном «Скрыть оригинальную форму входа» — карточка «Добро пожаловать» с кнопкой «Войти в систему»). Кнопка открывает окно «Выбор учётной записи» для этого приложения: в строке «Объект» — название приложения, в списке — учетные записи, сохраненные для него (ваши личные и записи ваших групп), и пункт «Ручной ввод». Записи узлов, папок и других объектов здесь не предлагаются. Если для приложения еще нет ни одной записи, вместо списка сразу открывается форма «Новая учетная запись». Выбранная или введенная запись подставляется в форму входа после той же трёхсекундной паузы.
Чтобы в следующий раз форма заполнялась сама, сохраните запись для приложения: в этом окне выберите «Ручной ввод» (если записей еще нет, форма уже открыта), введите логин и пароль, отметьте «Сохранить как новую учетную запись», в разделе «Дополнительные настройки» оставьте тип «Универсальная» и нажмите «Ок». Запись сохранится для приложения, а данные сразу уйдут в форму входа. В форме есть поле «Тип владельца» (по умолчанию «Личная»): если выбрать «Групповая» и указать группу, запись получат участники группы. Если флажок не отмечать, данные подставятся один раз и не сохранятся.
Свои сохраненные учетные записи пользователь видит в меню «Мои» → «Секреты» на вкладке «Хранилище секретов»; у записи, сохраненной для приложения, в столбце «Объект» стоит название приложения. Там запись можно изменить или удалить — например, если у вас несколько личных записей для приложения и форма поэтому сама не заполняется.
Согласие с публичной офертой
Вы можете требовать от пользователей согласия с условиями использования приложения перед первым входом.
Настройка оферты
Пошаговая инструкция:
- Откройте карточку приложения
- Перейдите на вкладку Оферта
- Установите флажок "Требовать согласие с публичной офертой"
- В поле "Текст публичной оферты" введите условия использования
- Опционально: укажите заголовок на странице согласия (если не указан, используется заголовок по умолчанию)
Поведение при изменении оферты
Изменение текста оферты даже на 1 символ приведет к тому, что все пользователи, ранее принявшие оферту, должны будут принять новую версию перед продолжением работы.
Как это работает:
- Пользователь впервые заходит в приложение
- Перед доступом к приложению отображается страница с текстом оферты
- Пользователь должен нажать кнопку "Я согласен"
- После согласия пользователь получает доступ к приложению
- Повторное согласие не требуется, пока текст оферты не изменится
Дополнительные настройки
Обработка внутренних редиректов
На вкладке Дополнительно доступна настройка "Автоматически обрабатывать внутренние редиректы".
Рекомендуется включить. Эта опция позволяет корректно работать с приложениями, которые используют абсолютные URL для редиректов (например, VMware vCenter, Proxmox, GitLab).
Как это работает: Прокси автоматически перехватывает редиректы на внутренние адреса приложения и переписывает их на относительные URL, чтобы пользователь оставался на адресе прокси.
Отключите эту опцию только если возникают проблемы с авторизацией через внешние SSO-системы (например, OAuth от Google, Microsoft), которые требуют редиректов на свои домены.
REST endpoints для интеграции
На вкладке Проксирование → подвкладка Перенаправления доступны настройки для глубокой интеграции с приложением:
| Endpoint | Описание |
|---|---|
| REST endpoint для информации о новой сессии | URL в вашем приложении, куда IDENTYX Proxy будет отправлять информацию о пользователе при создании новой сессии (POST запрос с данными пользователя, токенами доступа) |
| REST endpoint для закрытия сессии | URL в вашем приложении, куда IDENTYX Proxy будет отправлять уведомление о закрытии сессии пользователя |
Поля можно оставить пустыми, если ваше приложение не требует этих уведомлений.
Типичные сценарии использования
Публикация внутреннего приложения
Задача: Нужно опубликовать внутреннее веб-приложение компании (например, корпоративную wiki на порту 8080) с авторизацией через IDENTYX.
Решение:
- Создайте новое OIDC приложение с названием "Корпоративная Wiki"
- Оставьте включенным режим с IDENTYX Proxy
- Укажите слушающий порт, например
3001 - На вкладке Маршруты в корневом маршруте укажите целевой сервер
http://localhost:8080 - Убедитесь, что флажок "Требовать авторизации" установлен
- Сохраните приложение
Результат: Приложение доступно по адресу https://[ваш-identyx]:3001 с автоматической авторизацией.
Приложение с публичным API
Задача: Приложение имеет публичный API эндпоинт /api/webhook, который должен быть доступен без авторизации, но остальная часть приложения требует входа.
Решение:
- Создайте корневой маршрут
/с целевым сервером и требованием авторизации - Добавьте дополнительный маршрут
/api/webhookс тем же целевым сервером, но без требования авторизации
Результат: Путь /api/webhook доступен публично, все остальные пути требуют авторизации.
Критичное приложение с автоблокировкой
Задача: Финансовое приложение должно автоматически блокироваться после 5 минут неактивности пользователя.
Решение:
- На вкладке Безопасность включите "Блокировать экран приложения при бездействии пользователя"
- Укажите
300секунд (5 минут) - Включите "Показывать предупреждение перед блокировкой экрана"
Результат: Если пользователь не производит действий 5 минут, появится предупреждение, а затем экран заблокируется.
Решение проблем
Проблема: Прокси не может подключиться к приложению.
Что видит пользователь: страницу «Приложение пока недоступно» с текстом «Приложение не отвечает». Страница сама повторяет попытку — сначала через 10 секунд, затем реже, до раза в минуту — и откроет приложение, как только оно ответит. Обновлять её вручную не нужно.
Решение:
- Проверьте, что целевой сервер доступен с машины, где установлен IDENTYX
- Убедитесь, что URL в поле "Целевой сервер" указан корректно
- Если целевой сервер использует самоподписанный сертификат, установите флажок "Разрешить самоподписанный сертификат"
Проблема: Браузер сообщает о слишком многих редиректах.
Решение:
- Проверьте, что в приложении не настроен принудительный редирект на HTTPS, если оно работает за прокси
- Убедитесь, что приложение корректно обрабатывает заголовок
X-Forwarded-Proto
Проблема: Действие в приложении не выполняется, в ответе сервера код 403 и cross_site_request.
Решение:
- Найдите в журнале прокси приложения строку «Межсайтовый запрос»: в ней указан источник запроса (
Origin) - Если запрос отправляет страница вашей внешней системы, это и есть межсайтовый запрос: переведите интеграцию на токен (
Authorization: Bearer) - Если пользователь открыл приложение по другому адресу в устаревшем браузере, откройте его по адресу из поля Адрес перенаправления или обновите браузер
- На время разбора можно включить режим Только журнал (см. Параметры безопасности)
Проблема: Форма входа не заполняется автоматически.
Решение:
- Убедитесь, что в карточке приложения включен переключатель «Подставлять учётную запись в форму входа приложения»
- Сама подставляется только универсальная учетная запись, сохраненная для самого приложения. Если такой записи нет, нажмите «Войти с IDENTYX» (или «Войти в систему», если оригинальная форма входа скрыта), выберите «Ручной ввод» (если записей для приложения еще нет, форма откроется сразу), отметьте «Сохранить как новую учетную запись» и нажмите «Ок» — со следующего входа форма будет заполняться сама. Если подбор дает несколько записей, форма каждый раз ждет выбора: лишние личные записи удалите на странице «Секреты»; если лишние — записи групп, удалите ненужные там же, в «Групповые», или сохраните одну свою личную универсальную запись для приложения: личные проверяются раньше групповых
- Если подсказка IDENTYX не появляется, значит, форма входа не найдена: включите переключатель «Указать CSS-селекторы вручную» и укажите точные селекторы в блоке «Селекторы полей»
- Если форма загружается динамически, увеличьте «Задержка перед заполнением, мс» в блоке «Как заполнять» — он виден при включенном переключателе «Указать CSS-селекторы вручную». Если ручные селекторы не нужны, после изменения задержки выключите этот переключатель: с ним форма ищется только по селекторам из блока «Селекторы полей», а сохранённая задержка действует и без него
Проблема: Пользователя постоянно выбрасывает на страницу входа.
Решение:
- Проверьте настройку "Ограничить количество сессий" — возможно, лимит слишком низкий
- Убедитесь, что блокировка при неактивности не слишком агрессивная
- Проверьте, нет ли конфликта между сессией прокси и сессией приложения
Теперь вы знаете, как использовать IDENTYX Proxy для публикации приложений. Переходите к разделу Настройки приложения для изучения дополнительных параметров OIDC приложений.