Подключение к смэв 3 инструкция

Методические рекомендации

Методические рекомендации СМЭВ 3 (версия 3.5.0.19)

Методические рекомендации СМЭВ 3 (версия 3.5.0.19)

| 10.61 МБ

Методические рекомендации СМЭВ 3 (версия 3.5.0.17), одобренные на Президиуме Правкомиссии 22.06.2023

Методические рекомендации СМЭВ 3 (версия 3.5.0.17), одобренные на Президиуме Правкомиссии 22.06.2023

| 8.63 МБ

​Регламент взаимодействия

Регламент 3.5 Приложение 3 Правила и процедуры работы в СМЭВ 02.11.2023

Регламент 3.5 Приложение 3 Правила и процедуры работы в СМЭВ 02.11.2023

| 2.6 МБ

Регламент 3 5 Приложение 3 Правила и процедуры работы в СМЭВ 22.06.2023_одобрен

Регламент 3 5 Приложение 3 Правила и процедуры работы в СМЭВ 22.06.2023_одобрен

| 2.6 МБ

Регламент обеспечения предоставления государственных услуг и исполнения государственных функций в электронном виде

Регламент обеспечения предоставления государственных услуг и исполнения государственных функций в электронном виде

| 6.19 МБ

Подключение к СМЭВ 3

Заявка на дополнительную настройку защищенного канала связи до СМЭВ 3 и СМЭВ 4 (для Участников, подключенных к СМЭВ 2 и имеющих защищенный канал)

Заявка на дополнительную настройку защищенного канала связи до СМЭВ 3 и СМЭВ 4 (для Участников, подключенных к СМЭВ 2 и имеющих защищенный канал)

| 33.56 КБ

Заявка на регистрацию Участника в СМЭВ 3 от 01.11.2022

Заявка на регистрацию Участника в СМЭВ 3 от 01.11.2022

| 30.17 КБ

Заявка на присоединение для новых Участников (СМЭВ 2, СМЭВ 3, СМЭВ 4 и Цифровой профиль ЕСИА)

Заявка на присоединение для новых Участников (СМЭВ 2, СМЭВ 3, СМЭВ 4 и Цифровой профиль ЕСИА)

| 32.82 КБ

Доступ к Виду сведений

Заявка на предоставление доступа к Виду сведений в СМЭВ 3 в качестве потребителя ВС от 03.02.2023

Заявка на предоставление доступа к Виду сведений в СМЭВ 3 в качестве потребителя ВС от 03.02.2023

| 22.13 КБ

Заявка на предоставление доступа к Виду сведений с типом Рассылка в СМЭВ 3 от 03.02.2023

Заявка на предоставление доступа к Виду сведений с типом Рассылка в СМЭВ 3 от 03.02.2023

| 21.98 КБ

Заявка на предоставление доступа к Виду сведений в СМЭВ 3 в качестве поставщика ВС от 01.11.2022

Заявка на предоставление доступа к Виду сведений в СМЭВ 3 в качестве поставщика ВС от 01.11.2022

| 28.4 КБ

Другие изменения

Заявка на другие изменения информационной системы в СМЭВ 3 от 07.07.2023

Заявка на другие изменения информационной системы в СМЭВ 3 от 07.07.2023

| 36.04 КБ

Заявка на вывод из эксплуатации Участника и/или информационной системы в СМЭВ 3 от 03.02.2023

Заявка на вывод из эксплуатации Участника и/или информационной системы в СМЭВ 3 от 03.02.2023

| 29.87 КБ

Заявка на вывод из эксплуатации Вида сведений СМЭВ 3 от 03.02.2023

Заявка на вывод из эксплуатации Вида сведений СМЭВ 3 от 03.02.2023

| 29.14 КБ

Требования к XML-схемам

Требования к XML-схемам, регистрируемым в СМЭВ 3 (версия 1.3.9) от 17.10.2022

Требования к XML-схемам, регистрируемым в СМЭВ 3 (версия 1.3.9) от 17.10.2022

| 103.37 КБ

Требования к XML-схемам, регистрируемым в СМЭВ 3 (версия 1.3.7)

Требования к XML-схемам, регистрируемым в СМЭВ 3 (версия 1.3.7)

| 95.85 КБ

Типовые ошибки, возвращаемые Участнику

Перечень типовых ошибок, возвращаемых Участнику при работе в СМЭВ 3 от 07.03.2023

Перечень типовых ошибок, возвращаемых Участнику при работе в СМЭВ 3 от 07.03.2023

