Поиск учетной записи в ЕСИА 1.4.6
Атрибут | Значение |
---|---|
Название | esia-search |
Наименование | Поиск учетной записи в ЕСИА |
Тип | Адаптер для взаимодействия с ЕСИА через СМЭВ3 |
Область применения | Межведомственное взаимодействие |
Поставщик | Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации |
Потребители | УЦ, Кредитные организации, МФЦ, РОИВ, ФОИВ, ОМСУ, Негосударственный пенсионный фонд |
Версия ВС | 1.4.6 |
Версия МР | 3.5.0.1 |
Версия СМЭВ | СМЭВ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
Справочник кодов ЕСИА сред
Код | Среда |
---|---|
DEV | Тестовая среда |
UAT | Тестовая среда |
TESIA | Интеграционная тестовая среда (должна использоваться при тестировании получения сведений ИС потребителя) |
TCOD | Тестовая среда |
PROD | Продуктивная среда |
Принимаемые параметры
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
routing_code | Код маршрутизации на ЕСИА среду | + | TESIA |
snils_operator | СНИЛС оператора центра обслуживания | + | 135-419-238 52 |
ra | Идентификатор центра обслуживаня | + | 1000321282 |
last_name | Фамилия | + | Тестов |
first_name | Имя | + | Тест |
middle_name | Отчество | - обязательно, если отчество присутствует в документе, удостоверяющем личность |
Тестович |
doc | Документ, удостоверяющий личность пользователя | + | Cоставной элемент Doc |
Адрес электронной почты пользователя | -1 | test@mail.com | |
mobile | Номер мобильного телефона пользователя | -1 | +7(920)4021351 |
snils | СНИЛС пользователя | -1 | 229-785-346 20 |
Необходимо, чтобы был заполнен хотя бы 1 из необязательных элементов запроса: email, mobile, snils. Для наиболее эффективного поиска учётной записи рекомендуется указывать максимально возможное количество входных параметров.
Структура элемента Doc
Документ, удостоверяющий личность пользователя
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
type | Тип документа, удостоверяющего личность | + | RF_PASSPORT |
series | Серия документа | - | 1111 |
number | Номер документа/Номер личного дела | + | 111111 |
issue_date | Дата выдачи документа | + | 2017-10-01 |
expiry_date | Дата окончания срока действия документа (для паспорта РФ не указывается, для заграничного паспорта РФ и документа иностранного гражданина - при наличии даты) | - | |
issued_by | Кем выдан документ | - |
Типы документов, удостоверящих личность
Код | Описание документа |
---|---|
RF_PASSPORT | Паспорт гражданина РФ |
FID_DOC | Документ иностранного гражданина |
FRGN_PASS | Заграничный паспорт гражданина РФ |
Параметры ответа
Сервис возвращает последовательность элементов о состоянии регистрации образцов, указанных в запросе.
accounts - список найденных учетных записей
или
errors - список ошибок
Структура элемента account
Информация о найденном аккаунте пользователя
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
oid | Идентификатор учетной записи | + | 1000349826 |
stu | Статус учетной записи | + | unverified |
matches | Перечень параметров, по которым была найдена учетная запись | + | ["snils", "mobile", "idoc"] |
reg_date | Дата регистрации учетной записи | + | 2017-11-14 |
cfm_typ | Тип подтверждения учетной записи | - | POS |
biom_stu | Наличие биометрической информации (Y/N) | + | N |
Структура элемента error
Детальная информация об ошибке
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
code | Код ошибки | + | |
message | Описание ошибки | + |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"routing_code": "TESIA",
"snils_operator": "135-419-238 52",
"ra": "1000321282",
"last_name": "Тестов",
"first_name": "Тест",
"middle_name": "Тестович",
"doc": {
"type": "RF_PASSPORT",
"series": "1111",
"number": "111111",
"issue_date": "2017-10-01"
},
"mobile": "+7(920)4021351",
"snils": "229-785-346 20"
}
В случае корректной настройки должен прийти следующий ответ:
{
"accounts": [
{
"oid": "1000349826",
"stu": "trusted",
"matches": [
"snils",
"mobile",
"idoc"
],
"reg_date": "2017-11-14",
"cfm_typ": "RA",
"biom_stu": "N"
}
]
}