harmony 鸿蒙用户认证错误码
用户认证错误码
说明：
以下仅介绍本模块特有错误码，通用错误码请参考通用错误码说明文档。
12500001 认证失败
错误信息
Authentication failed.
可能原因
当前凭据与设备里已经录入的凭据比对失败。
处理步骤
重新发起认证。
12500002 一般的操作错误
错误信息
General operation error.
可能原因
- NAPI层解析参数出错。
- 用户认证服务的进程没有启动。
- IPC通信的proxy客户端写数据出错。
- IPC通信的stub服务端解析数据出错。
- 获取driver服务出错。
处理步骤
系统服务内部工作异常，请稍后重新调用接口，或者重启设备尝试。
12500003 认证被取消
错误信息
Authentication canceled.
可能原因
当前的认证操作已经被取消。
处理步骤
重新调用认证接口，发起认证。
12500004 认证操作超时
错误信息
Authentication timeout.
可能原因
当前的认证操作超过了设定的时限。
处理步骤
重新调用认证接口，发起认证。
12500005 认证类型不支持
错误信息
The authentication type is not supported.
可能原因
- 传入的认证类型参数不支持，例如调用userAuth模块的getAvailableStatus接口时传入的参数不是FACE或FINGERPRINT类型，则会返回12500005错误码。
- 传入的认证类型参数在本设备上不支持，例如在没有部署指纹传感器的设备上发起指纹认证，则会返回12500005错误码。
处理步骤
请检查传入的认证类型参数，重新调用接口。
12500006 认证信任等级不支持
错误信息
The authentication trust level is not supported.
可能原因
- 调用userAuth模块的getAvailableStatus或getAuthInstance接口时，传入的authTrustLevel参数不在[ATL1, ATL2, ATL3, ATL4]范围内。
- 当前的设备不支持该认证信任等级，例如在只部署了2D摄像头的设备上发起支付级别的人脸认证，则会返回12500006错误码。
处理步骤
检查传入的authTrustLevel是否在合理范围，如果在合理范围，则是当前的设备不支持该认证信任等级。
12500007 认证服务已经繁忙
错误信息
Authentication service is busy.
可能原因
当前已经存在某个尚未结束的认证，又发起了一次认证。
处理步骤
稍后重新发起认证。
12500009 认证被锁定
错误信息
Authentication is locked out.
可能原因
当前认证失败的次数超过了上限，触发防爆模式，认证被锁定。
处理步骤
稍后重新发起一次成功的认证。
12500010 该类型的凭据没有录入
错误信息
The type of credential has not been enrolled.
可能原因
例如调用userAuth模块的getAvailableStatus接口，传入的authType参数为FACE，但是当前的设备没有录入人脸凭据，则会返回12500010错误码。调用start接口发起人脸认证，但是目前的设备没有录入人脸凭据，则会返回12500010错误码。
处理步骤
检查是否录入该类型的凭据，如果没有录入，则需要成功录入该类型凭据后再调用相关接口。
12500011 提示/通知切换自定义认证
错误信息
Switched to the custom authentication process.
可能原因
当前的认证操作被用户从控件取消，返回这个错误码，标识使用应用自定义认证。例如用户点击使用自定义认证，返回到应用自定义认证流程。
处理步骤
重新调用认证接口，发起认证。
12500013 密码过期
错误信息
Operation failed because of PIN expired.
可能原因
由于系统锁屏口令过期，认证操作执行失败。当用户发起口令、指纹或者人脸认证，但是系统锁屏口令过期时，将会返回12500013错误码。
处理步骤
用户前往设置更新系统锁屏口令，再次发起认证。
12500015 AuthToken完整性校验失败
错误信息
Operation failed because of authToken integrity check failed.
可能原因
当验证的AuthToken无效时，会返回12500015错误码。
处理步骤
重新发起认证，签发有效token。
12500016 AuthToken过期
错误信息
Operation failed because of authToken has expired.
可能原因
当AuthToken的签发时间至发起验证时的时间间隔超过传入的最大有效时长时，会返回12500016错误码。
处理步骤
重新发起认证，签发有效token。
12700001 人脸服务不可用
错误信息
The service is unavailable.
可能原因
- 例如调用faceAuth模块的setSurfaceId接口时，人脸认证服务未启动，则会返回12700001错误码。
- IPC通信的proxy客户端写数据出错。
- IPC通信的stub服务端解析数据出错。
- 人脸driver层调用出错。
处理步骤
系统服务内部工作异常，请稍后重新调用接口，或者重启设备尝试。
你可能感兴趣的鸿蒙文章
harmony 鸿蒙User Authentication Kit（用户认证服务）
harmony 鸿蒙@ohos.userIAM.faceAuth (人脸认证)(系统接口)
harmony 鸿蒙@ohos.userIAM.userAccessCtrl (用户访问控制)(系统接口)
harmony 鸿蒙@ohos.userIAM.userAuth (用户认证)(系统接口)
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