鸿蒙之用户认证（人脸识别以及指纹识别）

用户认证模块的界说

用户认证模块提供用户认证本领，对应用开发者而言，可使用该模块举行用户身份认证，用于设备解锁、支付、应用登录等身份认证场景。
当前用户认证提供人脸识别和指纹识别本领，设备具备哪种识别本领，取决于当前设备的硬件本领和技术实现。
基本概念

• 人脸识别：基于人的脸部特性信息举行身份识别的一种生物特性识别技术，用摄像机或摄像头采集含有人脸的图像或视频流，并主动在图像中检测和跟踪人脸，进而对检测到的人脸举行脸部识别，通常也叫做人像识别、面部识别、人脸认证。
  
• 指纹识别：基于人的指尖皮肤纹路举行身份识别的一种生物特性识别技术。当用户触摸指纹采集器件时，器件感知并获取到用户的指纹图像，然后传输到指纹识别模块举行肯定的处理后与用户预先注册的指纹信息举行比对，从而识别出用户身份。
  

场景先容

当前用户认证支持Pin码认证、人脸识别和指纹识别，可应用于设备解锁、应用登录、支付等身份认证场景。

User Authentication Kit用户认证

1、查询当前设备是否支持相应的认证本领

开发步调

• 申请权限。调用getAvailableStatus接口，需要在module.json5文件的requestPermissions对象中配置ohos.permission.ACCESS_BIOMETRIC权限。更多配置信息请参考Stage模子应用程序包结构。
  
• 指定认证类型和认证等级，调用getAvailableStatus接口查询当前的设备是否支持相应的认证本领。
  

配置权限

module.json5文件中：

1.     "requestPermissions": [
2.       //     User Authentication Kit（用户认证服务）
3.       //      用户认证权限，指纹，密码，面容
4.       {
5.         "name": "ohos.permission.ACCESS_BIOMETRIC"
6.       }
7.     ]

复制代码

调用getAvailableStatus接口

1. getAvailableStatus(authType : UserAuthType, authTrustLevel : AuthTrustLevel) : number

复制代码

参数

实当代码：

1. // 认证类型参数
2. pravite authType: userAuth.UserAuthType[] = [
3.   userAuth.UserAuthType.PIN, // PIN密码（模拟器支持）
4.   userAuth.UserAuthType.FINGERPRINT, // 指纹
5.   userAuth.UserAuthType.FACE// 面容ID
6. ]
7. // 认证信任等级参数
8. pravite authTrustLevel: userAuth.AuthTrustLevel = userAuth.AuthTrustLevel.ATL3

复制代码

1. // 查询认证能力是否支持，同时检测多项能力，有一项支持即可
2. checkUserAuthSupport() {
3.   const authTypeRes = this.authType.map((item) => {
4.     try {// 查询认证能力是否支持,使用 try catch捕获错误
5.       userAuth.getAvailableStatus(item, this.authTrustLevel)
6.       return true
7.     } catch {
8.       return false
9.     }
10.   })
11.   // 有一项支持即可
12.   return authTypeRes.some(v => v === true)//some返回值是布尔值
13. }

复制代码

2、实行认证操纵并订阅认证结果

开发步调

• 申请权限。调用start接口，需要在module.json5文件的requestPermissions对象中配置ohos.permission.ACCESS_BIOMETRIC权限。更多配置信息请参考Stage模子应用程序包结构。
  
• 指定challenge、认证类型和认证等级，获取认证对象。
  
• 调用on接口订阅认证结果。
  
• 调用start接口发起认证，通过callback回调返回认证结果。
  

代码实现

1. // 1配置认证参数
2. const authParam: userAuth.AuthParam = {
3.   challenge: new Uint8Array([49, 49, 49, 49, 49, 49]),// 挑战值，用来防重放攻击。
4.   authType: UserAuthManager.authType,// 认证类型列表
5.   authTrustLevel: UserAuthManager.authTrustLevel// 认证信任等级
6. };

复制代码

1. // 2配置认证界面参数
2. const widgetParam: userAuth.WidgetParam = {
3.   title: '请进行身份认证', //认证时提示的标题内容
4. };

复制代码

