密鑰導入介紹及算法規(guī)格

如果業(yè)務在HUKS外部生成密鑰（比如應用間協商生成、服務器端生成），業(yè)務可以將密鑰導入到HUKS中由HUKS進行管理。密鑰一旦導入到HUKS中，在密鑰的生命周期內，其明文僅在安全環(huán)境中進行訪問操作，不會傳遞出安全環(huán)境，保證任何人都無法獲取到密鑰的明文。

密鑰導入的方式包含明文導入和加密導入兩種方式。

明文導入

該方式直接將密鑰明文導入HUKS，在導入過程中密鑰明文會暴露在非安全環(huán)境中，一般適用于輕量級設備或低安業(yè)務。

推薦使用該方式導入的密鑰類型：非對稱密鑰的公鑰
不推薦使用該方式導入的密鑰類型：對稱密鑰、非對稱密鑰對
開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

該方式支持業(yè)務與HUKS建立端到端的加密傳輸通道，將密鑰安全加密導入到HUKS中，確保導入傳入過程中密鑰不被泄露，適用于高安敏感業(yè)務。相較于明文導入，加密導入步驟更多，密鑰材料更復雜。

下圖為加密導入密鑰開發(fā)時序圖。

加密導入密鑰開發(fā)順序圖

根據開發(fā)流程，在導入加密密鑰過程中，需要依次調用HUKS的生成密鑰、導出公鑰、導入加密密鑰、刪除密鑰接口。

導出密鑰接口返回的[公鑰明文材料]是按照X.509格式封裝，導入加密密鑰接口中的密鑰材料需滿足LengthData-Data的格式封裝。

內容	長度
業(yè)務公鑰長度LCaller_Pk	4字節(jié)
業(yè)務公鑰Caller_Pk	LCaller_Pk字節(jié)
Shared_Key加密參數AAD2長度LAAD2	4字節(jié)
Shared_Key加密參數AAD2	LAAD2字節(jié)
Shared_Key加密參數Nonce2長度LNonce2	4字節(jié)
Shared_Key加密參數Nonce2	LNonce2字節(jié)
Shared_Key加密參數AEAD2長度LAEAD2	4字節(jié)
Shared_Key加密參數AEAD2	LAEAD2字節(jié)
Caller_Kek密文長度LCaller_Kek_enc	4字節(jié)
Caller_Kek密文Caller_Kek_enc	LCaller_Kek_enc字節(jié)
Caller_Kek加密參數AAD3長度LAAD3	4字節(jié)
Caller_Kek加密參數AAD3	LAAD3字節(jié)
Caller_Kek加密參數Nonce3長度LNonce3	4字節(jié)
Caller_Kek加密參數Nonce3	LNonce3字節(jié)
Caller_Kek加密參數AEAD3長度LAEAD3	4字節(jié)
Caller_Kek加密參數AEAD3	LAEAD3字節(jié)
密鑰明文材料長度的長度LTo_Import_Key_size	4字節(jié)
密鑰明文材料長度To_Import_Key_size	LTo_Import_Key_size字節(jié)
To_Import_Key密文長度LTo_Import_Key_enc	4字節(jié)
To_Import_Key密文To_Import_Key_enc	LTo_Import_Key_enc字節(jié)`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

QQ截圖20240705211300.png

以下為密鑰導入支持的規(guī)格說明。

面向OpenHarmony的廠商適配密鑰管理服務規(guī)格分為必選規(guī)格和可選規(guī)格。必選規(guī)格為所有廠商均支持的算法規(guī)格。而對于可選規(guī)格，廠商將基于實際情況決定是否實現，如需使用，請查閱具體廠商提供的說明，確保規(guī)格支持再使用。

建議開發(fā)者使用必選規(guī)格開發(fā)應用，可保證全平臺兼容。

算法	支持的密鑰長度	API級別	是否必選規(guī)格
AES	128、192、256	8+	是
RSA	512、768、1024	8+	否
RSA	2048、3072、4096	8+	是
HMAC	8-1024（含），必須是8的倍數	8+	是
ECC	224	8+	否
ECC	256、384、521	8+	是
ED25519	256	8+	是
X25519	256	8+	是
DSA	512-1024（含），8的倍數	8+	否
DH	2048	8+	是
DH	3072、4096	8+	否
SM2	256	9+	是
SM4	128	9+	是