| 702 КБ

Библиотеки для сборки клиента СМЭВ 3

Рекомендуемая версия библиотек для сборки клиента СМЭВ 3. Схема версии 1.1

Рекомендуемая версия библиотек для сборки клиента СМЭВ 3. Схема версии 1.1

| 8.43 МБ

Рекомендуемая версия библиотек для сборки клиента СМЭВ 3. Схема версии 1.2

Рекомендуемая версия библиотек для сборки клиента СМЭВ 3. Схема версии 1.2

| 8.38 МБ

Рекомендуемая версия библиотек для сборки клиента СМЭВ 3. Схема версии 1.3 от 23.04.2020

Рекомендуемая версия библиотек для сборки клиента СМЭВ 3. Схема версии 1.3 от 23.04.2020

| 23.36 МБ

Рекомендуемая версия библиотек для сборки клиента СМЭВ 3. Схема 1.3 с расширенными возможностями.

Рекомендуемая версия библиотек для сборки клиента СМЭВ 3. Схема 1.3 с расширенными возможностями.

| 606.7 КБ

Библиотека crypto-2.0 для создания и проверки ЭП

Библиотека crypto-2.0 для создания и проверки ЭП

Библиотека crypto-2.0 для создания и проверки ЭП

| 63.51 КБ

Другие документы

Требования к сети передачи данных участников информационного обмена (22.07.2023)

Требования к сети передачи данных участников информационного обмена (22.07.2023)

| 226.33 КБ

Формат руководства пользователя Вида сведений СМЭВ 3.0​

Формат руководства пользователя Вида сведений СМЭВ 3.0​

| 519.85 КБ

Правила разработки форматов взаимодействия с использованием Единого электронного сервиса Единой системы межведомственного электронного взаимодействия

Правила разработки форматов взаимодействия с использованием Единого электронного сервиса Единой системы межведомственного электронного взаимодействия

| 512.07 КБ

Протокол совместного тестирования Вида сведений Единой системы межведомственного электронного взаимодействия

Протокол совместного тестирования Вида сведений Единой системы межведомственного электронного взаимодействия

| 29.79 КБ

Уровень сложности
Простой

Время на прочтение
7 мин

Количество просмотров 17K

Привет ИТ-сообщество! Я Анастасия Пятько, аналитик-внедренец из РТЛабс. Это компания, которая развивает всем известные Госуслуги и пытается облегчить нашу бюрократическую жизнь.

Недавно мне довелось выступить на HighLoad++ 2022 с похожей темой: «СМЭВ. Сильно проще, чем кажется. Полезные советы, как стартовать интеграцию через СМЭВ3 и СМЭВ4». Организаторы знают своё дело. В зале была заинтересованная аудитория, которая задавала вопросы с неподдельным интересом. С некоторыми разговор у стенда продолжался ещё несколько часов. Так родилась идея — зафиксировать всё текстом в этой статье.

Начнём с небольшой предыстории. Цифровизация пришла в нашу большую страну определённо раньше того, как появились эксперты, которые смогли бы сразу сказать, как надо делать, придумали стандарты и протоколы. Регионы, ведомства, их подрядчики писали свои системы на разных языках программирования, строя различную архитектуру, а потом делали интеграции как получится. В какой-то момент систем стало много. Пришло понимание, что обмениваться информацией между собой без единого унифицированного фреймворка им стало просто невозможно. И вот 12 лет назад появилась Система межведомственного электронного взаимодействия (СМЭВ).

Что такое СМЭВ

СМЭВ — это тот транспорт, которым доставляются миллионы «конвертов», необходимых для оказания госуслуг. Через СМЭВ обмениваются информацией между собой:

  • федеральные и региональные ведомства

  • МФЦ

  • Госуслуги

  • Единая система идентификации и аутентификации (ЕСИА)

  • ряд коммерческих организаций

СМЭВ в цифрах:

Трафик СМЭВ, количество подключённых систем, скорость и безотказность

Трафик СМЭВ, количество подключённых систем, скорость и безотказность

Актуальных СМЭВ два: СМЭВ3 и СМЭВ4. При этом четвёртая версия не заменяет третью. Это две принципиально разные системы с одним предназначением — организация обменов между системами участников взаимодействия. Разница в том, что:

  • СМЭВ3 подходит, когда нужно гарантированно передать информацию

  • СМЭВ4 — когда на первом месте стоит скорость обмена данными

