Настройка автоматического обмена через API программных продуктов Инфокрафт: Формула ЖКХ и Инфокрафт: Формула ЖКХ + Бухгалтерия с государственным порталом ГИС ЖКХ picture_as_pdf

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

В релизе программного продукта 20.01 добавлена настройка автоматического обмена через API с порталом ГИС ЖКХ. Предусмотрена загрузка/выгрузка объектов жилого фонда, а также загрузка/выгрузка лицевых счетов. В следующих версиях планируется добавить загрузку/выгрузку приборов учета и их показаний и выгрузку платежных документов.

Согласно ограничениям ГИС ЖКХ автоматический обмен возможен в том случае, если в информационной базе занесены паспортные данные или СНИЛС по ответственным лицам, а так же кадастровые номера помещений.

Начиная с версии конфигурации 21.01, автоматический обмен с порталом ГИС ЖКХ в рамках лицевых счетов будет осуществляться вне зависимости от наличия паспортных данных или СНИЛС физического лица, информацию о персональных данных требуется указывать только в случае разделенных лицевых счетов в рамках одного объекта учета.

Основные шаги для настройки автоматического обмена

Шаг 1: Получение электронно-цифровой подписи для организации.

Для этого требуется обратиться в удостоверяющий центр в Вашем городе. Список удостоверяющих центров Вы можете посмотреть на сайте по адресу https://e-trust.gosuslugi.ru/CA, выбрав в поиске требуемый город, «Класс средств электронной подписи» - КС2. Сертификат требуется установить в раздел Личное для пользователя, от имени которого будет выполняться взаимодействие с ГИС ЖКХ. Требования к электронно-цифровой подписи:

  • Алгоритм подписи должен быть ГОСТ Р 34.11/34.10-2001 (Signature Algorithm: GOST R 34.11-94 with GOST R 34.10-2001);
  • Класс средств ЭП владельца квалифицированного сертификата (Certificate Policies): КС.2 и выше (должен содержать хотя бы 1.2.643.100.113.2);
  • Использование ключа (Key Usage): Цифровая подпись (Digital Signature), Неотрекаемость (Non Repudiation/Сontent Commitment), Шифрование ключей (Key Encipherment), Шифрование данных (Data Encipherment);
  • Система выполняет проверку Extended Key Usage (EKU) на наличие расширений: Проверка подлинности клиента (1.3.6.1.5.5.7.3.2);
  • Состав имени субъекта зависит от вида сертификата:
    • Для сертификата, выданного на ФЛ: SNILS.
    • Для сертификата, выданного на должностное лицо ЮЛ: SNILS, INN, OGRN, O. INN (без учета лидирующих 00) и OGRN должны совпадать с ИНН и ОГРН Оператора ИС из заявки.
    • Для сертификата, выданного на ЮЛ: OGRN, INN. INN (без учета лидирующих 00) и OGRN должны совпадать с ИНН и ОГРН организации.
    • Для сертификата, выданного ИП: OGRNIP и INN. INN и OGRNIP должны совпадать с ИНН и ОГРНИП ИП.

Форматы и OID полей:

  • OGRN ::= NUMERIC STRING SIZE 13 1.2.643.100.1
  • OGRNIP ::= NUMERIC STRING SIZE 15 1.2.643.100.5
  • SNILS ::= NUMERIC STRING SIZE 11 1.2.643.100.3
  • INN ::= NUMERIC STRING SIZE 12 1.2.643.3.131.1.1

Шаг 2: Регистрация на государственном портале ГИС ЖКХ.

Организация (РСО, УО, ЖСК, ТСЖ) должна быть зарегистрирована в ГИС ЖКХ по адресу https://dom.gosuslugi.ru/#!/main. У организации должны быть определены функции в системе в соответствии с ее полномочиями, а также выбрана функция «Оператор информационной системы» (меню «Администрирование» - «Функции»).

  1. Формирование заявки на добавление информационной системы в ГИС ЖКХ.
  2. Установка КриптоПро CSP.

Используется для подписи передаваемых в ГИС ЖКХ данных ЭЦП пользователя. Для корректной работы через API c порталом ГИС ЖКХ рекомендован данный криптопровайдер. С подробной инструкцией по установке вы можете ознакомиться здесь.

Шаг 3: Установка КриптоПро ЭЦП Browser plug-in версии не ниже 2.0.12438.

Плагин для поддержки работы через браузер Internet Explorer c   электронно-цифровой подписью, если он не установлен, то портал автоматически предложит ссылку на его установку. Плагин требуется не только для работы с порталом через браузер, но и для обмена данными из 1С:Предприятия.

