Министерство иностранных дел Российской Федерации

Руководство пользователя

электронного сервиса смэв

Сервис подтверждения факта приобретения гражданства Российской Федерации в консульских учреждениях Российской Федерации

Дата: 28.03.2012г.

Версия: 0.3

Листов: 23

АННОТАЦИЯ

Данный документ является шаблоном типового руководства пользователя электронного сервиса СМЭВ, которое в соответствии с п. 48 Приказа Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 000 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия» является обязательным для предоставления Поставщиком в адрес Оператора СМЭВ.

Инструкция по использованию:

·  [Текст], написанный серым шрифтом в квадратных скобках, является руководством по заполнению разделов шаблона и при формировании документа должен быть удален.

·  Текст, выделенный жёлтым маркером, является примером заполнения раздела и при формировании документа должен быть удален.

·  Текст без специальных выделений является обязательным для использования в документе и не подлежит удалению.

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

СОДЕРЖАНИЕ

НЕ нашли? Не то? Что вы ищете?

1 Общие сведения.. 5

1.1 Руководящие документы.. 5

1.2 Описание электронного сервиса. 5

1.3 Операции (методы) электронного сервиса. 6

1.4 Сценарии использования. 6

1.5 Схема взаимодействия. 6

1.6 Связи с другими электронными сервисами. 7

2 Руководство пользователя.. 7

2.1 Операция «Запрос о фактах изменения гражданства». 7

2.1.1 Общие сведения. 7

2.1.2 Описание входных параметров. 7

2.1.3 Описание выходных параметров. 7

2.1.4 Коды возвратов. 8

2.1.5 Контрольные примеры.. 8

3 Методика испытаний.. 12

3.1 Общие условия. 12

3.2 Параметры испытаний на тестовой среде. 12

3.3 Параметры испытаний на продуктивной среде. 13

3.4 Особые условия. 13

4 Приложения.. 13

4.1 Описание сервиса (WSDL) 13

4.2 Описание общих структур данных. 16

4.3 Описания справочников. 17

4.4 Иные приложения. 18

изменения

Версия

Дата

Автор

Изменения

0.1

27.07.2011

Заполнение документа

0.2

27.09.2011

Изменения в связи с обновлением сервиса для соответствия методическим рекомендациям версии 2.3.4.

0.3

28.03.2012

Изменения в связи с обновлением сервиса для соответствия методическим рекомендациям версии 2.4.4.

термины/СОКРАЩЕНИя

Термин/сокращение

Описание

СМЭВ

Система межведомственного электронного взаимодействия

Поставщик

Организация-владелец электронного сервиса

WSDL

Web Services Description Language — язык описания веб-сервисов.

XSD

XML Schema definition - язык описания структуры XML документа.

SOAP

Simple Object Access Protocol - протокол обмена структурированными сообщениями в распределённой вычислительной среде.

XML

eXtensible Markup Language — расширяемый язык разметки.

2  Общие сведения

2.1 Руководящие документы

Основанием для разработки данного документа является требование п. 48 Приказа Министерства связи и массовых коммуникаций Российской Федерации от 01.01.01 г. № 000 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия» в соответствии с которым, для подключения информационной системы к системе межведомственного электронного взаимодействия Поставщик предоставляет Оператору СМЭВ следующие документы:

паспорт электронного сервиса, регистрируемого в системе взаимодействия;

методику испытаний электронного сервиса, регистрируемого в системе взаимодействия, включая контрольный пример обращения к электронному сервису;

руководство пользователя электронного сервиса, регистрируемого в системе взаимодействия.

Основанием для создания и использования электронного сервиса являются перечисленные ниже документы.

Нормативно-правовые документы:

Постановление Правительства Российской Федерации от 8 сентября 2010 г. № 000 «О единой системе межведомственного электронного взаимодействия»;

Приказ Министерства связи и массовых коммуникаций Российской Федерации от 01.01.01 г. № 000 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия»;

Распоряжение Правительства Российской Федерации от 17 марта 2011 г. «Об утверждении перечня документов (сведений), обмен которыми между органами и организациями при оказании государственных услуг и исполнении государственных функций осуществляется в электронном виде».

Технологические стандарты:

-  «Методические рекомендации по разработке веб-сервисов СМЭВ»;

-  «Рекомендации по применению ЭЦП при межведомственном взаимодействии».

2.2 Описание электронного сервиса

Наименование:

Сервис проверки приобретения гражданства

Назначение:

Подтверждение факта приобретения гражданства Российской Федерации либо выхода из гражданства Российской Федерации в консульских учреждениях Российской Федерации

Поставщик:

Министерство иностранных дел Российской Федерации (МИД)

Область применения:

Межведомственное взаимодействие

2.3 Операции (методы) электронного сервиса

