Настройки webSocket¶

Проверка доступности webSocket¶

1. Чтобы проверить доступность WebSocket, в приложении "Первая Форма" откройте карточку задачи. В браузере откройте панель разработчика (клавиша F12) и перейдите на вкладку Console (вкладка «Console» в панели разработчика). Наличие сообщений об ошибках свидетельствует о недоступности WebSocket.

2. В панели разработчика перейдите на вкладку Network (вкладка «Network» / «Сеть» в панели разработчика), выберите фильтр WS (кнопка «WS» для фильтрации только WebSocket-соединений), затем обновите страницу (клавиши Ctrl+F5). Должна появиться строка connect — нажмите на неё. Затем перейдите в раздел Messages (вкладка «Messages» внутри выбранного соединения). Если сообщение подсвечено красным и значений нет — WebSocket недоступен.

Доступность WebSocket¶

Для корректной работы приложения "Первая Форма" WebSocket не должен возвращать ошибок во вкладке Console, а в разделе Messages должны возвращаться данные.

Пример корректной настройки WebSocket для Nginx¶

location /notificationHub {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_pass https://ваше_приложение/notificationHub;
proxy_buffering off;
gzip off;
}

Для версии ниже Орион («Орион» — кодовое название версии 2.220 и выше) вместо notificationHub используется signalr.

Обеспечение корректной работы push-уведомлений¶

В настройках веб-сервера или балансировщика нагрузки необходимо разрешить работу WebSockets для пути /pushHub.

Пример конфигурации для Nginx¶

location /pushHub {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_pass http://upstream/pushHub;
proxy_buffering off;
gzip off;
}

Этот конфигурационный блок обеспечит корректную работу WebSockets через Nginx, устанавливая необходимые заголовки.