Публикация HTTP-сервисов на веб-сервере Internet Information Services (IIS) — это стандартная задача при интеграции 1С с внешними системами. Однако часто специалисты сталкиваются с ситуацией, когда сама база данных успешно открывается через браузер, а попытка обращения к конкретному HTTP-сервису заканчивается ошибкой 404 или некорректным отображением каталога. В этой статье мы подробно разберем, как правильно настроить IIS, устранить типичные ошибки и обеспечим стабильную работу ваших веб-решений.
Разберем ситуацию, когда публикация вроде бы выполнена, но сервис «не виден» для веб-сервера. Одной из ключевых причин является неверная настройка модуля Handler Mappings (Сопоставление обработчиков) в консоли управления IIS. Рассмотрим подробнее, как система понимает, что входящий запрос нужно передать именно библиотеке 1С.
Посмотрим на типичную ошибку: часто при ручной настройке или сбоях автоматической публикации в поле «Путь» (Path) указывается расширение *.1crs. Это логично для веб-клиента, но для HTTP-сервисов такой подход не работает. Выясним причину: HTTP-сервисы 1С используют произвольные URL-адреса, которые не заканчиваются конкретным расширением файла. Поэтому для корректной работы обработчик должен быть настроен на путь *.* или просто *.
Проанализируем правильный алгоритм настройки обработчика:
IsapiModule.* или *.*.wsapiex.dll, которая находится в каталоге bin установленной платформы.Даже если обработчики настроены идеально, IIS может не иметь физической возможности запустить процесс из-за ограничений безопасности Windows. Разберем по шагам, кому и какие права необходимы для работы.
Выясним, от чьего имени работает ваш веб-сервер. Обычно это учетная запись IIS AppPool\ИмяВашегоПула или NetworkService. Этому пользователю крайне важно предоставить следующие права:
Во-первых, права на чтение и выполнение в каталоге, где установлена платформа 1С (папка bin). Это необходимо, чтобы IIS мог загрузить в память библиотеку wsapiex.dll и связанные с ней компоненты. Без этого вы получите ошибку доступа (500.19 или 401).
Во-вторых, требуются полные права на папку, в которой находится файл публикации default.vrd. Платформа 1С в процессе работы может записывать логи или обновлять временные параметры в этом каталоге. Если прав будет недостаточно, публикация может вести себя непредсказуемо.
Рассмотрим ситуацию, когда настройки внутри конкретного сайта верны, но сервер всё равно выдает ошибку 404.2 (Requested content seems to be script and will not be served by the static file handler). Это происходит из-за глобальных ограничений безопасности IIS.
Посмотрим, как это исправить:
wsapiex.dll.Одной из самых коварных проблем является несоответствие разрядности установленной платформы 1С и настроек пула приложений IIS. Проанализируем, как это влияет на работу.
Если вы используете 64-разрядную версию 1С, то библиотека wsapiex.dll также является 64-битной. В этом случае пул приложений должен работать в стандартном режиме. Однако если ваша платформа 32-разрядная, то в расширенных настройках пула приложений (Advanced Settings) необходимо обязательно установить параметр Enable 32-Bit Applications в значение True.
Смешивание разрядности (например, попытка запустить 32-битную библиотеку в 64-битном пуле) гарантированно приведет к ошибке 500 и невозможности инициализации модуля 1С.
Файл default.vrd является «сердцем» публикации. Для HTTP-сервисов его структура имеет критическое значение. Рассмотрим пример корректной секции внутри этого файла, которую система должна содержать для распознавания ваших сервисов:
<httpServices>
<service name="ИмяСервисаИзКонфигуратора" rootUrl="my_api" enable="true" />
</httpServices>
Разберем атрибуты подробнее:
name — это точное имя объекта «HTTP-сервис», как оно задано в дереве метаданных в конфигураторе.rootUrl — это сегмент адреса, по которому сервис будет доступен извне.enable — флаг, разрешающий работу данного сервиса.Важный нюанс: если вы добавили новый сервис в конфигурацию и просто нажали «Опубликовать», 1С не всегда корректно обновляет этот файл, если он был ранее изменен вручную. Рекомендуется проверять содержимое default.vrd в текстовом редакторе.
Многие разработчики совершают ошибку при формировании ссылки для вызова сервиса. Выясним, как выглядит правильная структура URL:
http://[имя_сервера]/[имя_публикации]/hs/[rootUrl]/[относительный_путь]
Разберем обязательные элементы:
hs — это жестко заданный платформой префикс (от английского HTTP Service). Он указывает обработчику 1С, что данный запрос не относится к веб-клиенту или SOAP-сервисам, а должен быть передан в логику HTTP-сервисов.rootUrl — то самое имя, которое мы прописали в default.vrd или в свойствах сервиса в конфигураторе.Если пропустить сегмент hs, сервер вернет ошибку 404, так как не поймет, какому модулю передать управление запросом.
Проанализируем вопрос безопасности. Для HTTP-сервисов 1С в настройках IIS обычно должна быть включена Anonymous Authentication (Анонимная проверка подлинности). Это может показаться странным, но логика здесь проста: проверку логина и пароля пользователя 1С выполняет сама платформа на основе заголовка Authorization: Basic, который присылает клиент. Если в IIS выключить анонимный доступ и оставить только Windows-авторизацию, внешние системы (например, мобильные приложения или веб-сайты) не смогут подключиться без предварительной авторизации в домене Windows.
В завершение разберем системные требования. Часто публикация не взлетает, потому что при установке роли Web-Server (IIS) были пропущены важные компоненты. Убедимся, что в системе активированы:
Без этих компонентов IIS просто не «увидит» библиотеку wsapiex.dll как исполняемый модуль, и настройки обработчиков *.* не дадут никакого результата.
Таким образом, правильная настройка HTTP-сервисов 1С на IIS складывается из трех составляющих: корректного сопоставления обработчиков на путь *, обеспечения прав доступа для пула приложений и точного следования структуре URL с использованием префикса hs.