Запрос персональных данных пользователя ЕСИА при наличии его согласия
Атрибут | Значение |
---|---|
Название | esia-personal-data-docs |
Тип | Адаптер для межведомственного взаимодействия |
Наименование | Запрос персональных данных при наличии согласия пользователя ЕСИА |
Назначение | Вид сведений предназначен для получения внешней ИС запрошенных персональных данных зарегистрированного пользователя ЕСИА. |
Идентификатор | VS02984v001-TABL00 |
Область применения | Межведомственное взаимодействие |
Версия ВС | 1.0.0 |
Версия МР | 3.5 |
Версия СМЭВ | СМЭВ3 |
Поставщик | ОИВ (Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации) |
Потребители | ОИВ, ОМСУ, КО, Верховный суд РФ, Страховые организации, осуществляющие ОСАГО |
Описание бизнес-процесса взаимодействия: ИС клиента передает через Агредатор в СМЭВ запрос персональных данных зарегистрированного пользователя. ЕСИА получает из СМЭВ запрос и направляет обратно через СМЭВ в Агредатор ответ на запрос, содержащий статус выполнения операции и/или запрошенные персональные данные. Агредатор направляет в ИС клиента полученную информацию.
Вид сведений применим только к подтвержденным учетным записям пользователей в ЕСИА. Решение о передаче персональных данных конкретного пользователя принимается ЕСИА на основании получения оператором ИС клиента (зарегистрированной в ЕСИА под определенной мнемоникой) согласия данного пользователя на передачу указанной информации.
Переменные окружения
Название | Описание |
---|---|
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": []
}