В этой статье речь пойдёт о третьей версии СМЭВ. Как ни крути, она пока остаётся наиболее востребованной. Однако популярность четвёртой растёт на глазах, и о ней я планирую написать в следующей статье.

Как работает СМЭВ3

Собственно, все сообщения в СМЭВ3 — это XML, составленные на основе XSD-схем самого транспорта и вида сведения, отправленные через веб-сервис.

По опыту предыдущих уже неактуальных версий системы в СМЭВ3 сделан упор на гарантии доставки. То есть «доставить любой ценой», несмотря на возможные технические проблемы на стороне любого из участников взаимодействия, — лозунг третьей СМЭВ.

Что такое очереди в СМЭВ3

Важная фишка СМЭВ3 — очереди. В самом транспорте для каждой зарегистрированной системы создаются как минимум 2 очереди: запросов и ответов.

Системы всех участников должны уметь формировать сообщения и подписывать их зарегистрированным сертификатом. Сообщения бывают трёх типов:

  • send — с основной информацией

  • get — для опроса очередей

  • ack — для подтверждения получения

Рассмотрим обмен между информационными системами двух ведомств, одна из которых инициирует обмен или запрашивает информацию, вторая — отвечает на запрос.

1. Инициатор отправляет запрос —SendRequest. Он попадает в очередь запросов ответчика. Там запрос будет храниться до тех пор, пока ответчик его не вычитает, но максимум — 14 дней.

Если за 14 дней запрос не вычитают, инициатору придёт «отбивка» от СМЭВ, что его запрос попал в архив.

2. Ответчик опрашивает очередь — GetRequest. Он должен делать это постоянно. И когда туда попадает запрос, ему возвращается непустой «конверт».

3. Ответчик обрабатывает запрос. Получив «конверт», система ответчика должна выполнить ряд действий: распарсить, уложить в базу и т. п. Затем система отправляет в СМЭВ «конверт» с подтверждением получения запроса — AckRequest. Это ещё один уровень для обеспечения гарантированной доставки. Если СМЭВ не получит от ответчика такое подтверждение, через 15 минут запрос снова вернётся в очередь.

4. Инициатор получает ответ. После того как система ответчика подготовит «конверт» с ответом, происходит всё ровно то же самое:

  • «конверт» попадает в очередь инициатора — SendResponse

  • инициатор его вычитывает — GetResponse

  • инициатор оправляет подтверждение о получении — AckResponse

Только тогда обмен считается завершённым.

Конечно, здесь ещё много нюансов:

  • существуют другие типы обменов, например рассылка

  • на стороне СМЭВ происходят различные проверки

  • формируются разные типы сообщений: статусные и об ошибках

Но в целом все обмены через СМЭВ3 устроены так, как я описала выше.

Что такое виды сведений в СМЭВ

Важную роль в СМЭВ3 играют такие сущности, как «Виды сведений» (ВС).

Схемами транспорта задаются условно-общие поля для всех обменов, например, для правильной маршрутизации, передачи вложений, подписи и т. п.

Схемами ВС задаются правила, по которым будет формироваться смысловая часть «конверта». То есть как раз та информация, ради которой и осуществляется обмен.

В итоге ВС представляют собой:

  1. Правила, по которым формируются запросы и ответы (XSD).

  2. Эталоны (XML) — примеры «конвертов» для работы эмулятора.

  3. Руководство пользователя — документ, составленный автоматически или вручную владельцем или создателем ВС, призванный помочь подключающимся участникам.

Виды сведений в СМЭВ3

Виды сведений в СМЭВ3

ВС в целом может создать и зарегистрировать любой участник взаимодействия. Таких ВС сейчас около 2 750.

Как подключиться к СМЭВ3

Чтобы стать участником взаимодействия, организации нужно пройти 7 шагов.

  1. Оформить заявку на регистрацию организации в СМЭВ. В заявке указывают нормативно-правовое обоснование подключения. В зависимости от типа организации и её целей, эту заявку могут рассмотреть либо очень быстро, либо долго — с выносом на президиум специальной комиссии.

  2. Организовать защищённый канал. Это также делается по заявке, в рамках которой вам предоставят и помогут настроить оборудование.

  3. Получить сертификаты аккредитованного удостоверяющего центра (АУЦ).

  4. Зарегистрировать одну или несколько своих систем с полученными сертификатами в СМЭВ через Личный кабинет участника взаимодействия (ЛК УВ). Выбрать вид сведения, по которому будете работать, или зарегистрировать свой.

  5. Настроить или разработать интеграционный модуль для подключения к СМЭВ. Здесь вам на помощь придёт наш адаптер СМЭВ3.

  6. Получить доступ к ВС, пройдя процедуру технической готовности (ПТГ) на тестовой среде через ЛК УВ.

  7. Переключиться на продуктивную среду.

