Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
88e2c363
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
88e2c363
编写于
10月 13, 2022
作者:
Z
zhao_zhen_zhou
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add the readme of huks errorcode
Signed-off-by:
N
zhao_zhen_zhou
<
zhaozhenzhou@huawei.com
>
上级
78bb467e
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
257 addition
and
0 deletion
+257
-0
zh-cn/application-dev/reference/errorcodes/errorcode-huks.md
zh-cn/application-dev/reference/errorcodes/errorcode-huks.md
+257
-0
未找到文件。
zh-cn/application-dev/reference/errorcodes/errorcode-huks.md
0 → 100644
浏览文件 @
88e2c363
# huks错误码
## 201 权限校验失败
### 错误信息
Check permission fail. Request $permissionName$.
### 可能原因
该错误码表示权限校验失败,可能原因如下:
1.
应用没有申请相应接口所需要的权限。
2.
应用权限不足。
### 处理步骤
1.
如果是普通权限,则应用申请相关的权限。
2.
部分接口需要系统权限非系统应用无法申请,非系统应用请不要调用系统权限接口。
## 401 参数检查失败
### 错误信息
xxx argument is invalid. User should make sure using the correct value. or
xxx arguement is missing. User should add xxx in param set.
### 可能原因
该错误码表示参数检查失败,可能原因如下:
1.
参数类型不匹配,缺少参数。
2.
算法参数内容错误。
### 处理步骤
1.
查看errorMessage所提示的缺少或参数错误名。
2.
添加或修改对应的参数。
## 801 API不支持
### 错误信息
This api is not supported in current device.
### 可能原因
该版本不支持该API对应的功能。
### 处理步骤
1.
在调用API的异常响应中处理不支持该API的业务逻辑。
## 12000001 该子功能不支持(特性)
### 错误信息
xxx mode is not support in current device.
### 可能原因
支持API,但是不支持API内部某些子特性(功能),如算法参数。
### 处理步骤
1.
调整API参数,使用可替代可支持的参数。
## 12000002 缺少密钥算法参数
### 错误信息
Check get xxx failed. User should add xxx in param set.
### 可能原因
使用密钥时缺少相关参数。
### 处理步骤
1.
查看errorMessage确认缺少的密钥参数。
2.
添加对应的正确的密钥参数。
## 12000003 无效的密钥算法参数
### 错误信息
xxx argument is invalid. User should make sure using the correct value.
### 可能原因
使用密钥时无效相关参数。
### 处理步骤
1.
查看errorMessage确认无效的的密钥参数名。
2.
修改对应的密钥参数。
## 12000004 文件错误
### 错误信息
Read file failed. or Write file failed.
### 可能原因
文件操作错误。
### 处理步骤
1.
查看是否磁盘空间已经写满、文件系统是否有其他异常。
2.
清理磁盘。
## 12000005 进程通信错误
### 错误信息
IPC communication timeout. or Receive message from IPC failed.
### 可能原因
进程通信错误。
### 处理步骤
1.
查看错误信息,排查是否进程IPC通信问题。
## 12000006 算法库操作失败
### 错误信息
Error occured in crypto engine.
### 可能原因
该错误码表示算法库操作失败,可能原因如下。
1.
算法库加解密错误,可能是密文数据不对。
2.
密钥参数不正确。
### 处理步骤
1.
排查密文数据是否正确。
2.
排查加解密参数是否正确。
## 12000007 密钥访问失败 - 密钥已失效
### 错误信息
This credential is already invalidated permanently.
### 可能原因
该错误码表示密钥访问失败 - 密钥已失效,可能原因如下。
1.
该密钥设置了清除密码失效的用户认证访问控制属性,清除过设备密钥导致密钥失效。
2.
该密钥设置了新录入生物特征失效的用户认证访问控制属性,由于录入过新的指纹或人脸导致该密钥失败。
### 处理步骤
1.
确认日志是哪种方式导致的认证不通过。
2.
如果使用了正确参数,但是失效控制导致认证不通过,则该密钥已经无法使用。
## 12000008 密钥访问失败 - 密钥认证失败
### 错误信息
Verify authtoken failed.
### 可能原因
该密钥设置了用户认证访问控制属性,由于challenge参数不正确导致无法通过认证。
### 处理步骤
1.
检查userIAM认证的challenge参数组装是否正确。
2.
如果是challenge参数不正确导致,则修改正确的组装方式,使用huks生成challenge组装,并传入userIAM重新认证。
## 12000009 密钥访问失败 - 密钥访问超时
### 错误信息
This authtoken is already timeout.
### 可能原因
该密钥设置了用户认证访问控制属性,由于使用时间窗timeout导致无法通过认证。
### 处理步骤
1.
如果是timeout导致不正确,则重新触发密钥init并重新认证,使得认证时间和密钥init时间小于设置的timeout时间。
## 12000010 密钥操作会话数已达上限
### 错误信息
The number of session has reached limit.
### 可能原因
同时使用huks进行密钥会话操作的调用方(同应用或者跨应用)过多,已经达到上限(15个)。
### 处理步骤
1.
检查同应用内部是否同时存在多个密钥会话操作(init),存在则修改避免同时调用。
2.
如不存在上述情形,则可能是其它应用同时调用多个会话,通过等待其它应用释放会话后再使用。
## 12000011 目标对象不存在
### 错误信息
Queried entity does not exist.
### 可能原因
该别名对应的密钥不存在。
### 处理步骤
1.
检查密钥别名是否拼写错误。
2.
检查改密钥别名对应的密钥是否生成成功。
## 12000012 外部错误
### 错误信息
External error xxx.
### 可能原因
外部的硬件出错,文件错误等。
### 处理步骤
1.
拿错误码与日志在社区反馈。
## 12000013 密钥设置生物访问控制时,待绑定的凭据不存在
### 错误信息
Queried credential does not exist.
### 可能原因
密钥绑定PIN、指纹、人脸时,未录入相关凭据。
### 处理步骤
1.
录入相关凭据,或更改绑定凭据类型。
## 12000014 内存不足
### 错误信息
Memory is insufficient.
### 可能原因
系统内存不足。
### 处理步骤
1.
开发者释放部分内存。
## 12000015 调用其他系统服务失败
### 错误信息
Call xxx service to do xxx failed.
### 可能原因
其他系统服务未启动。
### 处理步骤
1.
开发者等待一段时间后尝试再次触发调用。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录