Модули расширения веб-сервера 1С: что это и как они работают

Публикация информационной базы 1С на веб-сервере невозможна без специального компонента — модуля расширения веб-сервера. Именно он принимает HTTP-запросы от браузеров и мобильных клиентов, передаёт их платформе 1С и возвращает ответ. Без этого модуля веб-сервер (Apache или IIS) просто не знает, как обрабатывать обращения к опубликованной базе.

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

Разобраться в теме важно администраторам, которые настраивают доступ к базе через браузер, публикуют HTTP-сервисы, веб-сервисы или организуют работу мобильных клиентов. Ниже описано, какие модули существуют, где они лежат, как их подключить и как проверить, что всё работает.

Что такое модуль расширения веб-сервера и зачем он нужен

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

Через этот механизм работают веб-клиент (запуск базы в браузере), HTTP-сервисы, веб-сервисы (SOAP), сервисы OData и мобильные клиенты. Все они используют один и тот же канал: запрос приходит на веб-сервер, модуль расширения передаёт его платформе, платформа формирует ответ, модуль возвращает его клиенту.

Важно понимать: модуль расширения не заменяет платформу и не является отдельным приложением. Он лишь «мост», поэтому на сервере, где происходит публикация, должна быть установлена полноценная платформа 1С той же версии, что и библиотека модуля.

Какие файлы модулей существуют и где они находятся

Состав файлов зависит от веб-сервера и разрядности. Для Apache 2.4 используется библиотека wsap24.dll (Windows) или wsap24.so (Linux). Для Microsoft IIS применяется ISAPI-модуль wsisapi.dll. Существуют 32-разрядные и 64-разрядные варианты, и разрядность модуля должна совпадать с разрядностью веб-сервера, а не операционной системы.

Файлы размещаются в каталоге установки платформы. Типовой путь на Windows выглядит примерно так: C:\Program Files\1cv8\<версия>\bin\wsap24.dll. При установке платформы нужно явно отметить компонент «Модули расширения веб-сервера» — по умолчанию в некоторых сценариях установки он может быть не выбран.

Если нужного файла в каталоге bin нет, скорее всего, компонент не был установлен. Достаточно повторно запустить установщик платформы в режиме изменения и добавить модуль расширения веб-сервера.

Как выполняется публикация базы через конфигуратор

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

1. 1
   Запустите конфигуратор от имени администратора и откройте нужную базу
2. 2
   Откройте меню «Администрирование» — «Публикация на веб-сервере»
3. 3
   Укажите имя публикации (латиницей, без пробелов) и выберите тип веб-сервера
4. 4
   Отметьте нужные механизмы: веб-клиент, HTTP-сервисы, веб-сервисы, OData
5. 5
   Нажмите «Опубликовать» и дождитесь сообщения об успешной публикации
6. 6
   Перезапустите веб-сервер и проверьте доступ к базе из браузера

При публикации конфигуратор автоматически прописывает путь к модулю расширения в конфигурационных файлах веб-сервера: для Apache — в httpd.conf или отдельном включаемом файле, для IIS — в настройках обработчика ISAPI. Также создаётся файл default.vrd в каталоге публикации, который описывает параметры виртуального приложения.

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

Ручная настройка: когда конфигуратор не справляется

На Linux или при нестандартной конфигурации веб-сервера автоматическая публикация может быть недоступна, и модуль подключается вручную. Для Apache это делается директивой LoadModule в файле httpd.conf с указанием полного пути к библиотеке.

LoadModule _1cws_module "C:/Program Files/1cv8/8.3.22.1750/bin/wsap24.dll"

После добавления строки в конфигурацию Apache задаётся обработчик для виртуального каталога публикации (директивы вида SetHandler 1c-application в блоке Location) и указывается путь к файлу default.vrd. Точный синтаксис зависит от версии Apache, поэтому надёжнее сверяться с документацией на используемую версию платформы.

Для IIS ручная настройка сводится к регистрации ISAPI-расширения wsisapi.dll, разрешению его выполнения в настройках ограничений ISAPI и CGI и созданию виртуального приложения с сопоставлением обработчика. Также потребуется включить нужные компоненты самого IIS (ISAPI Extensions, ISAPI Filters).

Как проверить, что модуль работает корректно

Первичная проверка — обращение к опубликованной базе из браузера по адресу вида http://сервер/имя_публикации. Если всё настроено верно, откроется страница входа веб-клиента или ответ HTTP-сервиса. Ошибка 404 означает, что виртуальный каталог не найден, а ошибка вида 500 — что модуль загрузился, но платформа не смогла обработать запрос.

Дополнительно стоит проверить журналы веб-сервера: ошибки загрузки модуля Apache фиксирует в error.log, IIS — в журналах событий Windows и логах сайта. По тексту ошибки обычно сразу видно, связана ли проблема с разрядностью, правами доступа или отсутствием файла.

Типичные ошибки и ограничения

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

Безопасность и права доступа

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

Для доступа извне локальной сети публикацию следует защищать: использовать HTTPS с корректным сертификатом, включать аутентификацию и ограничивать список публикуемых механизмов только реально нужными. Публикация HTTP-сервисов без аутентификации — частая причина утечек данных.

Частые вопросы