Настройка веб-интерфейса ЛЭРС УЧЁТ на IIS

В версии 3.35 веб-интерфейс был интегрирован в сервер ЛЭРС УЧЁТ. Доступ к веб-интерфейсу можно получить из браузера, напрямую указав адрес и порт сервера. Точно такие же адрес и порт вы указываете при подключении через АРМ оператора.

Если вы хотите предоставить доступ к веб-интерфейсу извне, вы можете использовать DNS имя и порт, указанный в сервере. Например, http://lers.myserver.com:10000/

Если вы в конфигурационном файле сервера укажете порт 80, то веб-интерфейс будет доступен без указания порта. Например, http://lers.myserver.com/

Однако, в некоторых случаях этот подход может быть неприемлем. Например:

Вы хотите оставить стандартный порт 10000 для АРМ оператора во внутренней сети, но подключаться к веб-интерфейсу без указания порта.
На компьютере с сервером ЛЭРС УЧЁТ уже установлен IIS. В этом случае он займёт порт 80, и сервер ЛЭРС УЧЁТ не сможет принимать на нём подключения.
Вы хотите использовать защищённый обмен по протоколу HTTPS.

В этих случаях для того, чтобы предоставить доступ к веб-интерфейсу, вам потребуется сервер IIS, который настроен в режиме обратного прокси.

В этом руководстве пошагово указано что необходимо сделать для того, чтобы предоставить доступ к веб-интерфейсу ЛЭРС УЧЁТ через IIS.

Внимание

Компонент Web-интерфейс оставлен только для совместимости сервисов, использующих старый REST API ЛЭРС УЧЁТ. Если вам такая интеграция не требуется, его можно удалить и пропустить отмеченные пункты.

Создайте новый сайт на сервере IIS

Этот шаг можно пропустить если у вас уже был установлен и настроен компонент Web-интерфейс, и вы не собираетесь его удалять для того, чтобы продолжила работать интеграция с прежним REST API.

В панели управления службами IIS выберите узел Сайты.
В панели Действия выберите Добавить веб-сайт.
Введите имя сайта, укажите привязку порта и доменного имени
Физический путь можно задать любой. Обычно папка сайта располагается в C:\inetpub

Установить Web Platform Installer

Этот модуль позволяет быстро устанавливать расширения и компоненты сервера IIS. С

Загрузите и установите модуль Web Platform Installer.
После установки перезапустите консоль управления IIS.

Установить Application Request Routing

Этот модуль отвечает за перенаправление запросов к серверу ЛЭРС УЧЁТ и выдачу его ответов назад.

В консоли управления IIS выберите ваш сервер, и в группе Управление выберите Установщик веб-платформы Microsoft.
В строке поиска наберите ARR.
Установите модуль Маршрутизация запросов приложений 2.5
После установки перезапустите консоль управления IIS.

Внимание

Если в процессе установки Application Request Routing по описанным выше шагам возникнут ошибки установки сопутствующих компонентов, запустите Установщик веб-платформы Microsoft из меню Пуск → Microsoft Web Platform Installer и повторите шаги начиная со второго по списку.

Также, если ошибки установки и в этом случае все равно будут возникать, попробуйте вместо Маршрутизация запросов приложений 2.5 установить Маршрутизация запросов приложений 3.0

Кроме того Application Request Routing можно установить отдельным установщиком. Если через Установщик веб-платформы Microsoft данный компонент установить не удастся, скачайте программу установки с официальной страницы Application Request Routing и установите его данной программой.

Активировать прокси-сервер

В консоли управления IIS выберите ваш сервер.
В группе IIS выберите пункт Application Request Routing Cache.
В правой панели Действия выберите пункт Server Proxy Settings...
Установите флажок Enable Proxy.
Сохраните изменения, нажав кнопку Применить в меню Действия.

Отключить кэш для сайта

Включенный кэш может искажать ответы от сервера ЛЭРС УЧЁТ, поэтому, для сайта его потребуется отключить. Для этого:

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

Настроить перенаправление запросов

Это позволит серверу IIS принимать запросы и отправлять их на сервер ЛЭРС УЧЁТ. Ответы сервера будут переданы назад клиенту. Чтобы настроить перенаправление:

В консоли IIS выберите ваш сайт.
В панели управления сайтом в группе IIS выберите Переопределение URL-адресов
В правой панели Действия нажмите Добавить правила
Выберите шаблон Пустое правило
Задайте любое имя.
Введите шаблон (.*)
Выберите Действие - Переопределение
В поле URL-адрес переопределения введите адрес вашего сервера ЛЭРС УЧЁТ. Например, если у вас сервер установлен на том же компьютере, что и сервер IIS, здесь вы можете ввести http://localhost:10000/{R:1}
Если сервер ЛЭРС УЧЁТ стоит на другом компьютере, вместо localhost:10000 задайте его адрес и порт.
Установите флажки Добавить строку запроса и Остановить обработку дальнейших правил.

Убедитесь, что данное правило следует последним в списке правил! Тем самым вы укажите вашему веб-серверу IIS, что его необходимо обрабатывать в последнюю очередь.

Включить поддержку символов : в URL

Некоторые пути содержат двоеточие, что по умолчанию для IIS считается неверным запросом. Нужно отредактировать конфигурационный файл таким образом, чтобы двоеточие корректно распознавалось в URI. Без этого, например, не откроется таблица с данными. Нам необходимо явно задать пустое значение в параметре requestPathInvalidCharacters в секции system.web/httpRuntime файла конфигурации web.config вашего сайта. Для этого:

В консоли управления IIS выберите ваш сайт.
В панели управления сайтом в разделе IIS выберите Редактор конфигурации
Сверху в параметре Раздел в выпадающем меню раскройте ветку system.web и в ней выберите пункт httpRuntime.
Найдите параметр requestPathInvalidCharacters, задайте в нем любое значение, например *, и сохраните изменения, нажав кнопку Применить в меню Действия
Затем удалите ранее введенное значение в параметре requestPathInvalidCharacters, оставив поле пустым, и снова сохраните изменения, нажав кнопку Применить в меню Действия

Убедиться, что IIS перенаправляет папки bin

Если на IIS ранее стоял веб-интерфейс, то папка bin не будет перенаправлена на сервер ЛЭРС УЧЁТ. Это может привести к ошибке загрузки обновлений, в случае если ваш сервер их раздаёт. Чтобы убрать скрытый путь, нужно:

В консоли управления IIS выберите ваш сайт
В панели управления сайтом выберите Фильтрация запросов
Перейдите на закладку Скрытые сегменты и удалите сегмент bin, если он там присутствует.

Запустить/перезапустить сайт

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

В консоли управления IIS выберите ваш сайт.
Нажмите правой кнопкой по сайту и в открывшемся контекстном меню в разделе Управление Веб-сайтом нажмите Запустить или Перезапустить.

Page tree