Биометрическая аутентификация по документу

Биометрическая аутентификация по документу это биометрическая аутентификация, которая осуществляется в результате сравнения лучшего кадра, полученного при определении живости лица, с фото лица, полученного при сканировании документа, удостоверяющего личность.

Основные этапы биометрической аутентификации по документу в CID:

1) ИС партнера запрашивает токен по логину и паролю, предоставленному CID

2) ИС партнера производит старт сессии в CID по полученному токену

3) СID стартует сессию и отображает пользователю ИС партнера экран выбора типа документа

4) Пользователь выбирает тип документа и CID отображает экран сканирования документа. В зависимости от выбранного документа сканируется:

2 стороны документа: лицевая и оборотная для удостоверения личности гражданина РК и для вида на жительство иностранного гражданина в РК,
только дно фото с документа при выборе международного паспорта (паспорт иностранного гражданина)

5) Пользователь осуществляет сканирование документа клиента и CID распознает данные документа и отображает экран с данными распознанного документа

6) Пользователь подтверждает распознанные данные и CID отображает экран биометрической аутентификации

7) Пользователь осуществляет сканирования лица клиента и CID проводит определение живости лица и выделение лучшего кадра

8) CID проводит сверку фото лица из документа с фото лица, полученного при аутентификации, завершает сессию и передает номер сессии в ИС партнера на указанный URI

9) ИС - партнера по номеру сессии получает данные сессии (данные документа, результаты биометрической аутентификации)

Токен, получаемый ИС партнера для сессии - одноразовый. Период жизизни токена состовляет 15 минут

Методы взаимодействия

Получение токена

Запрос

curl --location --request POST 'https://cid-backend.test.supreme-team.tech
/v1/customer-identification/session-token?identificationType=SCAN_DOCUMENT' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Y2lkLWNsaWVudDpwYXNzd29yZA==' \
--data ''

Параметры запроса

Заголовок

Параметр Значение Обязательный Коментарий

Параметр	Значение	Обязательный	Коментарий
identificationType	`SCAN_DOCUMENT`	Нет	Указатель на запуск сессии биометрической аутентификации по изображению с отсканированного документа, удостоверяющего личность

identificationType

SCAN_DOCUMENT

Нет

Указатель на запуск сессии биометрической аутентификации по изображению с отсканированного документа, удостоверяющего личность

Ответ

{
    "token": "eyJhbGciOiJIUzUxMiJ9.eyJzZXNzaW9uU2VjcmV0IjoiMjI3MmQyODAtZjA4Zi00M2VmLWJkODQtM2E0M2JkZDM1Mjc1IiwiZXhwIjoxNzQyOTgzNzg1fQ.oOptJPqKxv1LMUKfKnNevyx0hyYstjXiNIW2gbwpfAxoTxzoKd8FHYU2UYu-R79o4-1hbjIGNQUmRDW5X2DmQQ"
}

Старт сессии

https://cid.test.supreme-team.tech?token=$token

Структура запроса

Параметр

Тип

Обязательный

Описание

token

String

Yes

Токен, полученный в методе получения токена

Получение данных сессии

Запрос

curl --location 'https://cid.test.supreme-team.tech
/v1/customer-identification/6cd28065-a96e-40c0-91be-35da38610e1e/identification-result
' \
--header 'Authorization: Basic Y2lkLWNsaWVudDpwYXNzd29yZA==' \
--data ''

Структура запроса

Параметр

Тип

Обязательный

Описание

<идентификатор сессии>

String

Yes

Уникальный идентификатор сессии в CID

identification-result

String

Yes

Тип запрашиваемых данных.

identification-result - вернуть результат сессии.

В случае если сессия завершилась успешно, то ИС получит данные документа удостоверяющего личность и данные биометрической аутентификации.

В случае если сессия завершилась успешно, то ИС получит данные ошибки

Ответ

Пример - сессия завершена успешно (пользователь прошел биометрическую аутентификацию, данные документа удостоверения личности получены)