Шаг 4: Приобретение и установка «МагПро КриптоТуннель».

Использование данного программного продукта для шифрования данных определено требованиями системы ГИС ЖКХ.

Необходимо приобрести СКЗИ "МагПро КриптоПакет" в.3.0 - Исполнение "КриптоТуннель" - клиентскую лицензию. По требованиям ФСБ России поставка СКЗИ может осуществляться только на материальном носителе информации, электронная поставка невозможна. Стоимость каждого дистрибутива на компакт-диске с формуляром - 450 рублей.

Порядок подключения внешних информационных систем

Перед тем, как начать работу по обмену данными в автоматическом режиме с порталом ГИС ЖКХ, требуется указать в личном кабинете портала с какой информационной системой будет осуществлена интеграция, для этого требуется сформировать заявку на добавление новой информационной системы.

К  основному стенду интеграции https://dom.gosuslugi.ru/#!/main можно подключиться без этапа тестирования, для этого при формировании заявки на регистрацию информационной системы требуется указать тип ИС:  «Собственная ИС», «Коммерческая ИС» и не устанавливать признак «По результатам рассмотрения заявки на предоставление права доступа оператору ИС необходимо предоставить информационной системе доступ к стенду интеграционного тестирования ГИС ЖКХ для проведения тестирования согласно «Регламенту информационного взаимодействия внешних информационных систем с ГИС ЖКХ».

Формирование заявки:

  1. В личном кабинете ГИС ЖКХ перейдите в меню «Администрирование» – «Информационные системы».
  2. Для формирования заявки на новую информационную систему нажмите на кнопку «Сформировать заявку на новую ИС» на странице «Информационные системы».
  3. Выберите соответствующий вид ИС – «Собственная ИС».
  4. Заполните все обязательные поля со знаком «*».
  5. Загрузите квалифицированный сертификат ключа проверки электронной подписи ИС. Для этого нажмите кнопку «Добавить файл». Сам файл будет получен Вами после выполнения шага 5 инструкции раздела «Создание защищенного соединения», представленного ниже.
  6. Установите флажки в полях «Подтверждаю соответствие ИС установленным законодательством Российской Федерации требованиям о защите информации об информационной безопасности» и «Принимаю условия «Соглашения об информационном взаимодействии».
  7. Для отправки заявки на проверку оператором ГИС ЖКХ нажмите кнопку «Принять заявку». После проверки она будет утверждена или отклонена с указанием причины отказа. Проверка согласно регламенту ГИС ЖКХ не должна занимать более 3 рабочих дней.
  8. В случае изменения регистрационных данных, в том числе при смене оператора ИС, реквизитов организаций, перечня контактных лиц, тестовых поставщиков информации и транспортного сертификата, Оператор ИС обязан в срок не более 5 рабочих дней отправить уведомление Оператору ГИС ЖКХ с темой «Заявка на изменение регистрационных данных участника информационного обмена» с описанием изменений. Оператор ГИС ЖКХ в срок не более 5 рабочих дней высылает уведомление по электронной почте о результате внесения изменений.
  9. Решение о прекращении информационного взаимодействия принимается на основании заявки на отключение от Оператора ИС с темой «Заявка на отключение от информационного взаимодействия».

Более подробно с формированием заявки вы можете ознакомиться в инструкции портала ГИС ЖКХ «Руководство пользователя работа в личном  кабинете оператора информационной системы».

