crypto_asym_key.h

概述

声明非对称密钥接口。

库： libohcrypto.so

系统能力： SystemCapability.Security.CryptoFramework

起始版本： 12

相关模块：CryptoAsymKeyApi

汇总

类型定义

名称	描述
typedef struct OH_CryptoKeyPair OH_CryptoKeyPair	定义密钥对结构体。
typedef struct OH_CryptoPubKey OH_CryptoPubKey	定义公钥结构体。
typedef struct OH_CryptoAsymKeyGenerator OH_CryptoAsymKeyGenerator	定义非对称密钥生成器结构体。

枚举

名称	描述
CryptoAsymKey_ParamType { CRYPTO_DSA_P_DATABLOB = 101, CRYPTO_DSA_Q_DATABLOB = 102, CRYPTO_DSA_G_DATABLOB = 103, CRYPTO_DSA_SK_DATABLOB = 104, CRYPTO_DSA_PK_DATABLOB = 105, CRYPTO_ECC_FP_P_DATABLOB = 201, CRYPTO_ECC_A_DATABLOB = 202, CRYPTO_ECC_B_DATABLOB = 203, CRYPTO_ECC_G_X_DATABLOB = 204, CRYPTO_ECC_G_Y_DATABLOB = 205, CRYPTO_ECC_N_DATABLOB = 206, CRYPTO_ECC_H_INT = 207, CRYPTO_ECC_SK_DATABLOB = 208, CRYPTO_ECC_PK_X_DATABLOB = 209, CRYPTO_ECC_PK_Y_DATABLOB = 210, CRYPTO_ECC_FIELD_TYPE_STR = 211, CRYPTO_ECC_FIELD_SIZE_INT = 212, CRYPTO_ECC_CURVE_NAME_STR = 213, CRYPTO_RSA_N_DATABLOB = 301, CRYPTO_RSA_D_DATABLOB = 302, CRYPTO_RSA_E_DATABLOB = 303, CRYPTO_DH_P_DATABLOB = 401, CRYPTO_DH_G_DATABLOB = 402, CRYPTO_DH_L_NUM = 403, CRYPTO_DH_SK_DATABLOB = 404, CRYPTO_DH_PK_DATABLOB = 405, CRYPTO_ED25519_SK_DATABLOB = 501, CRYPTO_ED25519_PK_DATABLOB = 502, CRYPTO_X25519_SK_DATABLOB = 601, CRYPTO_X25519_PK_DATABLOB = 602 }	定义非对称密钥参数类型。
Crypto_EncodingType { CRYPTO_PEM = 0, CRYPTO_DER = 1 }	定义编码格式。

函数

名称	描述
OH_Crypto_ErrCode OH_CryptoAsymKeyGenerator_Create (const char *algoName, OH_CryptoAsymKeyGenerator **ctx)	通过指定算法名称的字符串，获取相应的非对称密钥生成器实例。
OH_Crypto_ErrCode OH_CryptoAsymKeyGenerator_Generate (OH_CryptoAsymKeyGenerator *ctx, OH_CryptoKeyPair **keyCtx)	随机生成非对称密钥（密钥对）。
OH_Crypto_ErrCode OH_CryptoAsymKeyGenerator_Convert (OH_CryptoAsymKeyGenerator *ctx, Crypto_EncodingType type, Crypto_DataBlob *pubKeyData, Crypto_DataBlob *priKeyData, OH_CryptoKeyPair **keyCtx)	转换非对称密钥数据为密钥对。
const char * OH_CryptoAsymKeyGenerator_GetAlgoName (OH_CryptoAsymKeyGenerator *ctx)	获取非对称密钥算法名称。
void OH_CryptoAsymKeyGenerator_Destroy (OH_CryptoAsymKeyGenerator *ctx)	销毁非对称密钥生成器实例。
void OH_CryptoKeyPair_Destroy (OH_CryptoKeyPair *keyCtx)	销毁非对称密钥对实例。
OH_CryptoPubKey * OH_CryptoKeyPair_GetPubKey (OH_CryptoKeyPair *keyCtx)	从密钥对中获取公钥实例。
OH_Crypto_ErrCode OH_CryptoPubKey_Encode (OH_CryptoPubKey *key, Crypto_EncodingType type, const char *encodingStandard, Crypto_DataBlob *out)	根据指定的编码格式输出公钥数据。
OH_Crypto_ErrCode OH_CryptoPubKey_GetParam (OH_CryptoPubKey *key, CryptoAsymKey_ParamType item, Crypto_DataBlob *value)	从公钥实例获取指定参数。