华为HarmonyOS帮助应用实现在线认证服务 -- 2 FIDO免密身份认证

场景介绍

  • 开通FIDO免密身份认证功能,使用用户已有的生物特征开通FIDO免密身份认证能力。
  • 使用FIDO免密身份认证功能,使用用户已开通的生物特征进行FIDO免密身份认证。
  • 关闭FIDO免密身份认证功能,使用用户已开通的生物特征注销FIDO免密身份认证能力。

基本概念

在开发FIDO免密身份认证功能前,开发者应了解以下基本概念:

  • FIDO协议 FIDO(Fast Identity Online)是一套身份认证框架协议,它由FIDO联盟推出并持续维护。FIDO规范定义了一套在线身份认证的技术架构。

  • UAF身份认证框架 UAF(Universal Authentication Framework)意为通用身份认证框架,目的是通过生物识别(如指纹识别)和加密技术方式,为用户提供无密码的身份认证体验。

约束与限制

需满足以下条件,才能使用该功能。

  • 移动端设备需要支持生物特征(指纹/3D人脸)。
  • FIDO服务需要联网,以便提供完整的在线身份校验服务。应用在调用本服务API前,需将FIDO服务联网行为向用户明示,并且取得用户同意。

接口说明

业务进行FIDO免密身份认证功能的开通、使用和关闭。

接口名 描述
discover(context: common.Context): Promise<DiscoveryData> 发现设备的认证能力,返回当前设备软件支持的认证器数据
checkPolicy(context: common.Context, uafRequest: UAFMessage): Promise<void> 检测用户策略的开启状态
processUAFOperation(context: common.Context, uafRequest: UAFMessage, channelBindings?: ChannelBinding): Promise<UAFMessage> 用户UAF操作接口,处理UAF协议消息
notifyUAFResult(context: common.Context, uafResponse: UAFMessage): Promise<void> 开通结果通知接口
[表1FIDO免密身份认证接口功能介绍]

