К статье
Практический материал

Другое · 6 мин

Публикация веб-сервиса в 1С: пошаговая инструкция

Публикация веб-сервиса в 1С: настройка конфигурации, веб-сервера и проверка WSDL, права доступа и типичные ошибки при интеграции.

Веб-сервис в 1С позволяет внешним системам обращаться к методам конфигурации по протоколу HTTP/SOAP. Публикация делает выбранные объекты доступными по адресу, который формируется веб-сервером 1С:Предприятия.

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

Что нужно проверить перед публикацией

Убедитесь, что конфигурация открыта в режиме правки и поддерживает создание веб-сервисов. Не все конфигурации одинаково подходят для открытия методов наружу, поэтому сначала оцените состав объектов, которые планируется опубликовать.

Определите список методов, которые будут доступны внешним вызовам. Лучше открывать только необходимые функции, а не весь общий модуль целиком, чтобы уменьшить поверхность атаки.

Выбор способа аутентификации

Веб-сервис может работать под пользователем информационной базы или под отдельной учётной записью веб-сервера. Уточните, какие права будут у вызывающей стороны, и какие данные она сможет читать или изменять.

Если планируется работа по HTTPS, подготовьте сертификат и настройте шифрование ещё до публикации. Переход с HTTP на HTTPS после публикации может потребовать повторной настройки адресов и доступа клиентов.

Создание веб-сервиса в конфигурации

В конфигураторе создайте объект веб-сервиса и укажите методы, которые он выставляет наружу. Обычно это функции общего модуля, помеченные как экспортируемые и предназначенные для вызова по протоколу SOAP.

Назначьте сервису понятное имя, так как оно станет частью адреса, по которому клиент будет обращаться к WSDL. Избегайте пробелов и спецсимволов в имени, чтобы не усложнять формирование URL.

Сохраните конфигурацию и обновите информационную базу, чтобы изменения вступили в силу. Без обновления база может не видеть только что созданный веб-сервис.

Публикация на веб-сервер 1С

Используйте команду публикации на веб-сервер из конфигуратора или средства администрирования информационной базы. Укажите виртуальный каталог, имя публикации и параметры подключения к базе.

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

Порядок действий
  1. 1
    Откройте конфигурацию и создайте веб-сервис с нужными методами
  2. 2
    Обновите конфигурацию в информационной базе
  3. 3
    Выполните публикацию на веб-сервер через конфигуратор или администрирование
  4. 4
    Проверьте доступность адреса WSDL в браузере
  5. 5
    Настройте права доступа пользователей

После публикации запишите адрес веб-сервиса. Обычно он содержит имя виртуального каталога, имя базы и имя веб-сервиса, заканчиваясь расширением .ws. Точный вид зависит от используемого веб-сервера и настроек публикации.

Настройка веб-сервера и доступа

Настройте веб-сервер так, чтобы он перенаправлял запросы к опубликованному каталогу в расширение веб-сервера 1С. Проверьте, что порт и протокол соответствуют ожиданиям клиентских систем.

Ограничьте доступ к каталогу веб-сервиса по IP-адресам или сетевым экранам, если сервис предназначен только для определённых внешних систем. Это снижает риск несанкционированных вызовов.

Назначьте пользователям роли, которые разрешают вызов веб-сервиса. Проверьте, что учётная запись, под которой работает сервис, имеет минимально необходимые права на чтение и запись.

Проверка результата и отладка

Откройте в браузере адрес с добавлением ?wsdl и убедитесь, что возвращается описание сервиса. Если страница не открывается, проверьте адрес, работу веб-сервера и доступность информационной базы.

Типичные ошибки
01
Открыли все методы общего модуля вместо необходимых — лишние данные стали доступны наружу
02
Забыли обновить конфигурацию после создания веб-сервиса — сервис не виден в публикации

Выполните пробный вызов метода из клиентского приложения или программы-тестера. Сравните полученный ответ с ожидаемым и убедитесь, что ошибки аутентификации отсутствуют.

Если вызов возвращает ошибку доступа, проверьте права пользователя и настройки аутентификации веб-сервера. Иногда проблема кроется не в 1С, а в блокировке запроса на уровне сетевого экрана.

Контрольные точки

Как проверить результат

Адрес WSDL в браузере
Норма

Открывается описание веб-сервиса

Тревожный признак

Ошибка 404 или пустая страница

Пробный вызов метода
Норма

Возвращается ожидаемый результат

Тревожный признак

Ошибка аутентификации или доступа

Ограничения и альтернативы

Веб-сервис подходит для синхронного обмена по SOAP, но не всегда удобен для больших объёмов данных или частых вызовов. В таких случаях стоит рассмотреть другие способы интеграции, например HTTP-сервисы или обмен файлами.

Учитывайте нагрузку на сервер и канал связи при планировании публикации. Массовые одновременные вызовы могут замедлить работу информационной базы для обычных пользователей.

Итог

Что важно запомнить

Публикуйте только нужные методы, настройте аутентификацию и права, проверьте WSDL и пробный вызов перед вводом в эксплуатацию.

Нужно ли программировать для публикации веб-сервиса?

Создание веб-сервиса в конфигураторе не требует написания кода с нуля, но методы должны быть экспортируемыми и подходить для вызова через SOAP. Логику внутри методов пишет разработчик.

Можно ли опубликовать веб-сервис без веб-сервера 1С?

Нет, для доступа по HTTP/SOAP необходим опубликованный веб-сервер 1С:Предприятия, который обрабатывает запросы к информационной базе.

Как проверить, что веб-сервис доступен?

Откройте адрес сервиса с параметром ?wsdl в браузере. Если отображается описание сервиса, публикация работает; при ошибке проверьте адрес, веб-сервер и права доступа.

Что делать, если вызов возвращает ошибку доступа?

Проверьте права пользователя в информационной базе, настройки аутентификации веб-сервера и сетевой экран. Часто причина не в коде 1С, а в блокировке запроса или нехватке ролей.

Безопасно ли открывать веб-сервис в интернет?

Только при использовании HTTPS, ограничении доступа и минимальных правах учётной записи. Без этих мер открытый веб-сервис может стать каналом для несанкционированного доступа к данным.