1. // 3获取认证对象实例
2. let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam);
4. // 4订阅认证结果
5. userAuthInstance.on('result', {
6.   onResult(result) {
7.     console.log('result---实例结果是' + JSON.stringify(result));
8.     // 最终认证的结果
9.     if (result.result === 12500000) {
10.       resolve(true)
11.     } else {
12.       resolve(false)
13.     }
14.     // 5取消订阅认证结果
15.     userAuthInstance.off('result');
16.   }
17. });
19. // 6开始启动订阅认证
20. userAuthInstance.start();

复制代码

封装用户认证管理类

重要界说了两个方法：
1、检测当前设备是否支持相应的本领：checkUserAuthSupport()
注意：如果检测结果为不支持需要引导用户去设置页开启相关指纹/面容验证
2、开启订阅认证：StartUserAuth()
详细在ArkTs文件实现：

2. import { userAuth } from '@kit.UserAuthenticationKit'//用户认证能力
3. import { promptAction } from '@kit.ArkUI'//弹窗
4. import { BusinessError } from '@kit.BasicServicesKit'//错误类型
6. // User Authentication Kit用户认证
7. // 场景介绍：当前用户认证支持人脸识别和指纹识别，可应用于设备解锁、应用登录、支付等身份认证场景。
10. //用户认证管理封装类
11. export class UserAuthManager {
12.   // 认证类型列表
13.   static authType: userAuth.UserAuthType[] = [
14.     userAuth.UserAuthType.PIN, // PIN密码（模拟器支持）
15.     userAuth.UserAuthType.FINGERPRINT, // 指纹
16.     userAuth.UserAuthType.FACE// 面容ID
17.   ]
18.   // 认证信任等级
19.   static authTrustLevel: userAuth.AuthTrustLevel = userAuth.AuthTrustLevel.ATL3
21.   // 查询认证能力是否支持，同时检测多项能力，有一项支持即可
22.   static checkUserAuthSupport() {
23.     const authTypeRes = UserAuthManager.authType.map((item) => {
24.       try {
25.         // 查询认证能力是否支持,注意这里需要用 try catch
26.         userAuth.getAvailableStatus(item, UserAuthManager.authTrustLevel)
27.         return true
28.       } catch {
29.         return false
30.       }
31.     })
32.     // 有一项支持即可
33.     return authTypeRes.some(v => v === true)//some返回值是布尔值
34.   }
36.   //进行用户认证订阅
37.   static StartUserAuth(): Promise<boolean> {
38.     return new Promise((resolve) => {
39.       // 设置认证参数
40.       const authParam: userAuth.AuthParam = {
41.         challenge: new Uint8Array([49, 49, 49, 49, 49, 49]),// 挑战值，用来防重放攻击。
42.         authType: UserAuthManager.authType,// 认证类型列表
43.         authTrustLevel: UserAuthManager.authTrustLevel// 认证信任等级
44.       };
46.       // 配置认证界面
47.       const widgetParam: userAuth.WidgetParam = {
48.         title: '请进行身份认证', //认证时提示的标题内容
49.       };
51.       try {
52.         // 获取认证对象实例
53.         let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam);
54.         console.log('1result---获取用户认证实例成功，开启userAuthInstance.on事件订阅认证结果');
55.         // 订阅认证结果
56.         userAuthInstance.on('result', {
57.           onResult(result) {
58.             console.log('3result---实例结果是' + JSON.stringify(result));
59.             // 最终认证的结果
60.             if (result.result === 12500000) {
61.               resolve(true)
62.             } else {
63.               resolve(false)
64.             }
65.             // 取消订阅认证结果
66.             userAuthInstance.off('result');
67.           }
68.         });
69.         console.log('2result---调用userAuthInstance.start开启订阅认证');
70.         // 启动订阅认证
71.         userAuthInstance.start();
72.       } catch (error) {
73.         const err: BusinessError = error as BusinessError;
74.         promptAction.showToast({ message: '验证出错' + err.message })
75.       }
76.     })
77.   }
78. }

复制代码

官网地址参考

用户认证开发指导-用户认证-安全-开发 | 华为开发者同盟 (huawei.com)

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V1/userauth-guidelines-0000001630425273-V1


免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。