1# HUKS错误码 2 3<!--Kit: Universal Keystore Kit--> 4<!--Subsystem: Security--> 5<!--Owner: @wutiantian-gitee--> 6<!--Designer: @HighLowWorld--> 7<!--Tester: @wxy1234564846--> 8<!--Adviser: @zengyawen--> 9 10> **说明：** 11> 12> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 13 14## 12000001 该子功能不支持（特性） 15 16**错误信息** 17 18The ``${messageInfo}`` is not supported. 19 20**可能原因** 21 22支持API，但是不支持API内部某些子特性（功能），如算法参数。 23 24**处理步骤** 25 26调整API参数，使用可替代可支持的参数。 27 28## 12000002 缺少密钥算法参数 29**错误信息** 30 31Failed to obtain the ``${messageInfo}``. It is not set in ParamSet. 32 33**可能原因** 34 35使用密钥时缺少相关参数。 36 37**处理步骤** 38 391. 查看errorMessage确认缺少的密钥参数。 402. 添加对应的正确的密钥参数。 41 42## 12000003 无效的密钥算法参数 43 44**错误信息** 45 46Invalid ``${messageInfo}``. 47 48**可能原因** 49 50使用密钥时无效相关参数。 51 52**处理步骤** 53 541. 查看errorMessage确认无效的密钥参数名。 552. 修改对应的密钥参数。 56 57## 12000004 文件错误 58 59**错误信息** 60 61可能为以下的其中一种： 62 63- Insufficient storage space. 64- Invalid file size. 65- Failed to ``${messageInfo}``. 66 67 68**可能原因** 69 70文件操作错误。 71 72**处理步骤** 73 741. 查看是否磁盘空间已经写满、文件系统是否有其他异常。 752. 清理磁盘。 76 77## 12000005 进程通信错误 78 79**错误信息** 80 81可能为以下的其中一种： 82 83- Failed to get messages from IPC. 84- IPC ``${messageInfo}``. 85 86**可能原因** 87 88进程通信错误。 89 90**处理步骤** 91 92查看错误信息，排查是否进程IPC通信问题。 93 94## 12000006 算法库操作失败 95 96**错误信息** 97 98Crypto engine error. 99 100**可能原因** 101 102该错误码表示算法库操作失败，可能原因如下。 103 1041. 算法库加解密错误，可能是密文数据不对。 1052. 密钥参数不正确。 106 107**处理步骤** 108 1091. 排查密文数据是否正确。 1102. 排查加解密参数是否正确。 111 112## 12000007 密钥访问失败 - 密钥已失效 113 114**错误信息** 115 116This credential is invalidated permanently. 117 118**可能原因** 119 120该错误码表示密钥访问失败 - 密钥已失效，可能原因如下。 121 1221. 该密钥设置了清除密码失效的用户认证访问控制属性，清除过设备密钥导致密钥失效。 1232. 该密钥设置了新录入生物特征失效的用户认证访问控制属性，由于录入过新的指纹或人脸导致该密钥失败。 124 125**处理步骤** 126 1271. 确认日志是哪种方式导致的认证不通过。 1282. 如果使用了正确参数，但是失效控制导致认证不通过，则该密钥已经无法使用。 129 130## 12000008 密钥访问失败 - 密钥认证失败 131 132**错误信息** 133 134The authentication token verification failed. 135 136**可能原因** 137 138该密钥设置了用户认证访问控制属性，由于challenge参数不正确导致无法通过认证。 139 140**处理步骤** 141 1421. 检查userIAM认证的challenge参数组装是否正确。 1432. 如果是challenge参数不正确导致，则修改正确的组装方式，使用huks生成challenge组装，并传入userIAM重新认证。 144 145## 12000009 密钥访问失败 - 密钥访问超时 146 147**错误信息** 148 149This authentication token timed out. 150 151**可能原因** 152 153该密钥设置了用户认证访问控制属性，由于使用时间窗timeout导致无法通过认证。 154 155**处理步骤** 156 157如果是timeout导致不正确，则重新触发密钥init并重新认证，使得认证时间和密钥init时间小于设置的timeout时间。 158 159## 12000010 密钥操作会话数已达上限 160 161**错误信息** 162 163The number of key operation sessions has reached the limit. 164 165**可能原因** 166 167同时使用huks进行密钥会话操作的调用方（同应用或者跨应用）过多，已经达到上限（15个）。 168 169**处理步骤** 170 1711. 检查同应用内部是否同时存在多个密钥会话操作（init)，存在则修改避免同时调用。 1722. 如不存在上述情形，则可能是其它应用同时调用多个会话，通过等待其它应用释放会话后再使用。 173 174## 12000011 目标对象不存在 175 176**错误信息** 177 178The entity does not exist. 179 180**可能原因** 181 182该别名对应的密钥不存在。 183 184**处理步骤** 185 1861. 检查密钥别名是否拼写错误。 1872. 检查改密钥别名对应的密钥是否生成成功。 188 189## 12000012 外部错误 190 191**错误信息** 192 193Device environment or input parameter abnormal. 194 195**可能原因** 196 197外部的硬件出错，文件错误等。 198 199**处理步骤** 200 201拿错误码与日志在社区反馈。 202 203## 12000013 密钥设置生物访问控制时，待绑定的凭据不存在 204 205**错误信息** 206 207The credential does not exist. 208 209**可能原因** 210 211密钥绑定PIN、指纹、人脸时，未录入相关凭据。 212 213**处理步骤** 214 215录入相关凭据，或更改绑定凭据类型。 216 217## 12000014 内存不足 218 219**错误信息** 220 221可能为以下的其中一种： 222 223- Insufficient memory. 224- Malloc failed. 225 226**可能原因** 227 228系统内存不足，或出参缓存太小。 229 230**处理步骤** 231 2321. 开发者释放部分内存或重启。 2332. 检查传入的出参缓存大小。 234 235## 12000015 调用其他系统服务失败 236 237**错误信息** 238 239Failed to obtain the ``${messageInfo}`` information via UserIAM. 240 241**可能原因** 242 243其他系统服务未启动。 244 245**处理步骤** 246 247开发者等待一段时间后尝试再次触发调用。 248 249## 12000017 同名密钥已存在 250 251**错误信息** 252 253The key with same alias is already exist. 254 255**可能原因** 256 257指定了不覆写同名密钥，但同名密钥已存在。 258 259**处理步骤** 260 261请根据业务需要检查是否应该覆写同名密钥。 262 263## 12000018 输入参数非法 264 265**错误信息** 266 267The input parameter is invalid. 268 269**可能原因** 270 2711. 必选参数没有传入。 272 2732. 参数类型错误（Type Error）。 274 2753. 空参数错误（Null Argument Error）。 276 2774. 参数值范围错误（Value Range Error）。 278 279**处理步骤** 280 281请检查必选参数是否传入，或者传入的参数类型是否错误。对于参数校验失败原因，请阅读参数规格约束，按照可能原因进行排查。 282 283