Биометрическая аутентификация по документу
Биометрическая аутентификация по документу это биометрическая аутентификация, которая осуществляется в результате сравнения лучшего кадра, полученного при определении живости лица, с фото лица, полученного при сканировании документа, удостоверяющего личность.
Основные этапы биометрической аутентификации по документу в CID:
1) ИС партнера запрашивает токен по логину и паролю, предоставленному CID
2) ИС партнера производит старт сессии в CID по полученному токену
3) СID стартует сессию и отображает пользователю ИС партнера экран выбора типа документа
4) Пользователь выбирает тип документа и CID отображает экран сканирования документа. В зависимости от выбранного документа сканируется:
2 стороны документа: лицевая и оборотная для удостоверения личности гражданина РК и для вида на жительство иностранного гражданина в РК,
только дно фото с документа при выборе международного паспорта (паспорт иностранного гражданина)
5) Пользователь осуществляет сканирование документа клиента и CID распознает данные документа и отображает экран с данными распознанного документа
6) Пользователь подтверждает распознанные данные и CID отображает экран биометрической аутентификации
7) Пользователь осуществляет сканирования лица клиента и CID проводит определение живости лица и выделение лучшего кадра
8) CID проводит сверку фото лица из документа с фото лица, полученного при аутентификации, завершает сессию и передает номер сессии в ИС партнера на указанный URI
9) ИС - партнера по номеру сессии получает данные сессии (данные документа, результаты биометрической аутентификации)
Методы взаимодействия
Получение токена
Запрос
Параметры запроса
Заголовок
identificationType
Нет
Указатель на запуск сессии биометрической аутентификации по изображению с отсканированного документа, удостоверяющего личность
Ответ
Старт сессии
Структура запроса
Параметр
Тип
Обязательный
Описание
token
String
Yes
Токен, полученный в методе получения токена
Получение данных сессии
Запрос
Структура запроса
Параметр
Тип
Обязательный
Описание
<идентификатор сессии>
String
Yes
Уникальный идентификатор сессии в CID
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
Вид документа удостоверяющего личность. Может принимать следующие значения
RESIDENCE_PERMIT - Вид на жительство РК
ID_CARD - УЛ гражданина РК
PA - Международный паспорт
countryCode
String
YES
Код страны (ISO 3166-1 Alfa-3), выдавшей документ
Для УЛ РК и ВНЖ РК - KAZ
Для паспортов иностранцев, код указанный в их документах
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
Указывается страна гражданства для документов: RESIDENCE_PERMIT и FOREIGN_PASSPORT
Указывается национальность для УЛ РК документа ID_CARD
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
Полученный коэффициент схожести лиц при сравнении эталонной фото лица в CID с лучшим кадром из процесса определения витальности лица
creationTime
DateTime
YES
Дата создания медиа материалов (прохождение лайвнеса)
responseTime
DateTime
YES
Дата/время формирования ответа
errorInfo
Object
No
Данные об ошибке
eventType
String
Yes
Событие/этап на котором произошла ошибка
error
String
Yes
Код ошибки
errorMessage
String
Yes
Текст ошибки
Ошибки
Код ошибки
Описание ситуации при которой возникла ошибка
CID_5
Фото документа распознать не удалось, некачественное изображение. Предъявленный документ не является документом удостоверяющим личность (фантик от конфеты) или другие проблемы в результате которых нет возможности распознать данные с документа
CID_6
На распознание передан документ с истекшим сроком, клиент должен предоставить действующий документ
CID_7
Документ номер Х предоставлялся ранее, но фото лица на документе который предоставлялся ранее не совпадает с фото лица на документе которое представлено сейчас.
CID_8
Лучший кадр при прохождении лайвнеса не выделен, нужно еще раз отсканировать лицо
CID_9
Лицо на фото и лицо на документе не совпали, начните весь процесс заново
CID_10
Фото лица не совпало с эталонным фото
CID_11
Непредвиденная ошибка при обработке запроса со стороны CID (например, ошибки доступа к БД и прочие тех ошибки).
CID_17
CID идентифицировала токен как не валидный (нарушена уникальность)
CID_18
CID идентифицировала завершенную сессию по данному токену
Получение медиа-данных сессии
В рамках данной сессии в CID фиксируются следующие медиа-данные
Лучший снимок с изображением лица;
Видо-ролик определеия живости лица;
Фото документа удостоверяющеего личнность клиента.
Описание методов получения медиа-данных см., статью Получение медиа-данных сессии
Last updated
Was this helpful?