Перейти к содержанию

Настройка проксирующего центрального портала

Настройка проксирование запросов API через центральный портал

Данная возможность позволяет проксировать запросы к API для централизованной и гибридоной архитектуры МФЦ. Под гибридной понимается структура МФЦ где для 2-х или более муниципальных образований создан один сервер ИИС МФЦ.

Данный прокси работает для мобильных приложений и ситуационного центра. Стандартный механизм отчетов на центральном портале не будет разбивать данные по виртуальным МФЦ.

Схема работы API при децентрализованной системе:

  1. Центральный портал хранит информацию о всех серверах ИИС МФЦ.
  2. На центральном портале разработано API возвращающее список url адресов всех серверов ИИС МФЦ.
  3. После получения списка серверов МФЦ производится обращение к каждому серверу ИИС МФЦ для получения данных.

В централизованной архитектуре существует только один сервер ИИС МФЦ, который по умолчанию возвращает через API информацию о всех подразделениях без разбивки по муниципальным образованиям.

Разработанный механизм проксирования позволяет для каждого муниципального образования создать виртуальный URL, который будет перенаправлять запрос в центральную ИИС МФЦ. ИИС МФЦ корректно обработает данные и вернет результат отфильтрованный данным муниципальным образованием.

Данный механизм позволяет настроить проксирование для гибридных МФЦ. К примеру есть 2 сервера ИИС МФЦ. 1 сервер работает для городоа и 2 для всей области. В этом случае нужно настроить 1 реальный url, который будет вести на городскую ИИС и для каждого муниципального образования виртуальные URL.

Для работы нужно создать домены 3 или 4 уровня (в зависимости на каком уровне стоит центральный портал) на центральном портале.

URL center.mfc выбран в качестве примера, это должен быть адрес центрального портала в сети интернет.

Если централизованная система, то можно создать домен вида xxx.center.mfc. Где xxx - ids элемента в структуре.

Если гибридная или децентрализованная система, то необходимо создать домены вида yyy-xxx.center.mfc. Где yyy - 3 цифры начиная с 3 символа из ОКАТО муниципального образования. К примеру код ОКАТО 60401000000, то code_mfc будет 401.

Данные доменные имена должны вести на сайт center.mfc. Т.к. на центральном портале установлен механизм проксирования, который по адресу сайта будет понимать куда надо проксировать запрос.

Для определение IDS необходимо зайти в редактирование структуры МФЦ и указать параметр idsp (это значение поля ids в таблице isp.sp_struc) из адресной строки.

После того как будут заведены все DNS имена и они будут обрабатываться центральным порталом необходимо скорректировать таблицу mfc.sp_mfc где нужно создать запись для каждого муниципального образования и заполнить следующие поля: 1. naz - название муниципального образования 2. mo - название муниципального образования 3. url_mfc - url адрес который был добавлен в DNS. URL вид (yyy-)xxx.center.mfc. URL необходимо указывать с протоколом. 4. code_mfc - 3 цифры начиная с 3 символа из ОКАТО муниципального образования. К примеру код ОКАТО 60401000000, то code_mfc будет 401. 5. ip_server - адрес домена (без указания протокола) который был добавлен в DNS. URL вид (yyy-)xxx.center.mfc. 6. npp - порядковый номер муниципального образования (для сортировки в API). 7. proxy_url - реальный URL адрес сайта (указывается с протоколом). Это адрес внешнего портала МФЦ, на который будут проксированы запросы.

Существует два режима работы проксирующего сервера:

  1. Редирект запросов
  2. Проксирование запросов

Для настройки необходимо указать в server.ini способ работы

[PROXY]
TRANSPORT=proxy
;proxy|redirect

По умолчанию стоит режим проксирования. Если с ним будут возникать проблемы можно переключаться на редирект.

При поступлении запроса к URL вида (yyy-)xxx.center.mfc программа проанализирует параметры yyy и xxx для определения URL адреса внешнего портала. В зависимости от формата API будет добавлен специальный фильтр к URL реального внешнего портала.

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

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