Электронный сервис проверки приобретения гражданства обеспечивает обработку запросов о приеме в гражданство и выходе из гражданства. Электронный сервис включает методы, обеспечивающие:

Проверку по ФИО и дате рождения факта приобретения гражданства Российской Федерации либо выхода из гражданства Российской Федерации в консульских учреждениях Российской Федерации

Метод

Назначение

Код: FindKDNation

Наименование: Запрос о фактах изменения гражданства

Принимает электронное сообщение с указанием ФИО и даты рождения и возвращает информацию о зарегистрированных в консульских загранучреждениях фактах изменения гражданства указанным лицом.

2.4 Сценарии использования

Сервис функционирует в синхронном режиме. Информационная система ведомства вызывает сервис и запрашивает информацию о фактах изменения гражданства, сервис формирует и передает ответ, содержащий требуемую информацию.

2.5 Схема взаимодействия

В рамках взаимодействия информационная система ведомства направляет в адрес сервиса следующие типы сообщений:

Сообщения с запросами информации об изменении гражданства

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

Схема взаимодействия представлена на рисунке 1.

Рисунок 1 «Схема взаимодействия»

2.6 Связи с другими электронными сервисами

Данный сервис не имеет связей с другими сервисами.

3  Руководство пользователя

3.1 Операция «Запрос о фактах изменения гражданства»

3.1.1 Общие сведения

Код операции:

FindKDNation

Наименование операции:

Запрос о фактах изменения гражданства

Назначение операции:

Операция предназначена для получения информации об изменении гражданства заданным лицом в консульских загранучреждениях

3.1.2 Описание входных параметров

Входные данные: FindKDNation

№

Код параметра

Описание параметра

Обязательность

Способ заполнения/Тип

Комментарий

1

Request

Данные запроса

+

tns:smevreqAppData

Описание в Приложении «Описание общих структур данных»

3.1.3 Описание выходных параметров

Выходные данные: FindKDNation

№

Код параметра

Описание параметра

Обязательность

Способ заполнения/Тип

Комментарий

1

Response

Данные ответа на запрос

+

tns:smevresAppData

Описание в Приложении «Описание общих структур данных»

Параметры комплексного типа описаны в приложении «Описание общих структур данных».

3.1.4 Коды возвратов

№

Код возврата

Описание кода возврата

Условия возникновения

Комментарий

1

oeOk

Запрос выполнен успешно

Данный код возврата соответствует успешному выполнению запроса

2

oeAccessDeniedError

Запрос не выполнен: ошибка входа в систему

Данный код возврата соответствует ситуации, когда указанные в запросе (Req:Account) параметры UserName и Password не являются правильными для использования сервиса.

3

oeQueryExecutingError

Запрос не выполнен: ошибка выполнения

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

Данный код возврата является признаком неработоспособности сервиса

3.1.5 Контрольные примеры

Пример применения параметра GetFieldsLength для получения ответа с полностью заполненными полями с максимально возможной длиной полей. Также в данном примере кодом возврата является oeOk, что обозначает успешное выполнение запроса.

Запрос

