Google is committed to advancing racial equity for Black communities. See how.
Эта страница переведена с помощью Cloud Translation API.
Switch to English

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

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

#include < gatekeeper.h >

Поля данных

hw_device_t общий
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 * желаемый_пароль_длины_пароля_секретного_пароля, * enpassword_handled_product
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_treen provided_password_length, uint_ol_ *t ** request, authroll_length)
int (* delete_user ) (Const структура gatekeeper_device * DEV, uint32_t UID)
int (* delete_all_users ) (Const структура gatekeeper_device * DEV)

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

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

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

hw_device_t общий

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

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

INT (* delete_all_users) (Const структура gatekeeper_device * Dev)

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

INT (* delete_user) (Const структура 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_tpassword_password_control_uint32 * желаемый_пароль_в_доле_интервола **, uint_password_password_code_intl_int32

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

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

Параметры:

  • dev: указатель на gatekeeper_device, полученный через вызовы gatekeeper_open
  • uid: идентификатор пользователя Android
  • current_password_handle: текущий зарегистрированный дескриптор пароля, который пользователь хочет заменить. Может иметь значение NULL, если в настоящее время нет зарегистрированного пароля.
  • current_password_handle_length: длина в байтах буфера, на который указывает current_password_handle. Должен быть 0, если current_password_handle равен NULL.
  • current_password: текущий пароль пользователя в виде обычного текста. Если присутствует, он ДОЛЖЕН проверяться на current_password_handle.
  • current_password_length: размер в байтах буфера, на который указывает current_password. Должен быть 0, если current_password равен NULL.
  • желаемый_пароль: новый пароль, который пользователь хочет ввести в виде обычного текста. Не может быть 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 provided_password_length * uhint_town_request, uhint_town_length_request, uhint_town_quest

Проверяет соответствие provided_password enrolled_password_handle.

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

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

Параметры:

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

Возврат:

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

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


Документация для этой структуры была создана из следующего файла:
  • оборудование / libhardware / включают / оборудование / gatekeeper.h