{
    "sessionId": "6cd28065-a96e-40c0-91be-35da38610e1e",
    "sessionStarted": "2024-03-27T12:10:34.745435Z",
    "sessionEnd": "2024-03-27T12:13:11.813523Z",
    "sessionStatus": "SUCCESS",
    "document": {
        "recognizedDocumentType": "ID_CARD",
        "countryCode": "KAZ",
        "documentNumber": "12345678",
        "firstName": "МАРЖАН",
        "lastName": "ТҰРСЫН",
        "patronymic": "АЛИ",
        "gender": "F",
        "dateOfBirth": "1986-07-12",
        "placeOfBirth": "АЛМАТЫ ОБЛ.",
        "nationality": "ҚАЗАҚ",
        "issueDate": "2020-10-08",
        "expireDate": "2030-10-07",
        "authority": "ҚАЗАҚСТАН РЕСПУБЛИКАСЫ ІІМ",
        "identificationNumber": "860712401756"
    },
    "liveness": {
        "verificationType": "VERIFICATION_3D",
        "selfieConfidenceLevel": 0.91967,
        "creationTime": "2024-03-27T12:13:07.397741Z",
        "responseTime": "2024-03-27T12:13:11.813523Z"
    },
    "errorInfo": null
}

Пример - сессия завершена не успешно пользователь завершил сессию (пользователь не прошел процесс получения данных с документа удостоверяющего личность или биометрическую аутентификацию)

{
    "sessionId": "bc8f8267-0c1d-44d0-8473-927035688941",
    "sessionStarted": "2024-03-28T07:48:25.045395Z",
    "sessionEnd": "2024-03-28T07:50:52.255556Z",
    "sessionStatus": "FAILED",
    "document": null,
    "liveness": null,
    "errorInfo": {
        "eventType": "LIVENESS_FAILED",
        "error": "CID_9",
        "errorMessage": "The face in the photo and the face on the document did not match, start the whole process again"
    }
}

Структура ответа

Параметр

Тип

Обязательный

Описание

sessionId

String

Yes

Уникальный идентификатор сессии в CID

sessionStarted

DateTime

Yes

Дата/время начала сессии в CID

sessionEnd

DateTime

Yes

Дата/время окончания сессии в CID

sessionStatus

String

Yes

Статус сессии в CID. Может принимать следующие значения:

SUCCESS - сессия завершена успешно биометрическая аутентификация пройдена
FAILED - сессия не завершена, остановлена пользователем

document

Object

Данные документа, удостоверяющего личность

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

Отчество

gender

String

YES

Пол. Передается:

F - для женщин
M - для мужчин

dateOfBirth

Data

YES

Дата рождения

placeOfBirth

String

Место рождения

nationality

String

YES

Указывается страна гражданства для документов: RESIDENCE_PERMIT и FOREIGN_PASSPORT
Указывается национальность для УЛ РК документа ID_CARD

issueDate

Data

Дата выдачи

expireDate

Data

YES

Срок действия

authority

String

Орган выдавший документ

identificationNumber

String

ИИН

liveness

Object

Данные биометрической аутентификации

verificationType

String

YES

Тип биометрической верификации примененной CID.

VERIFICATION_3D - была применена 3D Liveness

selfieConfidenceLevel

String

YES

Полученный коэффициент схожести лиц при сравнении эталонной фото лица в CID с лучшим кадром из процесса определения витальности лица

creationTime

DateTime

YES

Дата создания медиа материалов (прохождение лайвнеса)

responseTime

DateTime

YES

Дата/время формирования ответа

errorInfo

Object

Данные об ошибке

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 фиксируются следующие медиа-данные

Лучший снимок с изображением лица;
Видо-ролик определеия живости лица;
Фото документа удостоверяющеего личнность клиента.

Описание методов получения медиа-данных см., статью Получение медиа-данных сессии

PreviousClient Identification (CID) модуль NextБиометрическая аутентификация по эталонной фото, полученной от ИС партнера

Last updated 5 months ago