<?xml version="1.0" encoding="utf-8"?><soap:Envelope xmlns:soap="http://schemas. xmlsoap. org/soap/envelope/" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www. w3.org/2001/XMLSchema" xmlns:wsse="http://docs. oasis-open. org/wss/2004/01/oasiswss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs. oasis-open. org/wss/2004/01/oasiswss-wssecurity-utility-1.0.xsd"><soap:Header><wsse:Security soap:actor="http://smev. *****/actors/smev"><wsse:BinarySecurityToken EncodingType="http://docs. oasis-open. org/wss/2004/01/oasiswss-soap-message-security-1.0#Base64Binary" ValueType="http://docs. oasis-open. org/wss/2004/01/oasiswss-x509-token-profile-1.0#X509v3" wsu:Id="CertId">MIID6zCCA5qgAwIBAgIKHiCv7wAAAAAMmzAIBgYqhQMCAgMwga4xIzAhBgkqhkiG9w0BCQEWFHVjMl8xQG5paS52b3NraG9kLnJ1MQswCQYDVQQGEwJSVTEVMBMGA1UEBx4MBBwEPgRBBDoEMgQwMS8wLQYDVQQKHiYEIAQ+BEEEOAQ9BEQEPgRABDwEQgQ1BEUEPQQ+BDsEPgQzBDgEODEPMA0GA1UECx4GBCMEEwQjMSEwHwYDVQQDHhgEIwQmACAEHgQTBBgEJgAgBBIEIwBfADEwHhcNMTEwOTIxMDgzMzAwWhcNMTIwOTIxMDgzNDAwWjCBvDELMAkGA1UEBhMCUlUxHTAbBgNVBAoeFAQcBBgEFAAgBCAEPgRBBEEEOAQ4MWswaQYDVQQLHmIEHAQ4BD0EOARBBEIENQRABEEEQgQyBD4AIAQ4BD0EPgRBBEIEQAQwBD0EPQRLBEUAIAQ0BDUEOwAgBCAEPgRBBEEEOAQ5BEEEOgQ+BDkAIAQkBDUENAQ1BEAEMARGBDgEODEhMB8GA1UEAx4YBBwEGAQUACAEIAQ+BEEEQQQ4BDgAIAAxMGMwHAYGKoUDAgITMBIGByqFAwICJAAGByqFAwICHgEDQwAEQB/ElWCGeA1HFOq1YZD6sNcrNL4kLCwlYQrH1KkuAvgminwGRlRMByh/pZoWuNRKXf5tZYDhFEOPVgijFA+0+rijggGGMIIBgjAOBgNVHQ8BAf8EBAMCBPAwGQYJKoZIhvcNAQkPBAwwCjAIBgYqhQMCAhUwKwYDVR0lBCQwIgYGKoUDBQEDBgcqhQMCAiIGBggrBgEFBQcDAgYFKoUDZAIwHQYDVR0OBBYEFD6Ei5MdqEBQOGrmNFctVRffE3l+MB8GA1UdIwQYMBaAFGVXd2DhW+pZAHoybxb1Tg0FCyUpMDkGCSsGAQQBgjcVCgQsMCowCAYGKoUDBQEDMAkGByqFAwICIgYwCgYIKwYBBQUHAwIwBwYFKoUDZAIwZwYDVR0fBGAwXjAsoCqgKIYmaHR0cDovL3VjLm9naWMucnUvQ0RQL1VDX09HSUNfVlVfMS5jcmwwLqAsoCqGKGh0dHA6Ly9jZHAxLm9naWMucnUvQ0RQL1VDX09HSUNfVlVfMS5jcmwwRAYIKwYBBQUHAQEEODA2MDQGCCsGAQUFBzAChihodHRwOi8vdWMub2dpYy5ydS9DRVJUUy9VQ19PR0lDX1ZVXzEuY2VyMAgGBiqFAwICAwNBABylkUXoCPLuS668TSNfYoKmR5rUayivL4mGfEKGznj2A+Wu9EeXN0SjBjeDC1PDJlTZpYjcGfO9eQOPqlSyFqM=</wsse:BinarySecurityToken><Signature xmlns="http://www. w3.org/2000/09/xmldsig#"><SignedInfo><CanonicalizationMethod Algorithm="http://www. w3.org/2001/10/xml-exc-c14n#" /><SignatureMethod Algorithm="http://www. w3.org/2001/04/xmldsig-more#gostrgostr3411" /><Reference URI="#body"><Transforms><Transform Algorithm="http://www. w3.org/2001/10/xml-exc-c14n#" /></Transforms><DigestMethod Algorithm="http://www. w3.org/2001/04/xmldsig-more#gostr3411" /><DigestValue>77YR6PUrJw0UXhHAA1ATYR6V3RcjCstRtn4vt+8809Q=</DigestValue></Reference></SignedInfo><SignatureValue>0L0N3Hdd3orWxSoCKnfIMfYhp1ZmGEaONpT1GRE3cplWzGUtlNF4M0nhRBF19MSslgeXyIFyytgp4onZxbmppQ==</SignatureValue><KeyInfo><wsse:SecurityTokenReference><wsse:Reference ValueType="http://docs. oasis-open. org/wss/2004/01/oasiswss-x509-token-profile-1.0#X509v3" URI="#CertId" /></wsse:SecurityTokenReference></KeyInfo></Signature></wsse:Security></soap:Header><soap:Body wsu:Id="body"><FindKDNation xmlns="http://np-smev-niias"><Message xmlns="http://smev. *****/rev111111"><Sender><Code>MIDR01001</Code><Name>АИС потребителя</Name></Sender><Recipient><Code>MIDR02001</Code><Name>АИС "Гражданство МИД"</Name></Recipient><Originator><Code>MIDR01001</Code><Name>АИС потребителя</Name></Originator><TypeCode>GSRV</TypeCode><Status>REQUEST</Status><Date>T17:10:00.312+03:00</Date><ExchangeType>2</ExchangeType><CaseNumber>926203</CaseNumber><TestMsg>Тест</TestMsg></Message><MessageData xmlns="http://smev. *****/rev111111"><AppData Id="AppData"><Signature xmlns="http://www. w3.org/2000/09/xmldsig#"><SignedInfo><CanonicalizationMethod Algorithm="http://www. w3.org/2001/10/xml-exc-c14n#" /><SignatureMethod Algorithm="http://www. w3.org/2001/04/xmldsig-more#gostrgostr3411" /><Reference URI="#AppData"><Transforms><Transform Algorithm="http://www. w3.org/2000/09/xmldsig#enveloped-signature" /><Transform Algorithm="http://www. w3.org/2001/10/xml-exc-c14n#" /></Transforms><DigestMethod Algorithm="http://www. w3.org/2001/04/xmldsig-more#gostr3411" /><DigestValue>MmB8BixMd6A+LU6TZXDqMR5UmhU2CFTerELQQsunX6w=</DigestValue></Reference></SignedInfo><SignatureValue>HLr5FH8Eaj1E2tIp8ze3Osy7sm4eGUbOeSHBBwapEO6rJk2PYbjLNzcCScQdiCPNvtnwWMk85xHvA67W79YBSg==</SignatureValue><KeyInfo><X509Data><X509Certificate>MIID6zCCA5qgAwIBAgIKHiCv7wAAAAAMmzAIBgYqhQMCAgMwga4xIzAhBgkqhkiG9w0BCQEWFHVjMl8xQG5paS52b3NraG9kLnJ1MQswCQYDVQQGEwJSVTEVMBMGA1UEBx4MBBwEPgRBBDoEMgQwMS8wLQYDVQQKHiYEIAQ+BEEEOAQ9BEQEPgRABDwEQgQ1BEUEPQQ+BDsEPgQzBDgEODEPMA0GA1UECx4GBCMEEwQjMSEwHwYDVQQDHhgEIwQmACAEHgQTBBgEJgAgBBIEIwBfADEwHhcNMTEwOTIxMDgzMzAwWhcNMTIwOTIxMDgzNDAwWjCBvDELMAkGA1UEBhMCUlUxHTAbBgNVBAoeFAQcBBgEFAAgBCAEPgRBBEEEOAQ4MWswaQYDVQQLHmIEHAQ4BD0EOARBBEIENQRABEEEQgQyBD4AIAQ4BD0EPgRBBEIEQAQwBD0EPQRLBEUAIAQ0BDUEOwAgBCAEPgRBBEEEOAQ5BEEEOgQ+BDkAIAQkBDUENAQ1BEAEMARGBDgEODEhMB8GA1UEAx4YBBwEGAQUACAEIAQ+BEEEQQQ4BDgAIAAxMGMwHAYGKoUDAgITMBIGByqFAwICJAAGByqFAwICHgEDQwAEQB/ElWCGeA1HFOq1YZD6sNcrNL4kLCwlYQrH1KkuAvgminwGRlRMByh/pZoWuNRKXf5tZYDhFEOPVgijFA+0+rijggGGMIIBgjAOBgNVHQ8BAf8EBAMCBPAwGQYJKoZIhvcNAQkPBAwwCjAIBgYqhQMCAhUwKwYDVR0lBCQwIgYGKoUDBQEDBgcqhQMCAiIGBggrBgEFBQcDAgYFKoUDZAIwHQYDVR0OBBYEFD6Ei5MdqEBQOGrmNFctVRffE3l+MB8GA1UdIwQYMBaAFGVXd2DhW+pZAHoybxb1Tg0FCyUpMDkGCSsGAQQBgjcVCgQsMCowCAYGKoUDBQEDMAkGByqFAwICIgYwCgYIKwYBBQUHAwIwBwYFKoUDZAIwZwYDVR0fBGAwXjAsoCqgKIYmaHR0cDovL3VjLm9naWMucnUvQ0RQL1VDX09HSUNfVlVfMS5jcmwwLqAsoCqGKGh0dHA6Ly9jZHAxLm9naWMucnUvQ0RQL1VDX09HSUNfVlVfMS5jcmwwRAYIKwYBBQUHAQEEODA2MDQGCCsGAQUFBzAChihodHRwOi8vdWMub2dpYy5ydS9DRVJUUy9VQ19PR0lDX1ZVXzEuY2VyMAgGBiqFAwICAwNBABylkUXoCPLuS668TSNfYoKmR5rUayivL4mGfEKGznj2A+Wu9EeXN0SjBjeDC1PDJlTZpYjcGfO9eQOPqlSyFqM=</X509Certificate></X509Data></KeyInfo></Signature><Request xmlns="http://np-smev-niias"><SNameRus>Тестов</SNameRus><NameRus>Тест</NameRus><GivenName>Тестович</GivenName><BirthDate>01.01.2001</BirthDate><Account><UserName>smev</UserName><Password>smev2011</Password></Account><GetFieldsLength>true</GetFieldsLength></Request></AppData></MessageData></FindKDNation></soap:Body></soap:Envelope>

Ответ на запрос в случае успешного исполнения

Из за большого объема этот материал размещен на нескольких страницах:
1 2