#include < gatekeeper.h >

Поля данных
hw_device_t	общий

интервал(*	enroll )(const struct Gatekeeper_device dev, uint32_t uid, const uint8_t current_password_handle, uint32_t current_password_handle_length, const uint8_t current_password, uint32_t current_password_length, const uint8_t desired_password, uint32_t желаемая_длина_пароля, uint8_t *зарегистрирован _password_handle, uint32_t enrolled_password_handle_length)

интервал(*	проверить )(const struct Gatekeeper_device dev, uint32_t uid, uint64_t Challenge, const uint8_t enrolled_password_handle, uint32_t enrolled_password_handle_length, const uint8_t provided_password, uint32_t Provide_password_length, uint8_t auth_token, uint32_t auth_token _length, bool *request_reenroll)

интервал(*	delete_user )(const struct Gatekeeper_device *dev, uint32_t uid)

интервал(*	delete_all_users )(const struct Gatekeeper_device *dev)

Подробное описание

Определение в строке 41 файла Gatekeeper.h .

Полевая документация

hw_device_t общий

Распространенные методы устройства привратника. Как указано выше, это должен быть первый член keymaster_device.

Определение в строке 46 файла Gatekeeper.h .

int(* delete_all_users)(const struct Gatekeeper_device *dev)

Определение в строке 173 файла Gatekeeper.h .

int(* delete_user)(const struct Gatekeeper_device *dev, uint32_t uid)

Определение в строке 159 файла Gatekeeper.h .

int(* enroll)(const struct Gatekeeper_device *dev, uint32_t uid, const uint8_t *current_password_handle, uint32_t current_password_handle_length, const uint8_t *current_password, uint32_t current_password_length, const uint8_t *desired_password, uint32_t желаемая_длина_пароля, uint8_t ** enrolled_password_handle, uint32_t *enrolled_password_handle_length)

Регистрирует желаемый_пароль, который должен быть получен из выбранного пользователем PIN-кода или пароля, с закрытым ключом фактора аутентификации, используемым только для регистрации данных фактора аутентификации.

Если уже был зарегистрирован пароль, его следует указать в current_password_handle вместе с текущим паролем в current_password, который должен проверяться на соответствие current_password_handle.

Параметры:

dev: указатель на Gatekeeper_device , полученный посредством вызовов Gatekeeper_open.
uid: идентификатор пользователя Android
current_password_handle: текущий зарегистрированный дескриптор пароля, который пользователь хочет заменить. Может быть нулевым, если в данный момент не зарегистрирован пароль.
current_password_handle_length: длина в байтах буфера, на который указывает current_password_handle. Должно быть 0, если current_password_handle имеет значение NULL.
current_password: текущий пароль пользователя в виде обычного текста. Если он представлен, он ДОЛЖЕН сверяться с current_password_handle.
current_password_length: размер в байтах буфера, на который указывает current_password. Должно быть 0, если текущий_пароль имеет значение NULL.
желаемый_пароль: новый пароль, который пользователь желает зарегистрировать в виде обычного текста. Не может быть НУЛЕМ.
желаемая_длина_пароля: длина в байтах буфера, на который указывает желаемый_пароль.
enrolled_password_handle: в случае успеха будет выделен буфер с новым дескриптором пароля, ссылающимся на пароль, указанный в желаемом_пароле. Этот буфер можно использовать при последующих вызовах для регистрации или проверки. Вызывающая сторона отвечает за освобождение этого буфера посредством вызова delete[]
enrolled_password_handle_length: указатель на длину в байтах буфера, выделенного этой функцией и на который указывает *enrolled_password_handle_length.

Возврат:

0 в случае успеха
Код ошибки < 0 в случае сбоя или
Значение тайм-аута T > 0, если повторную попытку вызова не следует выполнять до тех пор, пока не истечет T миллисекунд.

В случае ошибки enrolled_password_handle не будет выделен.

Определение в строке 91 файла Gatekeeper.h .

int(*verify)(const struct Gatekeeper_device *dev, uint32_t uid, uint64_t Challenge, const uint8_t *enrolled_password_handle, uint32_t enrolled_password_handle_length, const uint8_t *provided_password, uint32_t Provide_password_length, uint8_t **auth_token, uint32_t *auth _token_length, bool *request_reenroll)

Проверяет соответствие предоставленного_пароля enrolled_password_handle.

Реализации этого модуля могут сохранять результат этого вызова для подтверждения актуальности аутентификации.

В случае успеха записывает адрес токена проверки в auth_token, который можно использовать для подтверждения проверки пароля другим доверенным службам. Клиенты могут передавать в качестве этого значения значение NULL.

Параметры:

dev: указатель на Gatekeeper_device , полученный посредством вызовов Gatekeeper_open.
uid: идентификатор пользователя Android
запрос: необязательный запрос для аутентификации или 0. Используется, когда отдельный аутентификатор запрашивает проверку пароля или для аутентификации транзакционного пароля.
enrolled_password_handle: текущий зарегистрированный дескриптор пароля, который пользователь хочет проверить.
enrolled_password_handle_length: длина в байтах буфера, на который указывает enrolled_password_handle.
предоставленный_пароль: текстовый пароль, который необходимо проверить по дескриптору enrolled_password_handle.
предоставленный_пароль_длина: длина в байтах буфера, на который указывает предоставленный_пароль.
auth_token: в случае успеха буфер, содержащий токен аутентификации, полученный в результате этой проверки, назначается *auth_token. Вызывающая сторона отвечает за освобождение этой памяти посредством вызова delete[]
auth_token_length: в случае успеха длина токена аутентификации, присвоенного *auth_token, в байтах будет присвоена *auth_token_length.
request_reenroll: запрос к верхним уровням на повторную регистрацию проверенного пароля в связи со сменой версии. Не устанавливается, если проверка не удалась.

Возврат:

0 в случае успеха
Код ошибки < 0 в случае сбоя или
Значение тайм-аута T > 0, если повторную попытку вызова не следует выполнять до тех пор, пока не истечет T миллисекунд. В случае ошибки токен аутентификации не будет выделен.

Определение в строке 141 файла Gatekeeper.h .

Документация для этой структуры была создана из следующего файла:

Аппаратное обеспечение/libhardware/include/hardware/ gatekeeper.h

Справочник по структуре Gatekeeper_device

Поля данных

Подробное описание

Полевая документация