Как устроен ЛК УВ

Если первые 3 шага инструкции более или менее понятны, то про остальные хотелось бы рассказать подробнее.

Есть у нас потрясающий ЛК УВ. Получить к нему доступ не составит труда, если выполнена заявка из первого пункта. Авторизация происходит под учётной записью ЕСИА. Единственное, администратору профиля вашей организации в ЕСИА нужно будет вас присоединить к организации.

Так выглядит ЛК УВ

Так выглядит ЛК УВ

В ЛК УВ автоматизированы все регламентированные процедуры, которые необходимо выполнить для полноценной работы в СМЭВ.

В несколько кликов можно:

  • зарегистрировать систему

  • поменять ей сертификат

  • получить доступ к ВС

  • зарегистрировать свой ВС

  • пройти ПТГ с эмулятором

  • проверить наполненность своих очередей

  • отследить судьбу обмена

  • сформировать отчёт и многое другое

ЛК УВ развивается семимильными шагами и завоёвывает сердца наших пользователей. Особенно рады те, кто знает, как было до его появления. Знаете, мы как-то считали: получилось, что ЛК УВ экономит участникам годы (!) жизни.

Среды в СМЭВ3

В СМЭВ3 мы предоставляем 3 среды: разработки, тестовую и продуктивную.

Среды в СМЭВ3

Среды в СМЭВ3

Среда разработки. Она даёт уникальную возможность — попробовать свои силы в СМЭВ, не имея ещё ни одного доступа и не дожидаясь выполнения первых пунктов.

На среде разработки можно создать демоверсию организации, зарегистрировать для неё пару систем, вид сведений и попробовать совершить обмены через СМЭВ.

Тестовая среда. Более популярна, чем среда разработки, потому что сюда перед выходом на прод надо обязательно попасть всем. А большинство поддерживают работоспособность своих тестовых систем и после выхода на прод.

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

Ещё одна важная штука для этих сред — сертификат для систем можно сгенерировать прямо в ЛК УВ за несколько секунд.

На тестовой среде помимо её прямого назначения, также проходится ПТГ для получения доступа к видам сведений.

Собственно, ПТГ — это полноценный обмен вашей системы в желаемой роли с нашим эмулятором

Собственно, ПТГ — это полноценный обмен вашей системы в желаемой роли с нашим эмулятором

Продуктивная среда. Здесь экспериментировать уже нежелательно. Доступна она только через защищённый канал. Конверты подписывать можно только сертификатами, полученными в АУЦ.

Интеграционный узел адаптера (ИУА) СМЭВ3

Лирическое отступление: любовь к аббревиатурам в нашей компании и госсекторе в принципе неспроста. У систем такие названия, чтобы можно было их однозначно идентифицировать. Вот так и с ИУА. Конечно, его любят называть просто «адаптер», но это вызывает недопонимание. Адаптерами подрядчики могут обозвать модули своих систем, а у кого-то разработаны и свои универсальные адаптеры СМЭВ. В СМЭВ4 адаптер — это вообще часть другого ПО.

Итак, ИУА СМЭВ3 — это клиентское ПО, поддерживающее все необходимые операции для выполнения обменов через СМЭВ3. Он разворачивается на стороне участника взаимодействия и предоставляет удобные для интеграции интерфейсы.

По сути, это прослойка между вашей системой и СМЭВ, которая облегчит вам жизнь в несколько раз.

ИУА можно поставить как на Windows, так и на Linux. Есть версия для кубера, а есть для домохозяйки: «далее, далее, ок, готово». Также имеется версия в комплекте со всем необходимым окружением: Java, криптопровайдер и СУБД.

Так выглядит интерфейс адаптера

Так выглядит интерфейс адаптера

Чем же поможет ИУА

  • Возьмёт на себя заботы с подписанием конвертов

  • Будет опрашивать ваши очереди, выполняя get с заданной вами частотой

  • Поможет удобно логировать все обмены

  • Позволит выбрать удобный интерфейс: amqp, rest api, soap, БД, через файловую систему и даже встроенный веб-интерфейс. Используя последний, кстати, можно вообще не разрабатывать свою информационную систему, а пользоваться только адаптером СМЭВ3

  • Сам подберёт конфигурацию для выбранной среды, обернёт в нужный формат передаваемые вложения, отправит статистику и т. д.

