Биометрическая аутентификация по эталонной фото, полученной от ИС партнера

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

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

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

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

3) СID стартует сессию и отображает отображает экран биометрической аутентификации

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

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

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

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

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

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

Запрос

curl --location 'https://cid-backend.test.supreme-team.tech
/v1/customer-identification/session-token?identificationType=REFERENCE_DATA' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic $some_credentials' \
--data '{
    "identificationNumber": "111111111111",
    "portrait": "base64_image"
}'

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

Заголовок

Параметр	Значение	Коментарий
identificationType	REFERENCE_DATA	Указатель на запуск сессии биометрической аутентификации по эталонному изображению лица, переданному из ИС партнера

Тело запроса

Параметр	Тип	Обязательный	Описание
identificationNumber	String	Да	ИИН физического лица
portrait	base64	Да	Фото с изображением лица

Ответ

{
    "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": "58fc4416-291a-45d4-829b-f2dca4b34fb5",
    "sessionStarted": "2024-05-21T21:22:09.459957Z",
    "sessionEnd": "2024-05-21T21:23:16.48968Z",
    "sessionStatus": "SUCCESS",
    "document": null,
    "liveness": {
        "verificationType": "VERIFICATION_3D",
        "selfieConfidenceLevel": 0.91438,
        "creationTime": "2024-05-21T21:23:15.164436Z",
        "responseTime": "2024-05-21T21:23:16.48968Z"
    },
    "error": 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
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 фиксируются следующие медиа-данные

• Лучший снимок с изображением лица;

• Видо-ролик определеия живости лица.

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