Запрос персональных данных пользователя ЕСИА при наличии его согласия
| Атрибут | Значение |
|---|---|
| Название | esia-personal-data-docs |
| Тип | Адаптер для межведомственного взаимодействия |
| Наименование | Запрос персональных данных при наличии согласия пользователя ЕСИА |
| Назначение | Вид сведений предназначен для получения внешней ИС запрошенных персональных данных зарегистрированного пользователя ЕСИА. |
| Идентификатор | VS02984v001-TABL00 |
| Область применения | Межведомственное взаимодействие |
| Версия ВС | 1.0.0 |
| Версия МР | 3.5 |
| Версия СМЭВ | СМЭВ3 |
| Поставщик | ОИВ (Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации) |
| Потребители | ОИВ, ОМСУ, КО, Верховный суд РФ, Страховые организации, осуществляющие ОСАГО |
Описание бизнес-процесса взаимодействия: ИС клиента передает через Агредатор в СМЭВ запрос персональных данных зарегистрированного пользователя. ЕСИА получает из СМЭВ запрос и направляет обратно через СМЭВ в Агредатор ответ на запрос, содержащий статус выполнения операции и/или запрошенные персональные данные. Агредатор направляет в ИС клиента полученную информацию.
Особые условия
Вид сведений применим только к подтвержденным учетным записям пользователей в ЕСИА. Решение о передаче персональных данных конкретного пользователя принимается ЕСИА на основании получения оператором ИС клиента (зарегистрированной в ЕСИА под определенной мнемоникой) согласия данного пользователя на передачу указанной информации.
flowchart LR;
A[ИС организации] <--> B[Агредатор];
B <--> C[СМЭВ];
C <--> D[ЕСИА];
Переменные окружения
| Название | Описание |
|---|---|
| CA_CERT | Сертификат центра сертификации для подключения к rabbitmq |
| CLIENT_CERT | Сертификат, используемый для подключения к rabbitmq |
| CLIENT_KEY | Ключ, используемый для подключения к rabbitmq |
| MQ_HOST | Хост rabbitmq |
| MQ_PORT | Порт rabbitmq |
| SMEV_SERVICE | Название смэв сервиса, на который будут отправляться запросы |
Переменные для конфигурирования подключения к БД:
DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.
Переменные для конфигурирования отправки метрик в Elasticsearch:
ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX.
Принимаемые параметры
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| requests | Запрос ведомством персональных данных пользователя ЕСИА | + | Последовательность элементов Request |
Структура элемента Request
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| data_type | Тип запрашиваемого сведения или документа гражданина | + | inn |
| force | Признак-требование принудительного запроса сведения/документа в ведомстве (для сведения/документа, допускающего его запрос в ведомстве): true - необходимо принудительно (вне зависимости от того - есть запрошенное сведение/документ гражданина в ЕСИА или нет) запросить документ в ведомстве false (или элемент force отсутствует в запросе) - не выполнять принудительный запрос сведения/документа гражданина в ведомстве при наличии сведения/документа в ЕСИА |
- | true |
| person_data | Персональные данные пользователя в ЕСИА для поиска его учетной записи | + | Составной элемент PersonData |
Структура элемента PersonData
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| oid | Идентификатор (OID) учётной записи гражданина в ЕСИА | -1 | 1245500 |
| snils | СНИЛС гражданина | -1 | 000-510-864 81 |
| inn | ИНН гражданина | -1 | 706550310824 |
| fio_doc | Фамилия, имя, отчество и документ, удостоверяющий личность гражданина | -1 | Составной элемент FIODoc |
1 - должен присутствовать только один из элементов
Структура элемента FIODoc
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| lastname | Фамилия гражданина | + | Фамилия |
| firstname | Имя гражданина | + | Имя |
| middlename | Отчество гражданина (при наличии) | - | Отчество |
| id_doc | Документ, удостоверяющий личность гражданина | + | Составной элемент IdDoc |
Структура элемента IdDoc
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| type | Типы документов, удостоверящих личность гражданина на территории РФ: RF_PASSPORT – Паспорт гражданина РФ FRGN_PASS - Заграничный паспорт гражданина РФ FID_DOC - Паспорт иностранного гражданина |
+ | RF_PASSPORT |
| series | Серия документа, удостоверяющего личность гражданина (атрибут необязателен только для паспорта иностранного гражданина) | - | 0000 |
| number | Номер документа, удостоверяющего личность гражданина | + | 123456 |
| issue_date | Дата выдачи документа, удостоверяющего личность гражданина | + |
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| responses | Ответы на запрос поиска персональных данных пользователя ЕСИА | + | Последовательность элементов Response |
| _raw_attachments | Информация по всем вложениям всех записей | +1 | Последовательность элементов AggredatorAttachment |
1 - поле вспомогательное, и в будущем может быть удалено
Структура элемента Response
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| status_response | Статус выполнения операции. Принимает значения: SUCCEEDED – операция успешно выполнена (сведение или документ гражданина найден(о) и возвращён(ено) в ответе) PROCESSING - операция выполняется (отсутствующее сведение или документ гражданина запрашивается в ведомстве) FAULT - ошибка при выполнении операции (не найдена учётная запись гражданина, не найдено запрошенное сведение или документ и др.) |
+ | SUCCEEDED |
| error_status_info | Детальная информация об ошибке | - | Составной элемент ErrorStatusInfo |
| oid | Идентификатор учётной записи гражданина в ЕСИА | - | 12345678 |
| data_type | Тип найденного по запросу сведения или документа гражданина | - | fullName |
| info_req_data | Информация о запросах сведения или документа гражданина в ведомстве, возвращается в ответе на запрос вида сведений вместе со статусом PROCESSING или вместе со статусом SUCCEEDED в случае, если часть документа или сведения отсутствует и запрашивается в ведомстве | - | Последовательность элементов InfoReq |
| attachment | Информация о связанном вложении | - | Составной элемент AggredatorAttachment |
Структура элемента ErrorStatusInfo
| Параметр | Описание | Обязательное |
|---|---|---|
| code | Код ошибки | + |
| message | Описание ошибки | + |
Структура элемента InfoReq
| Параметр | Описание | Обязательное |
|---|---|---|
| request_id | Идентификатор запроса сведения или документа гражданина | + |
| context | Информация о запрашиваемом в ведомстве сведении или документе - для сведений или документов,получаемых из ведомств отдельными запросами (например, сведение или документ за отчётный временной период, сведение или документ за определённый календарный год или квартал календарного года, и т.п.) | - |
Структура элемента AggredatorAttachment
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| uuid | Идентификатор файла в хранилище | + | 4833e4c4385dc47f2d2a08469f246e7cd1f66f416691d0b5a92a00d722f8d4ec |
| checksum | Контрольная сумма | + | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
| created_at | Время загрузки файла | + | 2020-11-16T12:27:20.726+03:00 |
| tags | Последовательность строк-тегов файла | + | ["test"] |
| metadata | Метаданные | + | {} |
| delete_at | Время, когда файл будет удален из хранилища. В случае, если значение равно null - файл не будет удален | + | null |
| filename | Имя загруженного файла | + | test.txt |
| store | Хранилище, в котором хранится файл | + | db |
| identifier_in_store | Идентификатор файла в хранилище | + | 4833e4c4385dc47f2d2a08469f246e7cd1f66f416691d0b5a92a00d722f8d4ec |
| smev_id | Идентификатор вложения, используемый в СМЭВ конверте | + | attachment.txt |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"requests": [
{
"data_type": "inn",
"person_data": {
"snils": "000-510-864 81"
}
},
{
"data_type": "fullName",
"person_data": {
"snils": "000-510-864 81"
}
}
]
}
В случае корректной настройки должен прийти следующий ответ:
{
"responses": [
{
"status_response": "SUCCEEDED",
"oid": "1077138512",
"data_type": "inn"
},
{
"status_response": "SUCCEEDED",
"oid": "1077138512",
"data_type": "fullName"
}
],
"_raw_attachments": []
}