Другое · 6 мин
Публикация веб-сервиса в 1С: пошаговая инструкция
Публикация веб-сервиса в 1С: настройка конфигурации, веб-сервера и проверка WSDL, права доступа и типичные ошибки при интеграции.
Веб-сервис в 1С позволяет внешним системам обращаться к методам конфигурации по протоколу HTTP/SOAP. Публикация делает выбранные объекты доступными по адресу, который формируется веб-сервером 1С:Предприятия.
Перед публикацией нужно решить, какие данные и операции открываются, какая аутентификация используется и какой веб-сервер будет обслуживать запросы. Ошибки на этом этапе приводят к недоступности сервиса или раскрытию лишних данных.
Что нужно проверить перед публикацией
Убедитесь, что конфигурация открыта в режиме правки и поддерживает создание веб-сервисов. Не все конфигурации одинаково подходят для открытия методов наружу, поэтому сначала оцените состав объектов, которые планируется опубликовать.
Определите список методов, которые будут доступны внешним вызовам. Лучше открывать только необходимые функции, а не весь общий модуль целиком, чтобы уменьшить поверхность атаки.
Выбор способа аутентификации
Веб-сервис может работать под пользователем информационной базы или под отдельной учётной записью веб-сервера. Уточните, какие права будут у вызывающей стороны, и какие данные она сможет читать или изменять.
Если планируется работа по HTTPS, подготовьте сертификат и настройте шифрование ещё до публикации. Переход с HTTP на HTTPS после публикации может потребовать повторной настройки адресов и доступа клиентов.
Создание веб-сервиса в конфигурации
В конфигураторе создайте объект веб-сервиса и укажите методы, которые он выставляет наружу. Обычно это функции общего модуля, помеченные как экспортируемые и предназначенные для вызова по протоколу SOAP.
Назначьте сервису понятное имя, так как оно станет частью адреса, по которому клиент будет обращаться к WSDL. Избегайте пробелов и спецсимволов в имени, чтобы не усложнять формирование URL.
Сохраните конфигурацию и обновите информационную базу, чтобы изменения вступили в силу. Без обновления база может не видеть только что созданный веб-сервис.
Публикация на веб-сервер 1С
Используйте команду публикации на веб-сервер из конфигуратора или средства администрирования информационной базы. Укажите виртуальный каталог, имя публикации и параметры подключения к базе.
В процессе публикации выбирайте только те компоненты, которые действительно нужны для работы веб-сервиса. Лишние опубликованные ресурсы увеличивают нагрузку и количество потенциальных точек входа.
- 1Откройте конфигурацию и создайте веб-сервис с нужными методами
- 2Обновите конфигурацию в информационной базе
- 3Выполните публикацию на веб-сервер через конфигуратор или администрирование
- 4Проверьте доступность адреса WSDL в браузере
- 5Настройте права доступа пользователей
После публикации запишите адрес веб-сервиса. Обычно он содержит имя виртуального каталога, имя базы и имя веб-сервиса, заканчиваясь расширением .ws. Точный вид зависит от используемого веб-сервера и настроек публикации.
Настройка веб-сервера и доступа
Настройте веб-сервер так, чтобы он перенаправлял запросы к опубликованному каталогу в расширение веб-сервера 1С. Проверьте, что порт и протокол соответствуют ожиданиям клиентских систем.
Ограничьте доступ к каталогу веб-сервиса по IP-адресам или сетевым экранам, если сервис предназначен только для определённых внешних систем. Это снижает риск несанкционированных вызовов.
Назначьте пользователям роли, которые разрешают вызов веб-сервиса. Проверьте, что учётная запись, под которой работает сервис, имеет минимально необходимые права на чтение и запись.
Проверка результата и отладка
Откройте в браузере адрес с добавлением ?wsdl и убедитесь, что возвращается описание сервиса. Если страница не открывается, проверьте адрес, работу веб-сервера и доступность информационной базы.
Выполните пробный вызов метода из клиентского приложения или программы-тестера. Сравните полученный ответ с ожидаемым и убедитесь, что ошибки аутентификации отсутствуют.
Если вызов возвращает ошибку доступа, проверьте права пользователя и настройки аутентификации веб-сервера. Иногда проблема кроется не в 1С, а в блокировке запроса на уровне сетевого экрана.
Как проверить результат
Открывается описание веб-сервиса
Ошибка 404 или пустая страница
Возвращается ожидаемый результат
Ошибка аутентификации или доступа
Ограничения и альтернативы
Веб-сервис подходит для синхронного обмена по SOAP, но не всегда удобен для больших объёмов данных или частых вызовов. В таких случаях стоит рассмотреть другие способы интеграции, например HTTP-сервисы или обмен файлами.
Учитывайте нагрузку на сервер и канал связи при планировании публикации. Массовые одновременные вызовы могут замедлить работу информационной базы для обычных пользователей.
Что важно запомнить
Публикуйте только нужные методы, настройте аутентификацию и права, проверьте WSDL и пробный вызов перед вводом в эксплуатацию.
Нужно ли программировать для публикации веб-сервиса?
Создание веб-сервиса в конфигураторе не требует написания кода с нуля, но методы должны быть экспортируемыми и подходить для вызова через SOAP. Логику внутри методов пишет разработчик.
Можно ли опубликовать веб-сервис без веб-сервера 1С?
Нет, для доступа по HTTP/SOAP необходим опубликованный веб-сервер 1С:Предприятия, который обрабатывает запросы к информационной базе.
Как проверить, что веб-сервис доступен?
Откройте адрес сервиса с параметром ?wsdl в браузере. Если отображается описание сервиса, публикация работает; при ошибке проверьте адрес, веб-сервер и права доступа.
Что делать, если вызов возвращает ошибку доступа?
Проверьте права пользователя в информационной базе, настройки аутентификации веб-сервера и сетевой экран. Часто причина не в коде 1С, а в блокировке запроса или нехватке ролей.
Безопасно ли открывать веб-сервис в интернет?
Только при использовании HTTPS, ограничении доступа и минимальных правах учётной записи. Без этих мер открытый веб-сервис может стать каналом для несанкционированного доступа к данным.