关闭指定生物类型认证能力
============

#### 场景介绍

当用户期望关闭指定生物特征认证能力时，可以通过指定已开通的生物特征信息，关闭指定的生物类型认证能力。

#### 约束与限制

1.  本功能在API 24之前版本仅支持Phone；API24及之后版本，新增支持具备TUI能力的PC/2in1、具备TUI能力的Tablet。可通过接口[checkConfirmUITextFormat](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-trusted-auth-api#checkconfirmuitextformat)查询设备是否具备TUI能力。不支持的设备在调用数字盾服务相关业务接口时，返回错误码1019100016。
2.  本功能需企业开发者应用服务器端完成接口接入，以配合端云协同认证流程。

#### 业务流程

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/55/v3/v0Eaovy-Ri2n9SMa9d46Aw/zh-cn_image_0000002664328271.jpg?HW-CC-KV=V1&HW-CC-Date=20260709T132415Z&HW-CC-Expire=86400&HW-CC-Sign=F1E7D108F926B749B664E274C71470E1B02E8D2604014E50039CB7A956FAA4D3)

#### 接口说明

接口及使用方法请参见[API参考](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-devicesecurity-trusted-auth)。

| 接口名 | 描述 |
| :-- | :-- |
| [disableTrustedBioAuthentication](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-trusted-auth-api#disabletrustedbioauthentication)(authID: bigint, authType: [AuthType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-trusted-auth-api#authtype)): Promise<void> | 解绑指定生物类型认证能力 |

#### 开发步骤

1.  导入trustedAuthentication 和相关依赖模块。
    
    import { trustedAuthentication} from '@kit.DeviceSecurityKit';
    import { BusinessError} from '@kit.BasicServicesKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    
2.  首先开发者需要在服务器查询对应账户是否已开通对应生物特征认证能力，在确认开通后方可发起解绑指定生物类型认证能力请求。
    
3.  发起关闭指定生物类型认证能力请求前，需从服务器获取当前账号在[设置数字盾密码](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/devicesecurity-trustedauth-setpwd)时获取的authID。
    
4.  调用数字盾解绑指定生物类型认证能力接口发起关闭对应生物类型认证能力申请。
    
    const TAG = "TrustedAuthenticationJsTest";
    try {
     const authID: bigint = 1687413472599354502n; // 实际填充为从服务器获取到的账号对应的authID值
     const authType = trustedAuthentication.AuthType.AUTH\_TYPE\_FACE; // 实际填充为计划解绑的生物特征类型
     const remainTimes = await trustedAuthentication.disableTrustedBioAuthentication(authID, authType);
    } catch (err) {
      let e: BusinessError = err as BusinessError;
      hilog.error(0x0000, TAG, 'disableTrustedBioAuthentication: %{public}d %{public}s', e.code, e.message);
    }
    
5.  在接收到端侧解绑成功结果后，开发者需要同步将服务器绑定的生物特征信息解绑。