Поиск информации об учетной записи в ЕСИА

Атрибут	Значение
Название	esia-find-user
Наименование	Поиск информации об учетной записи в ЕСИА
Тип	Адаптер для взаимодействия с ЕСИА через СМЭВ3
Область применения	Межведомственное взаимодействие
Поставщик	Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации
Потребители	Кредитные организации, Операторы подвижной радиотелефонной связи
Версия ВС	1.0.1
Версия МР	3.5.0.1
Версия СМЭВ	СМЭВ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

Справочник кодов ЕСИА сред

Код	Среда
DEV	Тестовая среда
UAT	Тестовая среда
TESIA	Интеграционная тестовая среда (должна использоваться при тестировании получения сведений ИС потребителя)
TCOD	Тестовая среда
PROD	Продуктивная среда

Принимаемые параметры

Параметр	Описание	Обязательное	Пример
routing_code	Код маршрутизации на ЕСИА среду	+	TESIA
last_name	Фамилия	+	Тестов
first_name	Имя	+	Тест
middle_name	Отчество	- обязательно, если отчество присутствует в документе, удостоверяющем личность	Тестович
doc	Документ, удостоверяющий личность пользователя	+	Cоставной элемент Doc
email	Адрес электронной почты пользователя	-¹	test@mail.com
mobile	Номер мобильного телефона пользователя	-¹	+7(920)4021351
snils	СНИЛС пользователя	-¹	229-785-346 20
person_inn	ИНН пользователя (физического лица)	-¹	176056662438

Необходимо, чтобы был заполнен хотя бы 1 из необязательных элементов запроса вида сведений: email, mobile, snils, person_inn. Для наиболее эффективного поиска учётной записи рекомендуется указывать максимально возможное количество входных параметров.

Структура элемента 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	Статус учетной записи	+	trusted
matches	Перечень параметров, по которым была найдена учетная запись	+	["snils", "mobile", "idoc", "personinn"]
reg_date	Дата регистрации учетной записи	+	2017-11-14
auth_date	Дата последней авторизации пользователя	+	2022-02-23
cfm_typ	Тип подтверждения учетной записи	-	RA
biom_stu	Наличие биометрической информации (Y/N)	+	N

Структура элемента error

Детальная информация об ошибке

Параметр	Описание	Обязательное	Пример
code	Код ошибки	+
message	Описание ошибки	+

Примеры

Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:

{
  "routing_code": "TESIA",
  "last_name": "Тестов",
  "first_name": "Тест",
  "middle_name": "Тестович",
  "doc": {
    "type": "RF_PASSPORT",
    "series": "1111",
    "number": "111111",
    "issue_date": "2009-05-02"
  },
  "mobile": "+7(920)4021351",
  "snils": "229-785-346 20",
  "person_inn": "176056662438"
}

В случае корректной настройки должен прийти следующий ответ:

{
  "accounts": [
    {
      "oid": "1000349826",
      "stu": "trusted",
      "matches": [
          "snils",
          "mobile",
          "idoc",
          "personinn"
      ],
      "reg_date": "2017-11-14",
      "auth_date": "2022-02-23",
      "cfm_typ": "RA",
      "biom_stu": "N"
    }
  ]
}