WebSocket в 1С 8.3.27: как подключить клиент и настроить авторизацию - SOFT73
Внедрение и автоматизация 1С
любой сложности
под ключ

Адрес офиса: г. Минск, ул.Л. Карастояновой, 32

Звоните Пн-Пт: 9 - 18

+375(17)301-73-73
Заказать звонок

Меню сайта

WebSocket в 1С 8.3.27: как подключить клиент и настроить авторизацию

С выходом платформы 8.3.27 разработчики 1С наконец получили штатную поддержку протокола WebSocket. Механизм долгожданный, но на практике сразу возникают вопросы: чем он лучше привычных HTTP-сервисов, где его действительно стоит применять, как правильно настроить авторизацию и какие подводные камни уже обнаружены. Разберём эти моменты по порядку.

Почему HTTP-сервисов не хватало для обмена в реальном времени

Классический HTTP работает по схеме «запрос — ответ»: инициатором всегда выступает клиент. Чтобы узнать о событии на сервере, клиенту приходится спрашивать самому. Отсюда появились два обходных приёма:

  • Short Polling — клиент периодически, в цикле, отправляет запросы «есть ли что-то новое?». При большом числе клиентов сервер фактически получает нагрузку, сопоставимую с DDoS, которую вы устроили себе сами.
  • Long Polling — сервер не отвечает сразу, а удерживает соединение (например, 30 секунд), пока не появятся данные. Получив ответ, клиент тут же отправляет новый запрос. Так до сих пор работают многие интеграции, в том числе Telegram-боты.

Long Polling не уходит в прошлое и сегодня: не все браузеры поддерживают WebSocket, службы безопасности нередко блокируют этот протокол в корпоративной сети, а поддержание постоянных сессий требует отдельной инфраструктуры и хорошего канала связи.

Как устроен протокол WebSocket и где он полезен

Спецификация WebSocket (RFC 6455) вышла ещё в 2011 году, а в платформе 1С встроенная поддержка появилась лишь в версии 8.3.27. Ключевое отличие от HTTP — двусторонний обмен внутри одного постоянного соединения:

  1. клиент отправляет на сервер HTTP-запрос со специальными заголовками (рукопожатие, handshake);
  2. сервер переключается на протокол WebSocket и держит соединение открытым;
  3. дальше обе стороны отправляют сообщения в любой момент, не дожидаясь друг друга.

Типичные сценарии — биржевые и торговые приложения, где важна мгновенная реакция на изменение цен, чаты и мессенджеры, а также событийные интеграции между системами. Раньше в 1С подобное приходилось реализовывать через внешние компоненты, поле HTML-документа или собственные надстройки над HTTP-сервисами, Системой взаимодействия (с 8.3.20) и серверными оповещениями клиента (с 8.3.26).

Что появилось в платформе 8.3.27

Набор новых возможностей довольно широкий:

  • встроенная обработка «Управление WebSocket-клиентами»;
  • отладка WebSocket по TCP и отдельная опция в отладке по HTTP;
  • объект метаданных WebSocketКлиент, который добавляется и в конфигурацию, и в расширение;
  • свойства «Предопределенный», «Подключать автоматически», «Заголовки», а также параметры авторизации.

Если включено автоподключение, платформа пытается соединиться с сервером сразу при запуске: пока сервер недоступен, статус остаётся «Открывается», после успеха — «Открыто». Предопределённые клиенты хранятся в таблице websocketclients базы данных, отличить их от созданных программно позволяет поле _predefined.

Пять обработчиков модуля клиента

  • ПередПодключением — место для переопределения параметров соединения, например заголовков авторизации;
  • ПриОткрытииСоединения — срабатывает после успешного рукопожатия;
  • ПриПолученииСообщения — основной обработчик, сюда приходят данные от сервера (JSON или двоичные данные);
  • ПриОшибке — возвращает код ошибки, расшифровка зависит от сервера;
  • ПриЗакрытииСоединения — код закрытия показывает причину; 1000 означает штатное завершение.

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

Три способа создать соединение и нюансы авторизации

Соединение можно открыть программно на клиенте, программно на сервере или через WebSocket-клиент из метаданных — в последнем случае оно также работает на стороне кластера серверов.

Предопределённый клиент без кода — удобно, но небезопасно

Достаточно отметить флажки «Предопределенный» и «Подключать автоматически», указать URL сервера, логин и пароль. Платформа сама сформирует заголовок Authorization с Basic-авторизацией. Проблема в том, что логин и пароль хранятся в открытом виде, а отдельных ролей для работы с WebSocket-клиентами нет: пользователь с базовыми правами может программно прочитать учётные данные. Поэтому хранить их в конфигурации или расширении не рекомендуется.

Программная авторизация

Надёжнее добавить клиент в расширение, указав только URL, а заголовок формировать в коде: логин и пароль кодируются в Base64, добавляется префикс Basic. Каждому программно создаваемому клиенту нужен уникальный ключ соединения — проще всего взять строковое представление нового уникального идентификатора. После подключения получаем ключ текущего соединения, по которому затем отправляем сообщения методом ОтправитьСообщение() — как текст, так и двоичные данные:

Соединение = ВебсокетКлиент.ПолучитьТекущееСоединение();
КлючКлиента = Соединение.Ключ;

Особенности клиентских и серверных соединений

  • на клиенте видны только клиентские соединения, на сервере — только серверные;
  • серверное соединение доступно другим пользователям по ключу и не обрывается при обновлении конфигурации;
  • клиентское соединение доступно только в текущем сеансе и при его завершении закрывается с кодом 1000;
  • уникальность ключа проверяется отдельно для клиентских и серверных соединений, поэтому можно получить два соединения с одинаковым ключом — это легко приводит к путанице.

Известные ошибки и тестирование

Механизм пока не идеален. В документации к обработчику «ПередПодключением» синтаксис описывает параметр «Клиент», а в примере используется «Соединение», хотя на этом этапе рукопожатие ещё не завершено — такой пример работать не будет. Кроме того, предопределённый клиент в обработке управления можно попытаться удалить через контекстное меню или клавишу Del, что вызывает ошибку с предложением перезапустить 1С. Штатного инструмента для просмотра всех активных соединений тоже нет — его приходится писать самостоятельно.

Тестировать WebSocket можно так же, как HTTP-сервисы: поднять мок-сервер, возвращающий заранее подготовленные ответы (удобен эхо-сервер), а для проверки клиента использовать готовые инструменты вроде Postman.

Итог

WebSocket в 1С 8.3.27 открывает дорогу событийным интеграциям без постоянного опроса сервера: уведомления, чаты, обмен с внешними системами в реальном времени. При этом стоит отказаться от хранения паролей в метаданных, внимательно следить за ключами соединений и учитывать, что механизм ещё дорабатывается. Если вы планируете внедрять обмен через WebSocket в своей конфигурации, наши специалисты помогут спроектировать и настроить решение.

Как удобнее связаться?

Согласен с условиями политики конфиденциальности данных