Повторная биометрическая аутентификация по данным международного паспорта
Повторная биометрическая аутентификация по данным международного паспорта проводится на основании фото с изображением лица, полученного при первичной биометрической аутентификации, проведенной в рамках процесса Биометрическая идентификация по документу, где в качестве типа документа для аутентификации использовался паспорт иностранного гражданина. В данном процессе биометрическая аутентификация осуществляется в результате сравнения лучшего кадра, полученного при определении живости лица, с фото лица, полученного при первичной биометрической аутентификации
Основные этапы повторной биометрической аутентификации по данным международного паспорта
1) ИС партнера запрашивает токен по логину и паролю, предоставленному CID, в запросе передает номер иностранного паспорта, полученный при первичной биометрической аутентификации. Если данные физ., лица по номеру паспорта найдены, то CID возвращает токен, в противном случае будет возвращена ошибка
2) ИС партнера производит старт сессии в CID по полученному ативному токену.
3) CID отображает экран биометрической аутентификации
4) Пользователь осуществляет сканирования лица клиента и CID проводит определение живости лица и выделение лучшего кадра
5) CID проводит сверку фото лица полученного при первичной аутентификации с фото лица, полученного в результате текущего сканирования
6) ИС - партнера по номеру сессии получает данные сессии (данные международного паспорта предъявленного пользователем при первой биометрической аутентификации в случае если биометрическая аутентификация пройдена успешно, данные о результатах сравнения лиц при биометрической аутентификации, данные об ошибке если сессия завершилась ошибкой)
Методы взаимодействия
Получение токена
Запрос
Параметры запроса
Заголовок
identificationType
FOREIGN_PA_REPEAT_BIOMETRICS
ДА
Указатель на запуск сессии повторной биометрической аутентификации по международному паспорту
redirectUri
Указывается в ИС Партнера
ДА
ИС Партнера передает ссылку на ресурс, куда CID вернет данные сессии.
Ограничения: указанная ссылка на ресурс должна быть в списке разрешенных. Партнер за ранее должен предоставить BTSD список uri для включения в список разрешенных
state
Указывается в ИС Партнера
НЕТ
Состояние системы Партнера которое будет передано CID в редиректе на ресурс ИС партнера в неизменном состоянии. Длина параметра должна быть не более 500 символов
Тело запроса
foregnPassportBiometrics
Object
ДА
Объект в котором передаются данные для процесса повторной биометрической аутентификации
identificationNumberType
String
ДА
Тип идентификационного пераметра физического лица. Допустима передача следующего типа - INTERNATIONAL_PASSPORT_NUMBER - (идентификационным параметром является номер международного паспорта иностранца)
identificationNumber
String
ДА
Идентификационный параметр физического лица, передается номер паспорта.
countryCode
String
ДА
Код страны (ISO 3166-1 Alfa-3), выдавшей документ. Параметр обязателен для передачи
confidenceLevel
String
Коэффициент схожести, указывается десятичная дробь до 1
Допустимое значение должно входить в диапазон:
minConfidenceLevel, по умолчанию = 0,3
max ConfidenceLevel, по умолчанию = 0,6
Если параметр не передан, то для процесса биометрической аутентификации берется значение confidenceLevel заданное по умолчанию для всей системы и равное 0,4
allowFaceMatchFailure
Boolean
Если операция низко-рисковая, то должен быть передан параметр со значением TRUE, иначе параметр не передается
Ответ
Старт сессии
Структура запроса
Параметр
Тип
Обязательный
Описание
token
String
Yes
Токен, полученный в методе получения токена
Получение данных сессии
Структура запроса
Параметр
Тип
Обязательный
Описание
<идентификатор сессии>
String
Yes
Уникальный идентификатор сессии в CID
identification-result
String
Yes
Тип запрашиваемых данных.
identification-result - вернуть результат сессии.
В случае если сессия завершилась успешно, то ИС получит данные документа удостоверяющего личность и данные биометрической аутентификации.
В случае если сессия завершилась успешно, то ИС получит данные ошибки
Ответ
Пример - сессия завершена успешно (пользователь прошел биометрическую аутентификацию)
Пример - сессия завершена не успешно пользователь завершил сессию (пользователь не прошел биометрическую аутентификацию)
Структура ответа
Параметр
Тип
Обязательный
Описание
sessionId
String
Yes
Уникальный идентификатор сессии в CID
sessionStarted
DateTime
Yes
Дата/время начала сессии в CID
sessionEnd
DateTime
Yes
Дата/время окончания сессии в CID
sessionStatus
String
Yes
Статус сессии в CID. Может принимать следующие значения:
SUCCESS - сессия завершена успешно биометрическая аутентификация пройдена
FAILED - сессия не завершена, остановлена пользователем
document
Object
No
Данные документа, удостоверяющего личность
recognizedDocumentType
String
YES
Вид документа удостоверяющего личность.
Может принимать следующие значения FOREIGN_PASSPORT (Паспорт иностранца)
countryCode
String
YES
Код страны (ISO 3166-1 Alfa-3), выдавшей документ.
documentNumber
String
YES
Номер документа
firstName
String
YES
Имя
lastName
String
YES
Фамилия
patronymic
String
NO
Отчество
gender
String
YES
Пол. Передается:
F - для женщин
M - для мужчин
dateOfBirth
Data
YES
Дата рождения
placeOfBirth
String
NO
Место рождения
nationality
String
YES
Указывается страна гражданства
issueDate
Data
NO
Дата выдачи
expireDate
Data
YES
Срок действия
authority
String
NO
Орган выдавший документ
identificationNumber
String
NO
ИИН
liveness
Object
No
Данные биометрической аутентификации
verificationType
String
YES
Тип биометрической верификации примененной CID.
VERIFICATION_3D - была применена 3D Liveness
selfieConfidenceLevel
String
YES
Полученный коэффициент схожести лиц при сравнении эталонной фото лица из гос., БД с лучшим кадром из процесса определения витальности лица
creationTime
DateTime
YES
Дата создания медиа материалов (прохождение лайвнеса)
responseTime
DateTime
YES
Дата/время формирования ответа
errorInfo
Object
No
Данные об ошибке
eventType
String
Yes
Событие/этап на котором произошла ошибка
error
String
Yes
Код ошибки
errorMessage
String
Yes
Текст ошибки
Ошибки
Перечень ошибок см., статью Ошибки сервисов CID
Получение медиа-данных сессии
В рамках данной сессии в CID фиксируются следующие медиа-данные
Лучший снимок с изображением лица;
Видо-ролик определеия живости лица.
Описание методов получения медиа-данных см., статью Получение медиа-данных сессии
Last updated
Was this helpful?