В случае нарушения положений настоящего Регламента (с Регламентом можно ознакомиться на портале ГИС ЖКХ, раздел «Регламенты и инструкции» - Регламент и форматы информационного взаимодействия внешних информационных систем с ГИС ЖКХ (текущие форматы) Оператор ГИС ЖКХ может принять решение о принудительном отключении ИС от информационного взаимодействия с ППАК. В случае принятия такого решения Оператору ИС направляется уведомление о принятии решения о принудительном отключении. В срок не позднее 5 рабочих дней после принятия решения об отключении ИС от информационного взаимодействия Оператор ГИС ЖКХ осуществляет блокировку приема и отправки пакетов данных отключаемой ИС. Уведомление о завершении процедуры отключения направляется Оператору ИС по электронной почте.

Для успешного дальнейшего обмена требуется скачать файлы CA-SIT.pem. и CA-PPAK.pem с портала ГИС ЖКХ. Файлы размещены в разделе «Регламенты и Инструкции» - «Регламент и форматы информационного взаимодействия внешних информационных систем с ГИС ЖКХ (текущие форматы v.11.7.0.10.1)».

Настройка «МагПро КриптоТуннель»

Более подробную информацию можно просмотреть на официальном сайте продукта http://www.cryptocom.ru/products/cryptotunnel.html. Перед покупкой данной программы обратите внимание на совместимость программы с версией операционной системы, которая стоит у вас на сервере/компьютере.

(Если у вас возникнут трудности в настройке данного программного обеспечения, то вы можете воспользоваться услугами Отдела Сервисного сопровождения компании Инфокрафт, подав заявку по телефону 8-800-200-1-365).

Создание защищенного соединения:

  1. Приобрести МагПро КриптоТуннель (официальный сайт: http://www.cryptocom.ru- использовать полноценную (не демо) лицензионную версию криптотуннеля.
  2. Установить  МагПро КриптоТуннель.
  3. Экспортировать сертификат, полученный для установления защищенного соединения с ГИС ЖКХ, в формат pfx. Для этого можно использовать утилиты наподобие P12FromGostCSP.
  4. Из командной строки cmd (находясь в директории ...\cryptopack2\bin, созданной при установке МагПро Криптопакет):                                 Перед выполением  команды необходимо прописать переменную окружения
    set LEGACY_GOST_PKCS12=1

    Данная переменая  устраняет ошибку выполнения команды по формированию ключа. Поэтому при разборе контейнера созданного утилитой p12FromGostCSP, возникает ошибка. Чтобы включить режим совместимости со старым алгоритмом, нужно перед вызовом утилиты openssl.exe установить переменную окружения.
    Далее в этой же командной строке:

openssl pkcs12 -in C:\test.pfx -out C:\test.key -nodes

- где test.pfx файл, полученный в п.3.

  1. С помощью встроенной в Windows утилиты "Сертификаты" экспортировать сертификат, полученный для установления защищенного соединения с ГИС ЖКХ (без закрытого ключа) в формат DER.
  2. Из командной строки cmd (находясь в директории ...\cryptopack2\bin) запустить:

openssl x509 -inform DER -outform PEM -in C:\test.cer -out C:\test.pem

- где test.cer файл, полученный в п.5.

  1. На портале ГИС ЖКХ перейти в раздел "Регламенты и инструкции" - "Управляющие организации, ТСЖ, ЖК, ЖСК", далее в разделе "Взаимодействие с внешними системами" найти и скачать архив "Регламент и форматы информационного взаимодействия внешних информационных систем с ГИС ЖКХ" текущего формата. В архиве будет присутствовать файл CA-PPAK.pem, который необходимо переместить в директорию ...\CryptoTunnel2\crypto\.
  2. Внести изменения в конфигурационный файл ...\CryptoTunnel2\stunnel \stunnel.conf :

- для параметра cert указать значение в виде имени файла, полученного в п.6 (cert= ..\crypto\test.pem).

- для параметра key указать значение в виде имени файла, полученного в п.4 (key= ..\crypto\test.key).

- для параметра connect указать значение api.dom.gosuslugi.ru:443.

- для параметра CAFile указать значение ..\crypto\CA-PPAK.pem.

  1. Проверить доступность порта 8080, запустив из командной строки cmd: netstat -an
  2. Запустить программу …\CryptoTunnel2\stunnel.exe. В дальнейшем работу с сервером интеграции осуществлять по адресу:

http://127.0.0.1:8080/<адрес_интеграционного_сервиса>.

  1. Для реализации защищенного соединения с промышленным стендом ГИС ЖКХ необходимо:

- для генерации key и pem использовать сертификат, выданный аккредитованным, не тестовым УЦ. Список аккредитованных УЦ распространяется через портал http://e-trust.gosuslugi.ru/, сертификат должен проходить проверку подлинности ИС ГУЦ (http://www.gosuslugi.ru/pgu/eds/);

Полную документацию по автоматическому обмену можно просмотреть по адресу: https://dom.gosuslugi.ru/#!/main, раздел «Регламенты и инструкции» - Регламент и форматы информационного взаимодействия внешних информационных систем с ГИС ЖКХ (текущие форматы).

После выполненных настроек можно переходить к подготовке программы к автоматическому режиму обмена данными между Инфокрафт: Формула ЖКХ/ Инфокрафт: Формула ЖКХ + Бухгалтерия и порталом ГИС ЖКХ, для этого вы можете обратиться к следующей инструкции.

Темы:  ГИС ЖКХ  
вниз
наверх