开发步骤

  1. 需要业务方自行根据FIDO标准协议部署FIDO服务器。

  2. 导入相关模块。

    复制代码
    1. import { fido } from '@kit.OnlineAuthenticationKit';
    2. import { BusinessError } from '@ohos.base';
  3. 开通FIDO免密身份认证。

    1. 初始化认证器信息。

      复制代码
      1. // 使用this.uiContext需要获取页面UIAbility的Context,一个页面获取一次即可
      2. **//**方法:uiContext:common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
      3. try {
      4. // 调用discover方法初始化认证器信息
      5. let discoverData = await fido.discover(this.uiContext);
      6. } catch (error) {
      7. const err: BusinessError = error as BusinessError;
      8. console.error(`Failed to call discover. Code is ${err.code}, message is ${err.message}`);
      9. // 业务根据错误码判断异常类型,进行相应处理
      10. }
    2. 访问FIDO服务端,获取策略检查报文,检查用户开通状态。

      复制代码
      1. // uafMessage为FIDO服务端获取的策略检查报文
      2. let uafAuthMessage: fido.UAFMessage = {
      3. uafProtocolMessage: uafMessage, // 从服务端获取的检查策略报文
      4. additionalData: "" // 附加信息(可选)
      5. };
      6. let isRegistered: boolean = true;
      7. try {
      8. // 检查是否已经开启FIDO认证
      9. await fido.checkPolicy(this.uiContext, uafAuthMessage);
      10. } catch (error) {
      11. isRegistered = false;
      12. const err: BusinessError = error as BusinessError;
      13. console.error(`Failed to call checkPolicy. Code is ${err.code}, message is ${err.message}`);
      14. // 业务根据错误码判断状态,进行相应处理
      15. }
      16. if (isRegistered) {
      17. console.info("has registered, no need to register again.");
      18. // 已注册,业务根据需要执行后续流程
      19. }
    3. 访问FIDO服务端,获取注册报文,调用processUAFOperation接口进行FIDO注册。

      复制代码
      1. // regMessage为从FIDO服务端获取的注册报文
      2. let uafRegMessage: fido.UAFMessage = {
      3. uafProtocolMessage: regMessage, // 从服务端获取的注册报文
      4. additionalData: "" // 附加信息(可选)
      5. };
      6. // 传连接通道参数(可选)
      7. let channelBinding: fido.ChannelBinding = {};
      8. try {
      9. // 调用processUAFOperation接口进行FIDO注册
      10. let messageResp = await fido.processUAFOperation(this.uiContext, uafRegMessage, channelBinding);
      11. } catch (error) {
      12. const err: BusinessError = error as BusinessError;
      13. console.error(`Failed to call processUAFOperation. Code is ${err.code}, message is ${err.message}`);
      14. // 业务根据错误码判断异常类型,进行相应处理
      15. }
    4. 发送注册响应报文至FIDO服务端进行验证并获取注册结果报文。

      复制代码
      1. // notifyMessage为从FIDO服务端获取的注册结果报文
      2. let notifyMessage:string = "";
      3. let notifyUafMessage: fido.UAFMessage = {
      4. uafProtocolMessage: notifyMessage, // 从服务端获取的注册结果报文
      5. additionalData: "" // 附加信息(可选)
      6. };
    5. 调用notifyUAFResult进行注册结果通知。

      复制代码
      1. try {
      2. // 调用notifyUAFResult进行注册结果通知
      3. fido.notifyUAFResult(this.uiContext, notifyUafMessage).then(notify => {
      4. console.info("Succeeded in doing notifyUAFResult.");
      5. })
      6. } catch (error) {
      7. const err: BusinessError = error as BusinessError;
      8. console.error(`Failed to call notifyUAFResult. Code is ${err.code}, message is ${err.message}`);
      9. // 业务根据错误码判断异常类型,进行相应处理
      10. }
  4. 使用FIDO免密身份认证。

    1. 初始化认证器信息(如果已执行过初始化操作,则无需重复执行)。

      复制代码
      1. // 获取当前界面的context
      2. try {
      3. // 调用discover方法初始化认证器信息
      4. let discoverData = await fido.discover(this.uiContext);
      5. } catch (error) {
      6. const err: BusinessError = error as BusinessError;
      7. console.error(`Failed to call discover. Code is ${err.code}, message is ${err.message}`);
      8. // 业务根据错误码判断异常类型,进行相应处理
      9. }
    2. 访问FIDO服务端,获取策略检查报文,检查用户开启状态。

      复制代码
      1. // uafMessage为从FIDO服务器获取的策略检查报文
      2. let uafAuthMessage: fido.UAFMessage = {
      3. uafProtocolMessage: uafMessage, // 从服务端获取的检查策略报文
      4. additionalData: "" // 附加信息(可选)
      5. };
      6. let isRegistered: boolean = true;
      7. try {
      8. // 检查是否已经开启FIDO认证
      9. await fido.checkPolicy(this.uiContext, uafAuthMessage);
      10. } catch (error) {
      11. isRegistered = false;
      12. const err: BusinessError = error as BusinessError;
      13. console.error(`Failed to call checkPolicy. Code is ${err.code}, message is ${err.message}`);
      14. // 业务根据错误码判断状态,进行相应处理
      15. }
      16. if (isRegistered) {
      17. console.info("has registered, no need to register again.");
      18. // 已注册,业务根据需要执行后续流程
      19. }
    3. 访问FIDO服务端,获取认证报文,调用processUAFOperation接口进行FIDO认证。

      复制代码
      1. // regMessage为从FIDO服务器获取的认证报文
      2. let uafRegMessage: fido.UAFMessage = {
      3. uafProtocolMessage: regMessage, // 从服务端获取的认证报文
      4. additionalData: "" // 附加信息(可选)
      5. };
      6. // 传连接通道参数(可选)
      7. let channelBinding: fido.ChannelBinding = {};
      8. try {
      9. // 调用processUAFOperation接口进行FIDO认证
      10. let messageResp = await fido.processUAFOperation(this.uiContext, uafRegMessage, channelBinding);
      11. } catch (error) {
      12. const err: BusinessError = error as BusinessError;
      13. console.error(`Failed to call processUAFOperation. Code is ${err.code}, message is ${err.message}`);
      14. // 业务根据错误码判断异常类型,进行相应处理
      15. }
      16. //发送认证响应报文至FIDO服务端进行验证并返回认证结果
  5. 关闭FIDO免密身份认证。

    1. 初始化认证器信息(如果已执行过初始化操作,则无需重复执行)。

      复制代码
      1. try {
      2. // 调用discover方法初始化认证器信息
      3. let discoverData = await fido.discover(this.uiContext);
      4. } catch (error) {
      5. const err: BusinessError = error as BusinessError;
      6. console.error(`Failed to call discover. Code is ${err.code}, message is ${err.message}`);
      7. // 业务根据错误码判断异常类型,进行相应处理
      8. }
    2. 访问FIDO服务端,获取注销报文,调用processUAFOperation接口进行FIDO注销。

      复制代码
      1. // deregMessage为从FIDO服务器获取的注销报文
      2. let uafRegMessage: fido.UAFMessage = {
      3. uafProtocolMessage: deregMessage, // 从服务端获取的注销报文
      4. additionalData: "" // 附加信息(可选)
      5. };
      6. // 传连接通道参数(可选)
      7. let channelBinding: fido.ChannelBinding = {};
      8. try {
      9. // 调用processUAFOperation接口进行FIDO注销
      10. let messageResp = await fido.processUAFOperation(this.uiContext, uafRegMessage, channelBinding);
      11. } catch (error) {
      12. const err: BusinessError = error as BusinessError;
      13. console.error(`Failed to call processUAFOperation. Code is ${err.code}, message is ${err.message}`);
      14. // 业务根据错误码判断异常类型,进行相应处理
      15. }
      16. //发送认证响应报文至FIDO服务端进行验证并返回认证结果
相关推荐
SoraLuna5 小时前
「Mac畅玩鸿蒙与硬件46」UI互动应用篇23 - 自定义天气预报组件
开发语言·算法·macos·ui·华为·harmonyos
SuperHeroWu75 小时前
【HarmonyOS】HarmonyOS 和 Flutter混合开发 (一)之鸿蒙Flutter环境安装
flutter·华为·jdk·harmonyos·鸿蒙·环境安装·混合开发
特立独行的猫a5 小时前
HarmonyOS ArkTS中视频播放Video组件实现竖屏到横屏切换
华为·音视频·harmonyos
Swift社区6 小时前
HarmonyOS 实时监听与获取 Wi-Fi 信息
harmonyos
GY-937 小时前
Harmonyos多线程之Worker基本使用
harmonyos
Freerain997 小时前
鸿蒙Next页面和自定义组件生命周期
华为·harmonyos
枫叶丹49 小时前
【HarmonyOS之旅】HarmonyOS开发基础知识(一)
华为od·华为·华为云·harmonyos
阿落ovo17 小时前
访问控制列表ACL
java·运维·服务器·网络·数据库·华为·智能路由器
阿落ovo19 小时前
华为ensp--BGP自动路由聚合
服务器·网络·华为