HUKS錯(cuò)誤碼

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

錯(cuò)誤信息

The ${messageInfo} is not supported.

可能原因

支持API，但是不支持API內(nèi)部某些子特性（功能），如算法參數(shù)。

處理步驟

調(diào)整API參數(shù)，使用可替代可支持的參數(shù)。

12000002 缺少密鑰算法參數(shù)

錯(cuò)誤信息

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

可能原因

使用密鑰時(shí)缺少相關(guān)參數(shù)。

處理步驟

1. 查看errorMessage確認(rèn)缺少的密鑰參數(shù)。
2. 添加對(duì)應(yīng)的正確的密鑰參數(shù)。

12000003 無(wú)效的密鑰算法參數(shù)

錯(cuò)誤信息

Invalid ${messageInfo}.

可能原因

使用密鑰時(shí)無(wú)效相關(guān)參數(shù)。

處理步驟

1. 查看errorMessage確認(rèn)無(wú)效的的密鑰參數(shù)名。
2. 修改對(duì)應(yīng)的密鑰參數(shù)。

12000004 文件錯(cuò)誤

錯(cuò)誤信息

可能為以下的其中一種：

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

可能原因

文件操作錯(cuò)誤。

處理步驟

1. 查看是否磁盤(pán)空間已經(jīng)寫(xiě)滿(mǎn)、文件系統(tǒng)是否有其他異常。
2. 清理磁盤(pán)。

12000005 進(jìn)程通信錯(cuò)誤

錯(cuò)誤信息

可能為以下的其中一種：

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

可能原因

進(jìn)程通信錯(cuò)誤。

處理步驟

查看錯(cuò)誤信息，排查是否進(jìn)程IPC通信問(wèn)題。

12000006 算法庫(kù)操作失敗

錯(cuò)誤信息

Crypto engine error.

可能原因

該錯(cuò)誤碼表示算法庫(kù)操作失敗，可能原因如下。

1. 算法庫(kù)加解密錯(cuò)誤，可能是密文數(shù)據(jù)不對(duì)。
2. 密鑰參數(shù)不正確。

處理步驟

1. 排查密文數(shù)據(jù)是否正確。
2. 排查加解密參數(shù)是否正確。

12000007 密鑰訪問(wèn)失敗 - 密鑰已失效

錯(cuò)誤信息

This credential is invalidated permanently.

可能原因

該錯(cuò)誤碼表示密鑰訪問(wèn)失敗 - 密鑰已失效，可能原因如下。

1. 該密鑰設(shè)置了清除密碼失效的用戶(hù)認(rèn)證訪問(wèn)控制屬性，清除過(guò)設(shè)備密鑰導(dǎo)致密鑰失效。
2. 該密鑰設(shè)置了新錄入生物特征失效的用戶(hù)認(rèn)證訪問(wèn)控制屬性，由于錄入過(guò)新的指紋或人臉導(dǎo)致該密鑰失敗。

處理步驟

1. 確認(rèn)日志是哪種方式導(dǎo)致的認(rèn)證不通過(guò)。
2. 如果使用了正確參數(shù)，但是失效控制導(dǎo)致認(rèn)證不通過(guò)，則該密鑰已經(jīng)無(wú)法使用。

12000008 密鑰訪問(wèn)失敗 - 密鑰認(rèn)證失敗

錯(cuò)誤信息

The authentication token verification failed.

可能原因

該密鑰設(shè)置了用戶(hù)認(rèn)證訪問(wèn)控制屬性，由于challenge參數(shù)不正確導(dǎo)致無(wú)法通過(guò)認(rèn)證。

處理步驟

1. 檢查userIAM認(rèn)證的challenge參數(shù)組裝是否正確。
2. 如果是challenge參數(shù)不正確導(dǎo)致，則修改正確的組裝方式，使用huks生成challenge組裝，并傳入userIAM重新認(rèn)證。

12000009 密鑰訪問(wèn)失敗 - 密鑰訪問(wèn)超時(shí)

錯(cuò)誤信息

This authentication token timed out.

可能原因

該密鑰設(shè)置了用戶(hù)認(rèn)證訪問(wèn)控制屬性，由于使用時(shí)間窗timeout導(dǎo)致無(wú)法通過(guò)認(rèn)證。

處理步驟

如果是timeout導(dǎo)致不正確，則重新觸發(fā)密鑰init并重新認(rèn)證，使得認(rèn)證時(shí)間和密鑰init時(shí)間小于設(shè)置的timeout時(shí)間。

12000010 密鑰操作會(huì)話數(shù)已達(dá)上限

錯(cuò)誤信息

The number of key operation sessions has reached the limit.

可能原因

同時(shí)使用huks進(jìn)行密鑰會(huì)話操作的調(diào)用方（同應(yīng)用或者跨應(yīng)用）過(guò)多，已經(jīng)達(dá)到上限（15個(gè)）。

處理步驟

1. 檢查同應(yīng)用內(nèi)部是否同時(shí)存在多個(gè)密鑰會(huì)話操作（init)，存在則修改避免同時(shí)調(diào)用。
2. 如不存在上述情形，則可能是其它應(yīng)用同時(shí)調(diào)用多個(gè)會(huì)話，通過(guò)等待其它應(yīng)用釋放會(huì)話后再使用。

12000011 目標(biāo)對(duì)象不存在

錯(cuò)誤信息

The entity does not exist.

可能原因

該別名對(duì)應(yīng)的密鑰不存在。

處理步驟

1. 檢查密鑰別名是否拼寫(xiě)錯(cuò)誤。
2. 檢查改密鑰別名對(duì)應(yīng)的密鑰是否生成成功。

12000012 外部錯(cuò)誤

錯(cuò)誤信息

System external error.

可能原因

外部的硬件出錯(cuò)，文件錯(cuò)誤等。

處理步驟

拿錯(cuò)誤碼與日志在社區(qū)反饋。

12000013 密鑰設(shè)置生物訪問(wèn)控制時(shí)，待綁定的憑據(jù)不存在

錯(cuò)誤信息

The credential does not exist.

可能原因

密鑰綁定PIN、指紋、人臉時(shí)，未錄入相關(guān)憑據(jù)。

處理步驟

錄入相關(guān)憑據(jù)，或更改綁定憑據(jù)類(lèi)型。

12000014 內(nèi)存不足

錯(cuò)誤信息

可能為以下的其中一種：

• Insufficient memory.
• Malloc failed.

可能原因

系統(tǒng)內(nèi)存不足。

處理步驟

開(kāi)發(fā)者釋放部分內(nèi)存或重啟。

12000015 調(diào)用其他系統(tǒng)服務(wù)失敗

錯(cuò)誤信息

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

可能原因

其他系統(tǒng)服務(wù)未啟動(dòng)。

處理步驟

開(kāi)發(fā)者等待一段時(shí)間后嘗試再次觸發(fā)調(diào)用。