ИУА распространяется свободно, и мы настоятельно рекомендуем его использовать всем участникам взаимодействия.

Где почитать подробнее и куда бежать с вопросами

Единая система контекстной справки

Как любые уважающие себя системы, наши СМЭВ, ЛК УВ и ИУА, конечно же, обросли официальной документацией. Много страниц сложно читаемого текста.

Но также у нас есть классная база знаний в виде статей. Называется она Единая система контекстной справки (ЕСКС). Также здесь хранятся официальные документы и дистрибутивы. А ещё есть крайне полезный новостной раздел и форум.

База знаний СМЭВ3

База знаний СМЭВ3

Бот. Судьба сообщения и уведомления

Команда ЛК УВ совместно с другими, внешне не видимыми, но не менее значимыми командами разработали телеграм-бота. С ним можно общаться о судьбе своих обменов и получать уведомления о ключевых событиях, касающихся вас в СМЭВ.

Есть у нас официальный канал связи с эксплуатацией и другими участниками взаимодействия — Ситуационный центр. Там вам ответят здорово и красиво, но не очень быстро.

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

Идя в ногу со временем, мы активно ведём телеграм-канал «Новости СМЭВ+». Здесь вы можете не только узнать последние новости, но и задать под любой из них свой вопрос. Неважно, если он будет не в тему новости, — мы ответим!

СМЭВ — это сложная высоконагруженная система. Но мы очень стараемся, чтобы она казалась лёгкой для пользователей, особенно на самом сложном шаге — этапе подключения к ней.

Это всё, что хотелось бы рассказать. Надеюсь на ваш интерес и мотивацию к написанию новых статей.

Благодарю за внимание.

Редактор: Ольга Кочкина

Для подключения к СМЭВ 3.0 перечисленные ниже заявки следует направлять через личный кабинет ситуационного центра электронного правительства (СЦ).

1. Регистрация участника СМЭВ 3.0

Направить заявку, через личный кабинет Ситуационного центра https://sc.minsvyaz.ru/, на регистрацию участника в

тестовой

среде СМЭВ 3.0. по формам:

Приложение № 1.

ВНИМАНИЕ!!! Если Участник зарегистрирован в СМЭВ 2.0, то заполнять Заявку на присоединение к регламенту не требуется.

Ожидать регистрации как участника в тестовой среде СМЭВ 3.0. 

При успешной регистрации участника, направить аналогичную заявку для получения доступа к

продуктивной

среде.

2. Получение электронной подписи органа власти (ЭП-ОВ)

При необходимости получить электронную подпись органа власти (ЭП-ОВ) в аккредитованном удостоверяющем центре.

ВНИМАНИЕ!!! Для подключения к СМЭВ 3.0 вы можете использовать сертификат ЭП-ОВ, который применяете в СМЭВ 2.

3. Регистрация информационной системы (ИС) в СМЭВ 3.0

Направить заявку, через личный кабинет Ситуационного центра https://sc.minsvyaz.ru/, для регистрации информационной системы, подключаемой к

тестовой

среде СМЭВ 3.0 по форме:

ВАЖНО!!! К заявке необходимо приложить архивированном виде сертификат (в формате BASE64) ключа электронной подписи (ЭП-ОВ).

Ожидать регистрации информационной системы в тестовой среде СМЭВ 3.0.

При успешной регистрации информационной системы, направить аналогичную заявку для получения доступа к

продуктивной

среде.

4. Заявки на предоставление доступов к видам сведений (ВС) в СМЭВ 3.0

Направить заявку, через личный кабинет Ситуационного центра https://sc.minsvyaz.ru/ на предоставление доступа к виду сведений (ВС) в

тестовой

среде СМЭВ 3.0 по форме:

Ожидать предоставление доступа к виду сведений в тестовой среде СМЭВ 3.0.

При успешном получении доступа, направить аналогичную заявку для получения доступа к виду сведений в

продуктивной

среде.

Дополнительная информация

Написал(а):

s.sokolko

4 года, 11 месяцев назад

(0 комментариев)

