Регистрация квалифицированного сертификата ключа проверки электронной подписи в ЕСИА
| Атрибут | Значение |
|---|---|
| Название | esia-register-cert |
| Тип | Адаптер для взаимодействия с ЕСИА через СМЭВ3 |
| Наименование | Регистрация квалифицированного сертификата ключа проверки электронной подписи в ЕСИА |
| Область применения | Межведомственное взаимодействие |
| Версия | 1.4.0 |
| Версия МР | 3.0 |
| Версия СМЭВ | СМЭВ3 |
Переменные окружения
| Название | Описание |
|---|---|
| CA_CERT | сертификат центра сертификации для подключения к rabbitmq |
| CLIENT_CERT | сертификат, используемый для подключения к rabbitmq |
| CLIENT_KEY | ключ, используемый для подключения к rabbitmq |
| MQ_HOST | хост rabbitmq |
| MQ_PORT | порт rabbitmq |
| SMEV_SERVICE | название смэв сервиса, на который будут отправляться запросы |
| ROUTING_CODE | код маршрутизации на ЕСИА среду |
Переменные для конфигурирования подключения к БД:
DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.
Справочник кодов ЕСИА сред
| Код | Среда |
|---|---|
| DEV | Тестовая среда |
| UAT | Тестовая среда |
| TESIA | Интеграционная тестовая среда (должна использоваться при тестировании получения сведений ИС потребителя) |
| TCOD | Тестовая среда |
| PROD | Продуктивная среда |
Принимаемые параметры
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| routing_code | Код маршрутизации на ЕСИА среду | - возьмется из переменной окружения ROUTING_CODE |
DEV |
| serial_number | Серийный номер сертификата ключа КЭП | + | 77665544 |
| issuer_org_name | Имя организации-издателя сертификата ключа КЭП | + | УД001 |
| start_date | Дата начала действия сертификата ключа КЭП | + | 01.01.2018 |
| expiry_date | Дата окончания действия сертификата ключа КЭП | + | 31.12.2018 |
| owner_type | Тип владельца сертификата | + | PSO |
| snils1 | СНИЛС пользователя | - | 135-419-238 52 |
| person_inn2 | ИНН пользователя (физического лица) | - | 176056662438 |
| lastname1 | Фамилия | - | Иванов |
| firstname1 | Имя | - | Иванович |
| middlename1 | Отчество | - обязательно, если владелец сертификата – физическое лицо, должностное лицо организации или ИП (и отчество присутствует в документе, удостоверяющем личность) |
Иванович |
| gender1 | Пол | - | М M - мужской F - женский |
| birth_date1 | Дата рождения пользователя | - | 18.07.1987 |
| birth_place | Место рождения пользователя | - | Ачинск |
| doc1 | Документ, удостоверяющий личность пользователь | - | Составной элемент doc |
| citizenship1 | Гражданство пользователя. Строка, содержащая символы согласно классификатору ОКСМ |
- | RUS |
| ogrn3 | ОГРН | - | 8224922259568 |
| org_inn4 | ИНН организации | - | 3143852491 |
1 - обязательно, если владелец сертификата — физическое лицо, должностное лицо организации или ИП.
2 - обязательно для сертификатов, выданных физическим лицам или индивидуальным предпринимателям.
3 - необходимо заполнять, когда ownerType = ORG или IB, или SYS. Когда ownerType = PSO, то не указывается.
4 - необходимо заполнять, когда ownerType = ORG или SYS. Когда ownerType = PSO или IB, то не указывается.
Справочник типов владельцев сертификата
| Код | Среда |
|---|---|
| PSO | Сертификат физического лица |
| ORG | Сертификат должностного лица организации |
| IB | Индивидуальный предприниматель (ИП) |
| SYS | Сертификат информационной системы организации |
Структура элемента doc
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| type | Тип документа, удостоверяющего личность | + | RF_PASSPORT |
| series | Серия документа | + | 0489 Строка. Для паспорта РФ имеет формат XXXX, для заграничного паспорта гражданина РФ имеет формат XX, для документа иностранного гражданина – не более 32 символов |
| number | Номер документа | + | 123456 Строка. Для паспорта РФ имеет формат ХХХХХХ, для заграничного паспорта гражданина РФ имеет формат XXXXXXX, для документа иностранного гражданина – не более 32 символов |
| issue_id | Идентификатор организации, выдавшей документ. Строка: для паспорта РФ — код подразделения в формате XXXXXX; для документа иностранного гражданина не заполняется |
- | 123456 |
| issue_date | Дата выдачи документа | + | 10.09.2000 |
| expiry_date | Дата окончания срока действия документа для паспорта гражданина РФ не указывается – элемент должен отсутствовать в запросе |
- | 27.06.2012 |
Типы документов, удостоверящих личность
| Код | Описание документа |
|---|---|
| RF_PASSPORT | Паспорт гражданина РФ |
| FID_DOC | Документ иностранного гражданина |
Параметры ответа
status - статус выполнения операции description - описание статуса выполнения опирации errors - список ошибок
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"serial_number": "77665544",
"issuer_org_name": "УД001",
"start_date": "01.01.2018",
"expiry_date": "31.12.2018",
"owner_type": "PSO",
"snils": "229-785-346 20",
"person_inn": "176056662438",
"lastname": "Тестов",
"firstname": "Тест",
"middlename": "Тестович",
"gender": "M",
"birth_date": "11.11.1988",
"birth_place": "Уссурийск",
"doc": {
"type": "RF_PASSPORT",
"series": "1111",
"number": "111111",
"issue_date": "01.10.2017"
},
"citizenship": "RUS"
}
Пример запроса для информационной системы
{
"routing_code": "DEV",
"serial_number": "77665544",
"issuer_org_name": "УД001",
"start_date": "01.01.2018",
"expiry_date": "31.12.2018",
"owner_type": "SYS",
"ogrn": "8224922259568",
"org_inn": "3143852491"
}
В случае корректной настройки должен прийти следующий ответ:
{
"status": "SUCCEEDED",
"description": "Операция успешно выполнена"
}