1# 用户认证错误码 2 3<!--Kit: User Authentication Kit--> 4<!--Subsystem: UserIAM--> 5<!--Owner: @WALL_EYE--> 6<!--Designer: @lichangting518--> 7<!--Tester: @jane_lz--> 8<!--Adviser: @zengyawen--> 9 10> **说明：** 11> 12> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 13 14## 12500001 认证失败 15 16**错误信息** 17 18Authentication failed. 19 20**可能原因** 21 22当前凭据与设备里已经录入的凭据比对失败。 23 24**处理步骤** 25 26重新发起认证。 27 28## 12500002 一般的操作错误 29 30**错误信息** 31 32General operation error. 33 34**可能原因** 35 361. NAPI层解析参数出错。 372. 用户认证服务的进程没有启动。 383. IPC通信的proxy客户端写数据出错。 394. IPC通信的stub服务端解析数据出错。 405. 获取driver服务出错。 41 42**处理步骤** 43 44系统服务内部工作异常，请稍后重新调用接口，或者重启设备尝试。 45 46## 12500003 认证被取消 47 48**错误信息** 49 50Authentication canceled. 51 52**可能原因** 53 54当前的认证操作已经被取消。 55 56**处理步骤** 57 58重新调用认证接口，发起认证。 59 60## 12500004 认证操作超时 61 62**错误信息** 63 64Authentication timeout. 65 66**可能原因** 67 68当前的认证操作超过了设定的时限。 69 70**处理步骤** 71 72重新调用认证接口，发起认证。 73 74## 12500005 认证类型不支持 75 76**错误信息** 77 78The authentication type is not supported. 79 80**可能原因** 81 821. 传入的认证类型参数不支持，例如调用userAuth模块的getAvailableStatus接口时传入的参数不是FACE或FINGERPRINT类型，则会返回12500005错误码。 832. 传入的认证类型参数在本设备上不支持，例如在没有部署指纹传感器的设备上发起指纹认证，则会返回12500005错误码。 84 85**处理步骤** 86 87请检查传入的认证类型参数，重新调用接口。 88 89## 12500006 认证信任等级不支持 90 91**错误信息** 92 93The authentication trust level is not supported. 94 95**可能原因** 96 971. 调用userAuth模块的getAvailableStatus或getAuthInstance接口时，传入的authTrustLevel参数不在[ATL1, ATL2, ATL3, ATL4]范围内。 982. 当前的设备不支持该认证信任等级，例如在只部署了2D摄像头的设备上发起支付级别的人脸认证，则会返回12500006错误码。 99 100**处理步骤** 101 102检查传入的authTrustLevel是否在合理范围，如果在合理范围，则是当前的设备不支持该认证信任等级。 103 104## 12500007 认证服务已经繁忙 105 106**错误信息** 107 108Authentication service is busy. 109 110**可能原因** 111 112当前已经存在某个尚未结束的认证，又发起了一次认证。 113 114**处理步骤** 115 116稍后重新发起认证。 117 118## 12500008 参数校验失败 119 120**错误信息** 121 122The parameter is out of range. 123 124**错误描述** 125 126参数校验不通过。 127 128**可能原因** 129 130参数错误。 131 132**处理步骤** 133 134检查接口参数重新发起请求。 135 136## 12500009 认证被锁定 137 138**错误信息** 139 140Authentication is locked out. 141 142**可能原因** 143 144当前认证失败的次数超过了上限，触发防爆模式，认证被锁定。 145 146**处理步骤** 147 148稍后重新发起一次成功的认证。 149 150## 12500010 该类型的凭据没有录入 151 152**错误信息** 153 154The type of credential has not been enrolled. 155 156**可能原因** 157 158例如调用userAuth模块的getAvailableStatus接口，传入的authType参数为FACE，但是当前的设备没有录入人脸凭据，则会返回12500010错误码。调用start接口发起人脸认证，但是目前的设备没有录入人脸凭据，则会返回12500010错误码。 159 160**处理步骤** 161 162检查是否录入该类型的凭据，如果没有录入，则需要成功录入该类型凭据后再调用相关接口。 163 164## 12500011 提示/通知切换自定义认证 165 166**错误信息** 167 168Switched to the custom authentication process. 169 170**可能原因** 171 172当前的认证操作被用户从控件取消，返回这个错误码，标识使用应用自定义认证。例如用户点击使用自定义认证，返回到应用自定义认证流程。 173 174**处理步骤** 175 176重新调用认证接口，发起认证。 177 178## 12500013 密码过期 179 180**错误信息** 181 182Operation failed because of PIN expired. 183 184**可能原因** 185 186由于系统锁屏口令过期，认证操作执行失败。当用户发起口令、指纹或者人脸认证，但是系统锁屏口令过期时，将会返回12500013错误码。 187 188**处理步骤** 189 190用户前往设置更新系统锁屏口令，再次发起认证。 191 192<!--Del--> 193## 12500015 AuthToken完整性校验失败 194 195**错误信息** 196 197Operation failed because of authToken integrity check failed. 198 199**可能原因** 200 201当验证的AuthToken无效时，会返回12500015错误码。 202 203**处理步骤** 204 205重新发起认证，签发有效token。 206 207## 12500016 AuthToken过期 208 209**错误信息** 210 211Operation failed because of authToken has expired. 212 213**可能原因** 214 215当AuthToken的签发时间至发起验证时的时间间隔超过传入的最大有效时长时，会返回12500016错误码。 216 217**处理步骤** 218 219重新发起认证，签发有效token。 220 221## 12500017 复用身份认证结果失败 222 223**错误信息** 224 225Failed to reuse authtication result. 226 227**错误描述** 228 229复用身份认证结果失败。 230 231**可能原因** 232 2331. 认证类型与指定的类型不匹配。 2342. 认证结果超过了可复用时长（可复用时长最长为5分钟）。 235 236**处理步骤** 237 238发起认证请求，用户手动认证通过后获取有效的authToken。 239 240## 12700001 人脸服务不可用 241 242**错误信息** 243 244The service is unavailable. 245 246**可能原因** 247 2481. 例如调用faceAuth模块的setSurfaceId接口时，人脸认证服务未启动，则会返回12700001错误码。 2492. IPC通信的proxy客户端写数据出错。 2503. IPC通信的stub服务端解析数据出错。 2514. 人脸driver层调用出错。 252 253**处理步骤** 254 255系统服务内部工作异常，请稍后重新调用接口，或者重启设备尝试。 256<!--DelEnd--> 257