Как мы уже писали в статье про СМЭВ 3, Система Межведомственного Электронного Взаимодействия уже давно востребована не только государственным учреждениями и органами власти, но и рядом коммерческих организаций. У наших клиентов также возникла необходимость взаимодействия со СМЭВ. История взаимодействия была начата ещё во времена “расцвета” СМЭВ 2, для которой не было готового Адаптера СМЭВ (как для СМЭВ 3). В то время для взаимодействия со СМЭВ 2 нами был разработан собственный Адаптер СМЭВ. Он всё ещё остаётся актуальным для интеграции с некоторыми сервисами СМЭВ, которые остаются работать на СМЭВ 2 (например, отправка и регистрация сертификатов в ЕСИА для Удостоверяющих Центров). Ориентировочной датой переноса всех сервисов на СМЭВ 3 называют март 2019 года, но всё может круто поменяться, учитывая специфику функционирования СМЭВ. В данной статье речь пойдёт о запуске бесплатного Адаптера СМЭВ 3 для взаимодействия с ним.

Отличия СМЭВ 2 от СМЭВ 3

Изначально мы планировали доработать наш Адаптер СМЭВ 2 собственной разработки для взаимодействия со СМЭВ 3. Но, как выяснилось, отличия двух систем не просто значительные, а радикальные. По сути, с точки зрения интеграции СМЭВ 2 не имеет почти ничего общего со СМЭВ 3. В СМЭВ 2 каждый поставщик данных (ФНС, ПФР, МВД) имел свой SOAP-сервис со своим файлом WSDL и особенностями работы. В СМЭВ 3 присутствует единый сервис, который является посредником между запрашивающей стороной (нами) и поставщиками информации. Более детально СМЭВ 3 описан в документе Методические рекомендации по работе с ЕСМЭВ

При выборе способа интеграции нужно учитывать, что передаваемые сообщения подписываются электронной подписью (ЭП) организации. Кроме того, при взаимодействии с единым сервисом СМЭВ 3 нужно использовать протокол SOAP с нестандартным алгоритмом каноникализации. Не совсем понятно, почему разработчики СМЭВ решили использовать свою каноникализацию, это уже останется на их совести. Само собой, свободных и открытых библиотек для данного алгоритма нет. Трудности есть и с подписыванием запросов SOAP по ГОСТ, т.к. не все языки программирования поддерживают ГОСТ “из коробки”. Эталонная реализация алгоритма каноникализации доступна только на Java, так что разработчики, использующие другие языки должны либо реализовывать данный алгоритм самостоятельно, либо отказаться от работы со СМЭВ.

Кроме того, при работе с российскими криптоалгоритмами по ГОСТ, согласно требованиям нашего законодательства к защите ключа электронной подписи, необходимо использовать сертифицированный криптопровайдер. То есть просто экспортировать приватный ключ из носителя ЭП и подписывать им запросы технически можно, но запрещено требованиями регуляторов в данной сфере. Это тоже накладывает свои ограничения на выбор технологии интеграции. Учитывая все эти аргументы, у нас получилось 3 варианта интеграции со СМЭВ 3.

Способ 1: полностью собственное решение на удобном нам языке (Python)

Адаптер СМЭВ 3 на Python

При таком подходе мы вынуждены экспортировать закрытый ключ в простой текстовый файл и защищать его каким-то образом. Для тестов такой вариант использовать можно, но для настоящего взаимодействия со СМЭВ нежелательно.

Способ 2: реализация собственного адаптера на Java

Адаптер СМЭВ 3 на Java

Данный способ использует для хранения закрытой части ключа КриптоПРО JCP. Такое решение соответствует законодательным требованиям РФ по защите ЭП, т.к. используется сертифицированный криптопровайдер. К недостаткам можно отнести поддержку не всех носителей ЭП и необходимость приобретения лицензии на КриптоПРО JCP. Библиотека smevx-crypto для Java распространяется свободно.

Мы решили не останавливаться на этом способе, т.к. он “прибит гвоздями” к Java, а для нас удобнее несколько иные технологии разработки.

Способ 3: бесплатный Адаптер СМЭВ 3

Адаптер СМЭВ: гибридный вариант

Мы выбрали за основу последний способ. При данном подходе за взаимодействие со СМЭВ 3 отвечает бесплатный адаптер СМЭВ от Ростелекома. Он полностью реализует функции асинхронной работы с единым сервисом СМЭВ (постановка в очередь запросов и формирование ответов). Подпись вычисляется через Trusted Java, ключ хранится в стандартном КриптоПРО CSP, который поддерживает очень большое количество носителей ЭП и имеет все необходимые сертификаты. Тут следует отметить, что требуется приобретение лицензий на Trusted Java и КриптоПРО CSP, но они довольно бюджетные и не оказали существенного влияния на общую смету проекта (порядка 3 000 руб. суммарно).

