Page tree
Skip to end of metadata
Go to start of metadata

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

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

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

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

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

Действия для поддержки старого REST интерфейса

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

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

  • В правой панели Действия нажмите Добавить правила
  • Выберите шаблон Пустое правило
  • Задайте имя
  • Введите шаблон (^rest/.*)
  • Выберите Действие - Нет
  • Установите флажок Остановить дальнейшую обработку правил
  • Сохраните изменения, нажав кнопку Применить в меню Действия

Также для возможности авторизации через REST API необюходимо добавить отдельное праило:

  • В правой панели Действия нажмите Добавить правила
  • Выберите шаблон Пустое правило
  • Задайте имя
  • Введите шаблон (^auth/.*)
  • Выберите Действие - Нет
  • Установите флажок Остановить дальнейшую обработку правил
  • Сохраните изменения, нажав кнопку Применить в меню Действия

Действия для поддержки старого Веб-сервиса доступа к данным

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

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

  • В правой панели Действия нажмите Добавить правила
  • Выберите шаблон Пустое правило
  • Задайте имя
  • Введите шаблон (^api\.asmx.*)
  • Выберите Действие - Нет
  • Установите флажок Остановить дальнейшую обработку правил
  • Сохраните изменения, нажав кнопку Применить в меню Действия
  • В правой панели Действия нажмите Добавить правила
  • Выберите шаблон Пустое правило
  • Задайте любое имя.
  • Введите шаблон (.*)
  • Выберите Действие - Переопределение
  • В поле 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 выберите ваш сайт.
  • Нажмите правой кнопкой по сайту и в открывшемся контекстном меню в разделе Управление Веб-сайтом нажмите Запустить или Перезапустить.