1# Pin_auth 2 3## 概述 4 5### 功能简介 6 7口令认证是端侧设备不可或缺的一部分，为设备提供一种用户认证能力，可应用于设备解锁、支付、应用登录等身份认证场景。用户注册口令后，口令认证模块就可为设备提供密码解锁的功能，保证设备的安全使用。口令识别的整体架构如图1。 8 9基于HDF（Hardware Driver Foundation）驱动框架开发的Pin_auth驱动，Pin_auth驱动模型屏蔽硬件差异，为上层用户IAM子系统基础框架和口令认证SA提供稳定的口令认证基础能力，包括口令认证执行器列表查询、执行器信息查询、指定模板防暴信息查询、用户认证和执行器间的模板信息对账，以及口令的录入、认证、删除。 10 11**图1** 口令认证架构图 12 13 14 15### 基本概念 16用户认证框架与各个基础认证服务（包含口令认证、人脸识别等）组成的身份认证系统，支持用户认证凭据设置、删除、认证等基础功能。 17 18- 执行器 19 20 执行器是能够提供数据采集、处理、存储及比对能力的模块，各基础认证服务提供执行器能力，被身份认证框架调度完成各项基础能力。 21 22- 执行器安全等级 23 24 执行器提供能力时所在运行环境达到的安全级别。 25 26- 执行器角色 27 28 - 全功能执行器：执行器可独立处理一次凭据注册和身份认证请求，即可提供用户认证数据采集、处理、储存及比对能力。 29 30 - 采集器：执行器提供用户认证时的数据采集能力，需要和认证器配合完成用户认证。 31 32 - 认证器：认证器提供用户认证时的数据处理能力，读取存储的凭据模板与当前认证信息完成对比。 33 34- 执行器类型 35 36 同一种身份认证类型的不同认证方式会产生认证算法差异，设备器件差异也会导致算法差异，执行器根据支持的算法类型差异或对接的器件差异，会定义不同的执行器类型。 37 38- 用户认证框架公钥 & 执行器公钥 39 40 用户身份认证处理需要保证用户数据安全以及认证结果的准确性，用户认证框架与基础认证服务间的关键交互信息需要做数据完整性保护，各基础认证服务将提供的执行器能力对接到用户认证框架时，需要交换各自的公钥，其中： 41 42 - 执行器通过用户认证框架公钥校验调度指令的准确性。 43 44 - 执行器公钥可被用户认证框架用于校验认证结果的准确性，同时用于执行器交互认证时的校验交互信息的完整性。 45 46 47- 口令认证凭据模板 48 49 认证凭据是在用户设置认证凭据时由认证服务产生并存储，每个模板有一个ID，用于索引模板信息文件，在认证时读取模板信息并用于与当次认证过程中产生的认证数据做对比，完成身份认证。 50 51- 执行器对账 52 53 用户认证框架统一管理用户身份和凭据ID的映射关系，执行器对接到用户认证框架时，会读取用户身份认证框架内保存的该执行器的模板ID列表，执行器需要与自己维护的模板ID列表进行比对，并删除冗余信息。 54 55- IDL接口 56 57 接口定义语言（Interface Definition Language）通过IDL编译器编译后，能够生成与编程语言相关的文件：客户端桩文件，服务器框架文件。本文主要是通过IDL接口生成的客户端和服务端来实现Pin_auth服务和驱动的通信，详细使用方法可参考[IDL简介](https://gitee.com/openharmony/ability_idl_tool/blob/master/README.md)。 58 59- IPC通信 60 61 IPC（Inter Process Communication），进程间通信是指两个进程的数据之间产生交互，详细原理可参考[IPC通信简介](https://gitee.com/openharmony/communication_ipc/blob/master/README_zh.md)。 62 63- HDI 64 65 HDI（Hardware Device Interface），硬件设备接口，位于基础系统服务层和设备驱动层之间，是提供给硬件系统服务开发者使用的、统一的硬件设备功能抽象接口，其目的是为系统服务屏蔽底层硬件设备差异，具体可参考[HDI规范](../../design/hdi-design-specifications.md)。 66 67### 运作机制 68 69Pin_auth驱动的主要工作是为上层用户认证框架和Pin_auth服务提供稳定的口令认证的基础能力，保证口令认证的功能可以正常运行。开发者可基于HDF框架对不同芯片进行各自驱动的开发以及HDI层接口的调用。 70 71**图2** Pin_auth服务和pin_auth驱动接口 72 73 74 75### 约束与限制 76口令认证的实现需要在TEE安全环境中实现，口令凭据等数据的加密信息需要在安全环境中存储。 77## 开发指导 78 79### 场景介绍 80Pin_auth驱动的主要工作是为上层用户认证框架和Pin_auth服务提供稳定的口令认证基础能力，保证设备上口令认证功能可以正常运行。 81 82### 接口说明 83 84注：以下接口列举的为IDL接口描述生成的对应C++语言函数接口，接口声明见idl文件（/drivers/interface/pin_auth/v1_0/）。 85在本文中，口令凭据的录入、认证和删除相关的HDI接口如表1所示，表2中的回调函数分别用于口令执行器返回操作结果给框架和获取用户输入的口令信息。 86 87**表1** 接口功能介绍 88 89| 接口名称 | 功能介绍 | 90| ------------------------------- | ------------------------------------------- | 91| GetExecutorList(std::vector<sptr<IExecutor>>& executorList) | 获取执行器列表。 | 92| GetExecutorInfo(ExecutorInfo& info) | 获取执行器信息。 | 93| GetTemplateInfo(uint64_t templateId, TemplateInfo& info) | 获取指定templateId的模板信息。 | 94| OnRegisterFinish(const std::vector<uint64_t>& templateIdList,<br/>const std::vector<uint8_t>& frameworkPublicKey,<br/>const std::vector<uint8_t>& extraInfo) | 执行器注册成功后，获取用户认证框架的公钥信息；获取用户认证框架的template 列表用于对账。 | 95| OnSetData(uint64_t scheduleId, uint64_t authSubType, <br/>const std::vector<uint8_t> &data) | 回调函数，返回用户录入的口令子类型和录入的口令脱敏数据。 | 96| Enroll(uint64_t scheduleId, const std::vector<uint8_t>& extraInfo,<br/>const sptr<IExecutorCallback>& callbackObj) | 录入pin码。 | 97| Authenticate(uint64_t scheduleId, uint64_t templateId, const std::vector<uint8_t>& extraInfo, const sptr<IExecutorCallback>& callbackObj) | pin码认证。 | 98| Delete(uint64_t templateId) | 删除pin码模板。 | 99| Cancel(uint64_t scheduleId) | 通过scheduleId取消指定操作。 | 100| SendCommand(int32_t commandId, const std::vector<uint8_t>& extraInfo,<br/>const sptr<IExecutorCallback>& callbackObj) | 预留接口。 | 101 102**表2** 回调函数介绍 103 104| 接口名称 | 功能介绍 | 105| ------------------------------------------------------------ | -------------------- | 106| IExecutorCallback::OnResult(int32_t code, const std::vector<uint8_t>& extraInfo) | 返回操作的最终结果。 | 107| IExecutorCallback::OnGetData(uint64_t scheduleId, const std::vector<uint8_t>& salt,<br/> uint64_t authSubType)| 返回获取pin码数据信息。 | 108 109### 开发步骤 110 111以RK3568平台为例，我们提供了Pin_auth驱动DEMO实例，以下是目录结构及各部分功能简介。 112 113```text 114// drivers/peripheral/pin_auth 115├── BUILD.gn # 编译脚本 116├── bundle.json # 组件描述文件 117├── test # 测试用例 118└── hdi_service # Pin_auth驱动实现 119 ├── BUILD.gn # 编译脚本 120 ├── adaptor # 相关算法实现 121 ├── common # 公共接口实现 122 ├── database # 数据库实现 123 ├── main # 口令相关功能实现入口 124 └── service # Pin_auth驱动实现入口 125 ├── inc # 头文件 126 └── src # 源文件 127 ├── executor_impl.cpp # 认证、录入等功能接口实现 128 ├── pin_auth_interface_driver.cpp # Pin_auth驱动入口 129 └── pin_auth_interface_service.cpp # 获取执行器列表接口实现 130``` 131 132下面结合DEMO实例介绍驱动开发的具体步骤。 133 1341. 基于HDF驱动框架，按照驱动Driver Entry程序，完成pin_auth驱动开发，主要由Bind、Init、Release、Dispatch函数接口实现，详细代码参见[pin_auth_interface_driver.cpp](https://gitee.com/openharmony/drivers_peripheral/blob/master/pin_auth/hdi_service/service/src/pin_auth_interface_driver.cpp)文件。 135 136 ```c++ 137 // 通过自定义的HdfPinAuthInterfaceHost对象包含IoService对象和真正的HDI Service实现PinAuthInterfaceService对象 138 struct HdfPinAuthInterfaceHost { 139 struct IDeviceIoService ioService; 140 OHOS::sptr<OHOS::IRemoteObject> stub; 141 }; 142 143 // 服务接口调用响应接口 144 static int32_t PinAuthInterfaceDriverDispatch(struct HdfDeviceIoClient *client, int cmdId, struct HdfSBuf *data, struct HdfSBuf *reply) 145 { 146 IAM_LOGI("start"); 147 auto *hdfPinAuthInterfaceHost = CONTAINER_OF(client->device->service, 148 struct HdfPinAuthInterfaceHost, ioService); 149 150 OHOS::MessageParcel *dataParcel = nullptr; 151 OHOS::MessageParcel *replyParcel = nullptr; 152 OHOS::MessageOption option; 153 154 if (SbufToParcel(data, &dataParcel) != HDF_SUCCESS) { 155 IAM_LOGE("%{public}s:invalid data sbuf object to dispatch", __func__); 156 return HDF_ERR_INVALID_PARAM; 157 } 158 if (SbufToParcel(reply, &replyParcel) != HDF_SUCCESS) { 159 IAM_LOGE("%{public}s:invalid reply sbuf object to dispatch", __func__); 160 return HDF_ERR_INVALID_PARAM; 161 } 162 163 return hdfPinAuthInterfaceHost->stub->SendRequest(cmdId, *dataParcel, *replyParcel, option); 164 } 165 166 // 初始化接口 167 static int HdfPinAuthInterfaceDriverInit(struct HdfDeviceObject *deviceObject) 168 { 169 IAM_LOGI("start"); 170 std::shared_ptr<OHOS::UserIAM::PinAuth::PinAuth> pinHdi = 171 OHOS::UserIAM::Common::MakeShared<OHOS::UserIAM::PinAuth::PinAuth>(); 172 constexpr uint32_t SUCCESS = 0; 173 if (pinHdi == nullptr || pinHdi->Init() != SUCCESS) { 174 IAM_LOGE("Pin hal init failed"); 175 return HDF_FAILURE; 176 } 177 return HDF_SUCCESS; 178 } 179 180 // PinAuth驱动对外提供的服务绑定到HDF框架 181 static int HdfPinAuthInterfaceDriverBind(struct HdfDeviceObject *deviceObject) 182 { 183 IAM_LOGI("start"); 184 auto *hdfPinAuthInterfaceHost = new (std::nothrow) HdfPinAuthInterfaceHost; 185 if (hdfPinAuthInterfaceHost == nullptr) { 186 IAM_LOGE("%{public}s: failed to create create HdfPinAuthInterfaceHost object", __func__); 187 return HDF_FAILURE; 188 } 189 190 hdfPinAuthInterfaceHost->ioService.Dispatch = PinAuthInterfaceDriverDispatch; 191 hdfPinAuthInterfaceHost->ioService.Open = NULL; 192 hdfPinAuthInterfaceHost->ioService.Release = NULL; 193 194 auto serviceImpl = IPinAuthInterface::Get(true); 195 if (serviceImpl == nullptr) { 196 IAM_LOGE("%{public}s: failed to get of implement service", __func__); 197 return HDF_FAILURE; 198 } 199 200 hdfPinAuthInterfaceHost->stub = OHOS::HDI::ObjectCollector::GetInstance().GetOrNewObject(serviceImpl, 201 IPinAuthInterface::GetDescriptor()); 202 if (hdfPinAuthInterfaceHost->stub == nullptr) { 203 IAM_LOGE("%{public}s: failed to get stub object", __func__); 204 return HDF_FAILURE; 205 } 206 207 deviceObject->service = &hdfPinAuthInterfaceHost->ioService; 208 IAM_LOGI("success"); 209 return HDF_SUCCESS; 210 } 211 212 // 释放PinAuth驱动中的资源 213 static void HdfPinAuthInterfaceDriverRelease(struct HdfDeviceObject *deviceObject) 214 { 215 IAM_LOGI("start"); 216 auto *hdfPinAuthInterfaceHost = CONTAINER_OF(deviceObject->service, 217 struct HdfPinAuthInterfaceHost, ioService); 218 delete hdfPinAuthInterfaceHost; 219 IAM_LOGI("success"); 220 } 221 222 static struct HdfDriverEntry g_pinAuthInterfaceDriverEntry = { 223 .moduleVersion = 1, 224 .moduleName = "pinauth_interface_service", 225 .Bind = HdfPinAuthInterfaceDriverBind, 226 .Init = HdfPinAuthInterfaceDriverInit, 227 .Release = HdfPinAuthInterfaceDriverRelease, 228 }; 229 230 // 调用HDF_INIT将驱动入口注册到HDF框架中，在加载驱动时HDF框架会先调用Bind函数,再调用Init函数加载该驱动，当Init调用异常时，HDF框架会调用Release释放驱动资源并退出 231 HDF_INIT(g_pinauthinterfaceDriverEntry); 232 ``` 233 234 235 2361. 完成获取执行器列表接口实现，详细代码参见[pin_auth_interface_service.cpp](https://gitee.com/openharmony/drivers_peripheral/blob/master/pin_auth/hdi_service/service/src/pin_auth_interface_service.cpp)文件。 237 238 ```c++ 239 // 执行器实现类 240 class ExecutorImpl : public IExecutor, public NoCopyable { 241 public: 242 explicit ExecutorImpl(std::shared_ptr<OHOS::UserIAM::PinAuth::PinAuth> pinHdi); 243 virtual ~ExecutorImpl() {} 244 int32_t GetExecutorInfo(ExecutorInfo &info) override; 245 int32_t GetTemplateInfo(uint64_t templateId, TemplateInfo &info) override; 246 int32_t OnRegisterFinish(const std::vector<uint64_t> &templateIdList, 247 const std::vector<uint8_t> &frameworkPublicKey, const std::vector<uint8_t> &extraInfo) override; 248 int32_t OnSetData(uint64_t scheduleId, uint64_t authSubType, const std::vector<uint8_t> &data) override; 249 int32_t Enroll(uint64_t scheduleId, const std::vector<uint8_t> &extraInfo, 250 const sptr<IExecutorCallback> &callbackObj) override; 251 int32_t Authenticate(uint64_t scheduleId, uint64_t templateId, const std::vector<uint8_t> &extraInfo, 252 const sptr<IExecutorCallback> &callbackObj) override; 253 int32_t Delete(uint64_t templateId) override; 254 int32_t Cancel(uint64_t scheduleId) override; 255 int32_t SendCommand(int32_t commandId, const std::vector<uint8_t> &extraInfo, 256 const sptr<IExecutorCallback> &callbackObj) override; 257 258 private: 259 class ScheduleMap { 260 public: 261 uint32_t AddScheduleInfo(const uint64_t scheduleId, const uint32_t commandId, 262 const sptr<IExecutorCallback> callback, const uint64_t templateId, const std::vector<uint8_t> salt); 263 uint32_t GetScheduleInfo(const uint64_t scheduleId, uint32_t &commandId, sptr<IExecutorCallback> &callback, 264 uint64_t &templateId, std::vector<uint8_t> &salt); 265 uint32_t DeleteScheduleId(const uint64_t scheduleId); 266 267 private: 268 struct ScheduleInfo { 269 uint32_t commandId; 270 sptr<IExecutorCallback> callback; 271 uint64_t templateId; 272 std::vector<uint8_t> salt; 273 }; 274 275 std::mutex mutex_; 276 std::map<uint64_t, struct ScheduleInfo> scheduleInfo_; 277 }; 278 279 private: 280 uint32_t NewSalt(std::vector<uint8_t> &salt); 281 void CallError(const sptr<IExecutorCallback> &callbackObj, const uint32_t errorCode); 282 std::shared_ptr<OHOS::UserIAM::PinAuth::PinAuth> pinHdi_; 283 ScheduleMap scheduleMap_; 284 }; 285 286 // 获取执行器列表实现，创建执行器（仅作示例） 287 int32_t PinAuthInterfaceService::GetExecutorList(std::vector<sptr<IExecutor>> &executorList) 288 { 289 IAM_LOGI("start"); 290 std::shared_ptr<OHOS::UserIAM::PinAuth::PinAuth> pinHdi = 291 OHOS::UserIAM::Common::MakeShared<OHOS::UserIAM::PinAuth::PinAuth>(); 292 if (pinHdi == nullptr) { 293 IAM_LOGE("Generate pinHdi failed"); 294 return HDF_FAILURE; 295 } 296 sptr<IExecutor> executor = new (std::nothrow) ExecutorImpl(pinHdi); 297 if (executor == nullptr) { 298 IAM_LOGE("Generate executor failed"); 299 return HDF_FAILURE; 300 } 301 executorList.push_back(executor); 302 IAM_LOGI("end"); 303 return HDF_SUCCESS; 304 } 305 ``` 306 307 308 3091. 完成执行器每个功能接口实现，详细代码参见[executor_impl.cpp](https://gitee.com/openharmony/drivers_peripheral/blob/master/pin_auth/hdi_service/service/src/executor_impl.cpp)文件。 310 311 ```c++ 312 // 实现获取执行器信息接口（仅作示例） 313 int32_t ExecutorImpl::GetExecutorInfo(ExecutorInfo &info) 314 { 315 IAM_LOGI("start"); 316 constexpr unsigned short SENSOR_ID = 1; 317 info.sensorId = SENSOR_ID; 318 info.executorType = EXECUTOR_TYPE; 319 info.executorRole = ExecutorRole::ALL_IN_ONE; 320 info.authType = AuthType::PIN; 321 if (pinHdi_ == nullptr) { 322 IAM_LOGE("pinHdi_ is nullptr"); 323 return HDF_FAILURE; 324 } 325 uint32_t eslRet = 0; 326 int32_t result = pinHdi_->GetExecutorInfo(info.publicKey, eslRet); 327 if (result != SUCCESS) { 328 IAM_LOGE("Get ExecutorInfo failed, fail code : %{public}d", result); 329 return result; 330 } 331 info.esl = static_cast<ExecutorSecureLevel>(eslRet); 332 333 return HDF_SUCCESS; 334 } 335 336 // 实现获取指定templateId的模板信息接口 337 int32_t ExecutorImpl::GetTemplateInfo(uint64_t templateId, TemplateInfo &info) 338 { 339 IAM_LOGI("start"); 340 if (pinHdi_ == nullptr) { 341 IAM_LOGE("pinHdi_ is nullptr"); 342 return HDF_FAILURE; 343 } 344 OHOS::UserIAM::PinAuth::PinCredentialInfo infoRet = {}; 345 int32_t result = pinHdi_->QueryPinInfo(templateId, infoRet); 346 if (result != SUCCESS) { 347 IAM_LOGE("Get TemplateInfo failed, fail code : %{public}d", result); 348 return result; 349 } 350 /* subType is stored in extraInfo */ 351 info.extraInfo.resize(infoRet.subType); 352 if (memcpy_s(&(info.extraInfo[0]), sizeof(infoRet.subType), &(infoRet.subType), sizeof(infoRet.subType)) != EOK) { 353 IAM_LOGE("copy subType to extraInfo fail!"); 354 return HDF_FAILURE; 355 } 356 357 info.executorType = EXECUTOR_TYPE; 358 info.remainAttempts = infoRet.remainTimes; 359 info.lockoutDuration = infoRet.freezingTime; 360 361 return HDF_SUCCESS; 362 } 363 364 // 实现执行器注册成功后，获取用户认证框架的公钥信息、获取用户认证框架的template 列表接口，将公钥信息保存，template列表用于和本地的template做对账 365 int32_t ExecutorImpl::OnRegisterFinish(const std::vector<uint64_t> &templateIdList, 366 const std::vector<uint8_t> &frameworkPublicKey, const std::vector<uint8_t> &extraInfo) 367 { 368 IAM_LOGI("start"); 369 static_cast<void>(frameworkPublicKey); 370 static_cast<void>(extraInfo); 371 if (pinHdi_ == nullptr) { 372 IAM_LOGE("pinHdi_ is nullptr"); 373 return HDF_FAILURE; 374 } 375 int32_t result = pinHdi_->VerifyTemplateData(templateIdList); 376 if (result != SUCCESS) { 377 IAM_LOGE("Verify templateData failed"); 378 return result; 379 } 380 381 return HDF_SUCCESS; 382 } 383 384 // 实现口令录入接口 385 int32_t ExecutorImpl::Enroll(uint64_t scheduleId, const std::vector<uint8_t> &extraInfo, 386 const sptr<IExecutorCallback> &callbackObj) 387 { 388 IAM_LOGI("start"); 389 if (callbackObj == nullptr) { 390 IAM_LOGE("callbackObj is nullptr"); 391 return HDF_FAILURE; 392 } 393 static_cast<void>(extraInfo); 394 std::vector<uint8_t> salt; 395 if (NewSalt(salt) != HDF_SUCCESS) { 396 IAM_LOGE("new salt failed"); 397 CallError(callbackObj, HDF_FAILURE); 398 return HDF_FAILURE; 399 } 400 int32_t result = scheduleMap_.AddScheduleInfo(scheduleId, ENROLL_PIN, callbackObj, 0, salt); 401 if (result != HDF_SUCCESS) { 402 IAM_LOGE("Add scheduleInfo failed, fail code : %{public}d", result); 403 CallError(callbackObj, HDF_FAILURE); 404 return result; 405 } 406 result = callbackObj->OnGetData(scheduleId, salt, 0); 407 if (result != SUCCESS) { 408 IAM_LOGE("Enroll Pin failed, fail code : %{public}d", result); 409 // If the enroll fails, delete scheduleId of scheduleMap 410 if (scheduleMap_.DeleteScheduleId(scheduleId) != HDF_SUCCESS) { 411 IAM_LOGI("delete scheduleId failed"); 412 } 413 return result; 414 } 415 416 return HDF_SUCCESS; 417 } 418 419 // 实现回调数据获取的接口 420 int32_t ExecutorImpl::OnSetData(uint64_t scheduleId, uint64_t authSubType, const std::vector<uint8_t> &data) 421 { 422 IAM_LOGI("start"); 423 if (pinHdi_ == nullptr) { 424 IAM_LOGE("pinHdi_ is nullptr"); 425 return HDF_FAILURE; 426 } 427 std::vector<uint8_t> resultTlv; 428 int32_t result = SUCCESS; 429 constexpr uint32_t INVALID_ID = 2; 430 uint32_t commandId = INVALID_ID; 431 sptr<IExecutorCallback> callback = nullptr; 432 uint64_t templateId = 0; 433 std::vector<uint8_t> salt(0, 0); 434 if (scheduleMap_.GetScheduleInfo(scheduleId, commandId, callback, templateId, salt) != HDF_SUCCESS) { 435 IAM_LOGE("Get ScheduleInfo failed, fail code : %{public}d", result); 436 return HDF_FAILURE; 437 } 438 switch (commandId) { 439 case ENROLL_PIN: 440 result = pinHdi_->EnrollPin(scheduleId, authSubType, salt, data, resultTlv); 441 if (result != SUCCESS) { 442 IAM_LOGE("Enroll Pin failed, fail code : %{public}d", result); 443 } 444 break; 445 case AUTH_PIN: 446 result = pinHdi_->AuthPin(scheduleId, templateId, data, resultTlv); 447 if (result != SUCCESS) { 448 IAM_LOGE("Auth Pin failed, fail code : %{public}d", result); 449 } 450 break; 451 default: 452 IAM_LOGE("Error commandId"); 453 } 454 455 if (callback->OnResult(result, resultTlv) != SUCCESS) { 456 IAM_LOGE("callbackObj Pin failed"); 457 } 458 // Delete scheduleId from the scheduleMap_ when the enroll and authentication are successful 459 if (scheduleMap_.DeleteScheduleId(scheduleId) != HDF_SUCCESS) { 460 IAM_LOGI("delete scheduleId failed"); 461 } 462 463 return HDF_SUCCESS; 464 } 465 // 实现口令认证接口 466 int32_t ExecutorImpl::Authenticate(uint64_t scheduleId, uint64_t templateId, const std::vector<uint8_t> &extraInfo, 467 const sptr<IExecutorCallback> &callbackObj) 468 { 469 IAM_LOGI("start"); 470 if (callbackObj == nullptr) { 471 IAM_LOGE("callbackObj is nullptr"); 472 return HDF_FAILURE; 473 } 474 if (pinHdi_ == nullptr) { 475 IAM_LOGE("pinHdi_ is nullptr"); 476 CallError(callbackObj, HDF_FAILURE); 477 return HDF_FAILURE; 478 } 479 static_cast<void>(extraInfo); 480 std::vector<uint8_t> salt; 481 int32_t result = pinHdi_->GetSalt(templateId, salt); 482 if (result != SUCCESS) { 483 IAM_LOGE("get salt failed, fail code : %{public}d", result); 484 CallError(callbackObj, HDF_FAILURE); 485 return result; 486 } 487 result = scheduleMap_.AddScheduleInfo(scheduleId, AUTH_PIN, callbackObj, templateId, salt); 488 if (result != HDF_SUCCESS) { 489 IAM_LOGE("Add scheduleInfo failed, fail code : %{public}d", result); 490 CallError(callbackObj, HDF_FAILURE); 491 return result; 492 } 493 result = callbackObj->OnGetData(scheduleId, salt, 0); 494 if (result != SUCCESS) { 495 IAM_LOGE("Authenticate Pin failed, fail code : %{public}d", result); 496 // If the authentication fails, delete scheduleId of scheduleMap 497 if (scheduleMap_.DeleteScheduleId(scheduleId) != HDF_SUCCESS) { 498 IAM_LOGI("delete scheduleId failed"); 499 } 500 return result; 501 } 502 503 return HDF_SUCCESS; 504 } 505 506 // 实现删除口令模板接口 507 int32_t ExecutorImpl::Delete(uint64_t templateId) 508 { 509 IAM_LOGI("start"); 510 if (pinHdi_ == nullptr) { 511 IAM_LOGE("pinHdi_ is nullptr"); 512 return HDF_FAILURE; 513 } 514 int32_t result = pinHdi_->DeleteTemplate(templateId); 515 if (result != SUCCESS) { 516 IAM_LOGE("Verify templateData failed, fail code : %{public}d", result); 517 return result; 518 } 519 520 return HDF_SUCCESS; 521 } 522 523 // 实现通过scheduleId取消指定操作接口 524 int32_t ExecutorImpl::Cancel(uint64_t scheduleId) 525 { 526 IAM_LOGI("start"); 527 if (scheduleMap_.DeleteScheduleId(scheduleId) != HDF_SUCCESS) { 528 IAM_LOGE("scheduleId is not found"); 529 return HDF_FAILURE; 530 } 531 return HDF_SUCCESS; 532 } 533 534 // 口令预留接口 535 int32_t ExecutorImpl::SendCommand(int32_t commandId, const std::vector<uint8_t> &extraInfo, 536 const sptr<IExecutorCallback> &callbackObj) 537 { 538 IAM_LOGI("Extension interface, temporarily useless"); 539 static_cast<void>(commandId); 540 static_cast<void>(extraInfo); 541 static_cast<void>(callbackObj); 542 return HDF_SUCCESS; 543 } 544 ``` 545 546 547### 调测验证 548驱动开发完成后，可基于RK3568平台验证, 通过设备的设置和锁屏功能验证口令认证功能是否正常，测试步骤如下： 549 5501. 点击设备的 “ 设置 > 生物识别和密码 > 锁屏密码" 后，录入锁屏密码。 5512. 按设备电源键进行锁屏，再次按设备的电源键进行解锁，输入锁屏密码进行解锁验证，至此就完成了口令的录入和认证功能。 5523. 进入设置中的生物识别和密码，点击关闭锁屏密码或者更改锁屏密码，来验证口令的删除和更新功能是否正常。 5534. 在步骤1完成后，进行步骤2的输入锁屏密码时，输入错误密码达到一定的次数来验证，防暴力破解能力是否正常（例如：连续输入5次错误密码，设备将被冻结60s）。 554