На схеме цветом выделены те сервисы, которые реализуются непосредственно нами на удобной нам технологии разработки ПО (Python). Благодаря возможности выбора способа интеграции (база данных, файловый обмен, SOAP) мы не привязаны к Java или каким-либо другим языкам программирования. Более подробно интерфейсы интеграции Адаптера СМЭВ описаны в руководстве администратора Адаптера.

Адаптер СМЭВ 3: подготовка к запуску

СМЭВ 3: регистрация

В нашем случае, организация уже имела доступ к СМЭВ 2, была зарегистрирована в СМЭВ и имела все необходимые учётные записи. Но, как оказалось, для подключения к СМЭВ 3 этого недостаточно. Для получения учётной записи СМЭВ 3 необходимо снова собрать все документы и пройти процедуру подключения. Процедура описана в FAQ на Технологическом портале СМЭВ. После успешного подключения, на электронную почту будет направлено зарегистрированное наименование участника (название организации) и мнемоника, которая понадобится в дальнейшем для настройки Адаптера СМЭВ.

Выбор программной платформы для адаптера

Платформы для адаптера СМЭВ 3

Согласно официальной документации на Адатер СМЭВ 3, поддерживается как Windows, так и Linux. Это неудивительно, т.к. он написан на Java и изначально задумывался как кроссплатформенное программное обеспечение. Тем не менее, после более детального изучения документации, стало ясно, что поддержка Linux только номинальная. В частности, в руководстве администратора адаптера СМЭВ детально расписано, какие библиотеки для Java необходимо установить на Windows, представлены сведения о криптопровайдерах и т.д. В разделе об установке на Linux написано дословно “1. Развернуть и настроить java JRE в среде Linux.”. Это максимум информации, которую можно почерпнуть из официального руководства по вопросу установки на Linux. После нашего запроса в техподдержку пришла стандартная отписка, что нужно “настроить те же компоненты, что и в варианте с Windows”. После этого вопрос с выбором платформы был решён в пользу ОС Microsoft.

Установка адаптера СМЭВ

Для установки под Windows мы использовали полезную видеоинструкцию с технологического портала СМЭВ 3. Единственное. что следует учитывать: для настройки лицензии Trusted Java необходимо установить VC++ redistributable (из состава меню самой Trusted Java). Без неё окошко ввода лицензии не появляется. После установки и запуска адаптера он настраивается полностью по видеоинструкции на работу с тестовой средой (адреса серверов). Нужно не забыть настроить мнемонику системы и указать интеграцию через файловое хранилище (это потребуется дальше). Если планируется использовать web-интерфейс адаптера, рекомендую после установки сделать резервную копию машины: добавляемые в систему виды сведений никогда не удаляются. Такая уж особенность адаптера.

Установка параметров ИС в адаптере СМЭВ 3

Тестовое взаимодействие со СМЭВ 3

Для того, чтобы иметь возможность работы с производственным контуром СМЭВ, необходимо обязательно пройти тестирование на тестовом контуре. Без соблюдения этого условия заявка на доступ к виду сведений будет сразу же отклонена. Тестирование предполагает отправку и получение эталонных запросов и ответов в адрес эмулятора СМЭВ. Результаты взаимодействия со СМЭВ по тестовому контуру отправляются в виде файлов с сообщениями адаптера как вложения к заявке на доступ к виду сведений. Для того, чтобы сообщения сохранялись в файлы, нужно в “Настройках конфигурации” Адаптера СМЭВ нажать кнопку “Показать расширенные настройки” и отметить галочку “12.2 Сохранение входящих/исходящих сообщений СМЭВ”

Адаптер СМЭВ: сохранение сообщений

После этого нужно скачать на технологическом портале СМЭВ 3 эталонные сообщения для тестируемого вида сведений. Для этого в соответствующем разделе (например, “Виды сведений федерального уровня”) нужно найти нужный нам промышленный ВС

СМЭВ 3: скачиваем Виды Сведений

Открыв карточку ВС, нужно скачать эталонные сообщения

СМЭВ 3: скачиваем эталонные сообщения ВС

Будет загружен архив с несколькими файлами xml. Данные файлы представляют собой те сообщения, которые адаптер СМЭВ 3 должен отправить в адрес эмулятора и ответы на них.

