HUKS错误码-安全-错误码参考-ArkTS API参考

说明

以下仅介绍本模块特有错误码，通用错误码请参考通用错误码说明文档。

12000001 该子功能不支持（特性）

错误信息

The ${messageInfo} is not supported.

可能原因

支持API，但是不支持API内部某些子特性（功能），如算法参数。

处理步骤

调整API参数，使用可替代可支持的参数。

12000002 缺少密钥算法参数

错误信息

Failed to obtain the ${messageInfo}. It is not set in ParamSet.

可能原因

使用密钥时缺少相关参数。

处理步骤

查看errorMessage确认缺少的密钥参数。
添加对应的正确的密钥参数。

12000003 无效的密钥算法参数

错误信息

Invalid ${messageInfo}.

可能原因

使用密钥时无效相关参数。

处理步骤

查看errorMessage确认无效的的密钥参数名。
修改对应的密钥参数。

12000004 文件错误

错误信息

可能为以下的其中一种：

Insufficient storage space.
Invalid file size.
Failed to ${messageInfo}.

可能原因

文件操作错误。

处理步骤

查看是否磁盘空间已经写满、文件系统是否有其他异常。
清理磁盘。

12000005 进程通信错误

错误信息

可能为以下的其中一种：

Failed to get messages from IPC.
IPC ${messageInfo}.

可能原因

进程通信错误。

处理步骤

查看错误信息，排查是否进程IPC通信问题。

12000006 算法库操作失败

错误信息

Crypto engine error.

可能原因

该错误码表示算法库操作失败，可能原因如下。

算法库加解密错误，可能是密文数据不对。
密钥参数不正确。

处理步骤

排查密文数据是否正确。
排查加解密参数是否正确。

12000007 密钥访问失败 - 密钥已失效

错误信息

This credential is invalidated permanently.

可能原因

该错误码表示密钥访问失败 - 密钥已失效，可能原因如下。

该密钥设置了清除密码失效的用户认证访问控制属性，清除过设备密钥导致密钥失效。
该密钥设置了新录入生物特征失效的用户认证访问控制属性，由于录入过新的指纹或人脸导致该密钥失败。

处理步骤

确认日志是哪种方式导致的认证不通过。
如果使用了正确参数，但是失效控制导致认证不通过，则该密钥已经无法使用。

12000008 密钥访问失败 - 密钥认证失败

错误信息

The authentication token verification failed.

可能原因

该密钥设置了用户认证访问控制属性，由于challenge参数不正确导致无法通过认证。

处理步骤

检查userIAM认证的challenge参数组装是否正确。
如果是challenge参数不正确导致，则修改正确的组装方式，使用huks生成challenge组装，并传入userIAM重新认证。

12000009 密钥访问失败 - 密钥访问超时

错误信息

This authentication token timed out.

可能原因

该密钥设置了用户认证访问控制属性，由于使用时间窗timeout导致无法通过认证。

处理步骤

如果是timeout导致不正确，则重新触发密钥init并重新认证，使得认证时间和密钥init时间小于设置的timeout时间。

12000010 密钥操作会话数已达上限

错误信息

The number of key operation sessions has reached the limit.

可能原因

同时使用huks进行密钥会话操作的调用方（同应用或者跨应用）过多，已经达到上限（15个）。

处理步骤

检查同应用内部是否同时存在多个密钥会话操作（init)，存在则修改避免同时调用。
如不存在上述情形，则可能是其它应用同时调用多个会话，通过等待其它应用释放会话后再使用。

12000011 目标对象不存在

错误信息

The entity does not exist.

可能原因

该别名对应的密钥不存在。

处理步骤

检查密钥别名是否拼写错误。
检查改密钥别名对应的密钥是否生成成功。

12000012 外部错误

错误信息

System external error.

可能原因

外部的硬件出错，文件错误等。

处理步骤

拿错误码与日志在社区反馈。

12000013 密钥设置生物访问控制时，待绑定的凭据不存在

错误信息

The credential does not exist.

可能原因

密钥绑定PIN、指纹、人脸时，未录入相关凭据。

处理步骤

录入相关凭据，或更改绑定凭据类型。

12000014 内存不足

错误信息

可能为以下的其中一种：

Insufficient memory.
Malloc failed.

可能原因

系统内存不足。

处理步骤

开发者释放部分内存或重启。

12000015 调用其他系统服务失败

错误信息

Failed to obtain the ${messageInfo} information via UserIAM.

可能原因

其他系统服务未启动。

处理步骤

开发者等待一段时间后尝试再次触发调用。