介绍

本示例展示了IFAA免密身份认证接口的使用方法，IIFAA协议具体功能请参考IIFAA本地免密技术规范

通过从 @kit.OnlineAuthenticationKit 导入IFAA API接口，可实现基于IIFAA协议提供的端侧免密开通，认证和注销功能。

效果预览

工程目录

├── entry/src/main/ets               // 代码区
│    ├── entryability
│    │    └── EntryAbility.ets       // 程序入口类
│    ├── model
│    │    └── IfaaModel.ts           // 开通、认证、关闭功能实现
│    └── pages
│         └── Index.ets              // 主页面入口

使用说明

1. 使用指纹/3D人脸进行免密身份认证，移动端设备需要录入对应的生物特征信息。

2. 在设备录入指纹/3D人脸后，点击开启按钮，页面弹出弹窗进行认证，提示开启成功。

3. 点击认证按钮，可使用生物特征（人脸/指纹）进行IFAA免密身份认证。

4. 点击关闭按钮，关闭IFAA生物特征（人脸/指纹）免密身份认证。

具体实现

以IFAA认证功能为例，业务使用时，需要先进行import导入如下IFAA API:

import { ifaa } from '@kit.OnlineAuthenticationKit'

• function preAuth():Promise;

• function auth(authToken: Uint8Array, authData: Uint8Array):Promise;

业务使用时，首先需要在设备中存入指纹或3D人脸；首先通过调用preAuth()接口获取本次验证临时challenge参数，该数值需与生物认证所用challenge保持一致，IFAA服务会进行时效校验，获取参数后长时间未使用会导致验证失败； 通过调用User Authentication Kit成功获取指纹/人脸信息后，使用auth()接口进行身份认证，认证成功返回签名报文，失败会抛出异常。 具体用例请参考Index.ets

相关权限

1. 获取生物识别权限：ohos.permission.ACCESS_BIOMETRIC。

依赖

UserAuthenticationKit

更多详情参考：示例代码