Для того, чтобы отправить эталонные сообщения, нам необходимо подготовить файлы отправки. Т.к. мы выбрали интеграцию через файловое хранилище, адаптер будет забирать файлы из папки %ADAPTER_ROOT%\integration\files\%MNEMONIC%\out и на их основании отправлять сообщения. Тут проблема заключается в том, что у адаптера несколько иной формат конверта (сообщения), чем у сервиса ЕСМЭВ. Подробнее о формате можно почитать в руководстве администратора адаптера СМЭВ. Ниже приводится пример содержимого файла в формате адаптера для отправки эталонного сообщения тестирования вида сведений “Выписки из ЕГРЮЛ по запросам органов государственной власти”:

<?xml version=»1.0″ encoding=»UTF-8″?>

<tns:ClientMessage xsi:schemaLocation=»urn://x-artefacts-smev-gov-ru/services/service-adapter/types smev-service-adapter-types.xsd» xmlns:n1=»http://www.altova.com/samplexml/other-namespace» xmlns:xsi=»http://www.w3.org/2001/XMLSchema-instance» xmlns:tns=»urn://x-artefacts-smev-gov-ru/services/service-adapter/types»>

  <tns:itSystem>111111</tns:itSystem>

  <tns:RequestMessage>

     <tns:RequestMetadata>

        <tns:clientId>3e83e83a-6a23-4908-b0d2-e3ad08fe2602</tns:clientId>

        <tns:createGroupIdentity>

           <tns:FRGUServiceCode>00000000000000000000</tns:FRGUServiceCode>

           <tns:FRGUServiceDescription>00000000000000000000</tns:FRGUServiceDescription>

        <tns:FRGUServiceRecipientDescription>00000000000000000000</tns:FRGUServiceRecipientDescription>

        </tns:createGroupIdentity>

        <tns:testMessage>true</tns:testMessage>

     </tns:RequestMetadata>

     <tns:RequestContent>

        <tns:content>

           <tns:MessagePrimaryContent>

<ns1:FNSVipULRequest xmlns:ns1=»urn://x-artefacts-fns-vipul-tosmv-ru/311-14/4.0.6″ ИдДок=»00000000-0000-0000-0000-000000000001″ НомерДела=»БН»>

<ns1:ЗапросЮЛ>

<ns1:ОГРН>5087746429843</ns1:ОГРН>

</ns1:ЗапросЮЛ>

</ns1:FNSVipULRequest>

           </tns:MessagePrimaryContent>

        </tns:content>

     </tns:RequestContent>

  </tns:RequestMessage>

</tns:ClientMessage>

Здесь 111111 — мнемоника системы, 3e83e83a-6a23-4908-b0d2-e3ad08fe2602 — идентификатор запроса. Он должен меняться при каждом запросе. Можно воспользоваться онлайн-генератором по ссылке: https://guidgenerator.com/

Как видно из примера, в блок MessagePrimaryContent помещается тело эталонного сообщения.

 После отправки сообщения нужно подождать некоторое время и в папке  %ADAPTER_ROOT%\messages\%MNEMONIC%\ появятся файлы, в которых будут находиться XML-сообщения запроса и ответа. Данные файлы следует сохранить и впоследствии прикрепить к заявке на доступ к виду сведений производственного контура СМЭВ. Операцию по тестированию следует повторить для всех эталонных сообщений в архиве.

 После того, как были получены все необходимые XML-файлы, подключение к СМЭВ производственного контура становится делом техники: нужно только оформить соответствующую заявку на доступ к нужному ВС и приложить файлы тестирования. В нашем случае доступ был предоставлен в течение трёх дней.

 Надеемся, наш опыт был Вам полезен. Удачи в работе со СМЭВ!

P.S. Также Вас может заинтересовать наш беспатный OpenSource Web-сервис для работы с Адаптером СМЭВ 3

Понравилась статья? Поделить с друзьями:

Это тоже интересно:

  • Подключение к электросетям частного дома пошаговая инструкция
  • Подключение к электронному бюджету пошаговая инструкция
  • Подключение multitronics vc731 инструкция полное описание
  • Подключение ip камеры через коммутатор к компьютеру инструкция
  • Подкачка колес камаз 43118 инструкция

  • Подписаться
    Уведомить о
    guest

    0 комментариев
    Старые
    Новые Популярные
    Межтекстовые Отзывы
    Посмотреть все комментарии