密码设备应用接口规范.docx

ICS 35040L 80备案号：383162013 BM中华人民 共禾口 国密码行业标准GMT 00182012密码设备应用接口规范Interface specifications of cryptography device application20121 1_22发布 2012-1122实施国家密码管理局发布GMT 00182012目次前言 引言 1范围 一l2规范性引用文件 13术语和定义 -14符号和缩略语 25算法标识和数据结构 - z51算法标识定义 252设备信息定义 253密钥分类及存储定义- “3531设备密钥与用户密钥- -3532密钥加密密钥 3533会话密钥 -354RSA密钥数据结构定义 - - 355ECC密钥数据结构定义556ECC加密数据结构定义 557ECC签名数据结构定义- - -658ECC加密密钥对保护结构 - 66设备接口描述 761密码设备应用接口在公钥密码基础设施应用技术体系框架中的位置762设备管理类函数 一7621打开设备 一7622关闭设备 -8623创建会话 -8624关闭会话 - 8625获取设备信息 - 8626产生随机数 8627获取私钥使用权限 9628释放私钥使用权限 963密钥管理类函数-9631导出RSA签名公钥- - 10632导出RSA加密公钥 10633产生RSA密钥对并输出 一10634生成会话密钥并用内部RSA公钥加密输出 11635生成会话密钥并用外部RSA公钥加密输出 一11636导入会话密钥并用内部RSA私钥解密 12637基于RSA算法的数字信封转换 1z638导出ECC签名公钥 一13IGMT 00182012639导出ECC加密公钥136310产生ECC密钥对并输出 一136311生成会话密钥并用内部ECC公钥加密输出146312生成会话密钥并用外部ECC公钥加密输出 - 146313导人会话密钥并用内部ECC私钥解密 146314生成密钥协商参数并输出 -156315计算会话密钥 156316产生协商数据并计算会话密钥 166317基于ECC算法的数字信封转换-176318生成会话密钥并用密钥加密密钥加密输出- - 176319导人会话密钥并用密钥加密密钥解密 186320销毁会话密钥 - 一1864非对称算法运算类函数 - 18641外部公钥RSA运算 ”19642内部公钥RSA运算 19643内部私钥RSA运算 20644外部密钥ECC验证 - 20645内部密钥ECC签名 21646内部密钥ECC验证 21647外部密钥ECC公钥加密 2165对称算法运算类函数 22651对称加密 - 22652对称解密 23653计算MAC2366杂凑运算类函数- 24661杂凑运算初始化24662多包杂凑运算 - - 2466 3杂凑运算结束 - 2567用户文件操作类函数 -25671创建文件 - 2567，2读取文件25673写文件 26674删除文件 267安全要求 2771密钥管理要求 一2772密码服务要求 - 一2773设备状态要求 - - 2774其他安全要求 - 一27 附录A(规范性附录) 函数返回代码定义 28 参考文献 - 29GMT 00182012 刖昌本标准依据OBT 112009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准中的附录A为规范性附录。本标准由国家密码管理局提出并归口。 本标准起草单位；卫士通信息产业股份有限公司、无锡江南信息安全工程技术中心、上海格尔软件股份有限公司、北京数字认证股份有限公司、兴唐通信科技股份有限公司、山东得安计算机技术有限公 司、北京海泰方圆科技有限公司。本标准主要起草人：刘平、李元正、徐强、谭武征、李述胜、李玉峰、高志权、柳增寿。GMT 00182012引言本标准的目标是为公钥密码基础设麓应用体系框架下的服务类密码设备制定统一的应用接口标 准，通过该接口调用密码设备，向上层提供基础密码服务。为该类密码设备的开发、使用及检测提供标 准依据和指导，有利于提高该类密码设备的产品化、标准化和系列化水平。本标准凡涉及密码算法相关内容，按国家有关法规实施。GMT 00182012密码设备应用接口规范l范围 本标准规定了公钥密码基础设施应用技术体系下服务类密码设备的应用接口标准。本标准适用于服务类密码设备的研制、使用，以及基于该类密码设备的应用开发，也可用于指导该 类密码设备的检测。2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件，凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GMT 0006密码应用标识规范GMT 0009 SM2密码算法使用规范3术语和定义 以下术语和定义适用于本文件。31算法标识algorithm identifier用于对密码算法进行唯一标识的符号。32非对称密码算法公钥密码算法asymmetric cryptegraphie algorithmpublic key cryptographic algorittun加解密使用不同密钥的密码算法。33解密deciphermtdecryption加密过程对应的逆过程。34设备密钥device key pair存储在设备内部的用于设备管理的非对称密钥对，包含签名密钥对和加密密钥对。35加密endphermentencryption对数据进行密码变换以产生密文的过程。36密钥加密密钥key encrypt key；KEK对密钥进行加密保护的密钥。37公钥基础设施public key infrastructure；PKI用公钥密码技术建立的普遍适用的基础设施，为用户提供证书管理和密钥管理等安全服务。38私钥访问控制码private key aooepassword用于验证私钥使用权限的口令字。GMT 0018201239对称密码技术对称密码体制symmetric cryptegrapKc technique原发者和接收者均采用同一秘密密钥进行变换的密码技术(体制)。其中，加密密钥与解密密钥相同 或者一个密钥可以从另一个密钥导出的密码体制。310会话密钥se鳓key处于层次化密钥结构中的最低层，仅在一次会话中使用的密钥。311用户密钥key存储在设备内部的用于应用密码运算的非对称密钥，包含签名密钥对和加密密钥对。4符号和缩略语 下列缩略语适用于本部分：ECC椭圆曲线算法(Elliptic Curve Cryptography)IPK内部加密公钥(Internal Public Key) ISK内部加密私钥(Imemal Private Key) EPK外部加密公钥(External Public Key) KEK密钥加密密钥(Key Encrypt Key)5算法标识和数据结构51算法标识定义 本标准中所使用的算法其算法标识见GMT 0006。52设备信息定义宁段名称 数据长度(字节) 含义IssuerName40 设备生产厂商名称DeviceName16 设备型号 设备编号，包含：日期(8字符)、批次号(3字符)、流水号DeviceSerial16(5字符)Dev_eeVersion4密码设备内部软件的版本号StandardVersion4密码设备支持的接口规范版本号前4字节表示支持的算法，表示方击为非对称算法标识按AzymAlgAbility8位或的结果；后4字节表示算法的最大模长表示方法为 支持的模长按位或的结果所有支持的对称算法，表示方击为对称算法标识按位或svmA【gAhility4运算结果所有支持的杂凑算法，表示方法为杂妻算法标识按位或HashAlgAbility4运算结果ButterSize4支持的最大文件存储空间(单位字节)GMT 00182012 实际数据结构定义：typeclef strUCt Devicelno_st uns遍ned char IssuerName40； unsl,ned char DeviceName16； unslgned char DeviceSerial16； unstgned int DeviceVersion； unstgned int StandM矾ersion； unstgned int AsymAlgAbihtyE2unsigned int SynuAlgAbility； unslgned int HashAlgAbility； unstgned int BufferSize；DEVICEINFO；53密钥分类及存储定义531设备密钥与用户密钥 设备密钥只能在设备初始化时生成或安装，用户密钥通过密码设备管理工具生成或安装。设备密钥和用户密钥存放于密钥存储区，索引号从0开始检索，每个索引号对应一个签名密钥对和一 个加密密钥对。其中，索引号为0表示设备密钥。索引号从1开始表示用户密钥。密钥对索引号 公钥私钥 设备签名公钥 设备签名私钥O如0设备加密公钥 设备加密私钥用户签名公钥 用户签名私钥oxOl用户加密公钥 用户加密私钥532密钥加密密钥 密钥加密密钥通过密码设备管理工具生成或安装，密钥长度为128位，存放于密钥存储区，使用索目号从1开始。密钥索引号 密钥加密密钥o01 密钥加密密钥001533会话密钥 会话密钥使用设备接111函数生成或导人，会话密钥使用句柄检索。54RSA密钥数据结构定义RSA密钥结构存储时顺序为从高到低，即密钥存放时从密钥结构数组的最高位开始，最高字节填在最 高位，不足位填充数据0。3GM门r 00182012公钥数据结构定义字段名称 数据长度(字节 含义 bits 4 模长 M 256 模NE 256公钥指数 私胡数据结构定义宇段名称 数据长度 含义 bits 4 模长 M 256 模NE 256公钥指数 D256 私钥指数 prime2 1282 素数P和qpe)【P2 128X 2 Dp和Dqef 128 系数i实际数据结构定义：#ddine RSArd_MAX_BITS 2048#define RSArd MAX IEN (RSAreLMAX_BTS+7)8)#ddine RSAxef_MAX_PBITS (RSAreLMAX_BITS+1)2)#define RSArefMAX_PLEN (RSAreQMAX_PBITS+7)8)typedestruct RSArefPublicKey_stunsigned int bits；unsigned char mRSAzeLMAX_LEN3；unsigned char eERSAref_MAX_LEN；)RSmetPublieKey；typedef struct RSAretPrivateKey_stunsigned im bitsunsigned char mRSAreLMAX_LEN； unsigned char eRSAref_MAX_LEN； unsigned char dRSAref_MAX LEN；unsigned char primeE23ERSArd_MAX_PLEN unsigned char pe坤2RsmeLMAx PLEN； unsigned char coefRSAreLMAX_PLEN；)RSAremrivateKey；4GMT 0018201255FOE密钥数据结构定义公钥数据结构定义字畏名称 数据长度(字节) 含义bits 4 密镅位长ECCref_MAX_LEN 公钥x坐标 y ECCref_MAX_LEN 公钥Y坐标 私胡数据结构定义字段名称 数据长度(字节) 含义bits 4 密钥位长K ECCrd_MAX_LEN 私钥实际数据结构定义：#deftme ECCtelMAX BIIS 512#define麟ref_MAX_LEN (EocreLMAX_BITS+7)8)typedestruct ECCrefPublicKey stunsigned int bits；unsigned char xECCre_MAX LEN；unsigned char yEECCreLgLEN3；)ECCretPublicKey；typedef struct ECCrefPrivateKey_st unsigned int bits；unsigned char KECCrd_MAX_LEN)ECCrefPrivateKey；56EOc加密数据结构定义加密数据结构定义宇段名称 数据长度(字节) 含义 ECCref_MAX_LENPx分量y ECCref_MAX_LEN Y分量M 32 明文的杂凑值 L 4 密文数据长度 C L 密文数据实际数据结构定义：typedef struct ECCCipher_stunsigned char xECCrd_MAX_LENGMT 00182012unsigned char yECCref MAX_LENunsigned char M32； unsigned int L； unsigned char c1；)EC(X：ipher；57EaC签名数据结构定义签名数据结构定义字段名称 数据长度(字节) 含义ECCreI MAX_LEN 签名的r部分ECCref_MAX_LEN签名的s部分实际数据结构定义：typedef struct ECCSignature st(unsigned char rECCreLMAx LEN；unsigned char sECCref_MAx LEN；)EeCSignaturet58E()c加密密钥对保护结构 密钥管理系统下发到设备中的ECC加密密钥对使用本结构表示。581类型定义typedef struct SDF ENVELOPEDKEYBLOBunsigned long ulAsymmAlgID；unsigned long ulSymmAlglD：E(、cCIPHERBLOB EC姐2ipherBlob；ECCPUBLICKELOB PubKey；unsigned char chEncryptedPriKey64；)E卜、，EI OPDKELOB。*PENVELOPEDKEYBLOB；582数据项描述数据项 类型 意义备注ulAsymnldklgIDunsigned long 保护对称密钥的非对称算法标识l】lSmmAlgIDunigned long 对称算法标识 必须为ECB模式ECCCipherBIobBCCC口HERELOB 对称密钥密文PubKey BOCPUBLICKEYBLOB加密密钥对的公钥私钥原文为ECCPRI 加密密钥对的私钥密文，其有效cbEncryptedPrivKey无符号数组 VATEKEYBLOB结构中 长度为原文的(ulBits+7)8的PfivateKey66设备接口描述6 1密码设备应用接口在公钥密码基础设施应用技术体系框燕中的位置 在公钥密码基础设施应用技术体系框架中，密码设备服务层由密码机、密码卡，智能密码终端等设备组成，通过本标准规定的密码设备应用接13向通用密码服务层提供基础密码服务，如图l所示。 基础密码服务包括密钥生成、单一的密码运算、文件管理等的服务。 本标准采用C语言描述接口函数。如无特别说明，函数中参数的长度单位均为字节数。图1密码设备应用接口在公钥密码基础设施应用技术体系结构中的位置6 2设备管理类函数设备管理类函数包括以下具体函数，各函数返凹值见附录A函数返回代码定义A 打开设备SDF OpenDe、fice R关闭设备：SDF Closel2e viec c创建会话：SDF 0pen,Session n关闭会话SDF_CloscSessionE 获取设备信息：SDF_GetDeviceInoF 产生随机数：SDF GenerateRandomG 获取私钥使用权限SDF GetPrlvateKeyAeeessPaghtH 释放私钥使用权限：sDF_Relsd墒坩teKeyAc Right6 2 1打开设备原型： int SDF_OpenDevice(void*+phDevicelIandle)：描述： 打开密码设备。参数 phDeceHandle。ut返回设备旬柄 返回值：0 成功非0 失败，返回错误代码GMT 00182012 备注：phDeviceHandle由函数初始化并填写内容622关闭设备原型：int SDF_CloseDevice(void*hDeviceHandle)； 描述：关闭密码设备，并释放相关资源。 参数：hDeviceHandlein 已打开的设备句柄 返回值：0成功非0 失败，返回错误代码623创建会话原型：int SDF_OpenSession(void*hDeviceHandle，void*。phSessionHandle)：描述：创建与密码设备的会话。参数：hI)eviceHanclleFin 已打开的设备句柄phSessiunHandle-out返回与密码设备建立的新会话句柄 返回值：0成功非0 失败，返回错误代码624关闭会话原型： int SDF CloseSession(void*hSessionHandle)； 描述：关闭与密码设备已建立的会话，并释放相关资源。 参数：hSessionHandle Ein3 与密码设备已建立的会话句柄 返回值：0 成功非0 失败，返回错误代码625获取设备信息原型：int SDF_GetDevicelrdo(void*hSessionHandle，DEVICEINFO+pstDevicelnfo)；描述：获取密码设备能力描述。参数：hSessionHandlein 与设备建立的会话句柄pstDevieelnfo Eouq 设备能力描述信息，内容及格式见设备信息定义 返回值：0成功非0 失败，返回错误代码626产生随机数原型：int SDF_GenerateRandom( void*hSessionHandle， usigned int uiLength， unsigned char+pucRandom)描述：获取指定长度的随机数。参数：hSessionHandlein与设备建立的会话句柄 uiLengthl-in欲获取的随机数长度 pucRandomouQ缓冲区指针，用于存放获取的随机数8GMT 00182012 返回值：O成功非0失败，返回错误代码627获取私钥使用权限原型 int SDF_GetPrivateKeyAccessRight(void*hSessionHandle， unsigned int uiKe：yIndex， unsigned char+pucPassword， unsigned int uiPwdLength)；描述：获取密码设备内部存储的指定索引私钥的使用权。参数：hSessionHandlein 与设备建立的会话句柄 uiKeyIndexin密码设备存储私钥的索引值 pucPasswordin 使用私钥权限的标识码 uiPwdLengthin 私钥访问控制码长度，不少于8字节返回值：0成功非0失败，返回错误代码备注：本标准涉及密码设备存储的密钥对索引值的的起始索引值为1，最大为n，密码设备的实 际存储容量决定n值，628释放私钥使用权限原型：int SDF_ReleasePrivateKeyAccessRight(void*hSessionHandle，unsigned int uiKeylndex)；描述：释放密码设备存储的指定索引私钥的使用授权。 参数：hSessionHandlein与设备建立的会话句柄uiKeyIndexin密码设备存储私钥索引值 返回值：0成功非0 失败，返回错误代码63密钥管理类函数 密钥管理类函数包括以下具体函数，各函数返回值见附录A函数返回代码定义：A导出RSA签名公钥：SDF_ExportSignPublieKey_RSAR导出RSA加密公钥：SDF_ExportEncPublicKey_RSAc产生RSA非对称密钥对并输出：SDF_GenerateKeyPair_RSAn 生成会话密钥并用内部RSA公钥加密输出：SDF GtnerateKeyWithlPK RSA E 生成会话密钥并用外部RSA公钥加密输出：sDLGenemteKeyWithEPK_RsA F导人会话密钥并用内部RSA私钥解密：SDF_ImportKeyWithISK_RSAG基于RSA算法的数字信封转换：SDF_ExchangeDigitEnvdopeBaseor鲻AH导出ECC签名公钥：SDF_ExportSignPublicKey_ECCI导出ECC加密公钥：SDF_ExportEncPublicKey_ECCJ产生ECC非对称密钥对并输出：SDF_GenerateKeyPair_ECCK生成会话密钥并用内部ECC公钥加密输出：SDF GenerateKeyWithIPKECCL生成会话密钥并用外部ECC公钥加密输出：SDF GenerateKeyWithEPK ECCOGMT 00182012M导人会话密钥并用内部ECC私钥解密：SDF_ImportKeyWithlSK_ECCN生成密钥协商参数并输出：SDF_GenerateAgrcementDataWithECC0计算会话密钥：SDF_GenerateKeyWithECCP产生协商数据并计算会话密钥tSDF GenerateAgreementDataKttdKeyWithECCQ基于ECC算法的数字信封转换：sDF_ExchangeDigitEnvelopeBaseOnECCR 生成会话密钥并用密钥加密密钥加密输出：SDF GenerateKeyWithKEK S导入会话密钥并用密钥加密密钥解密：SDF_ImportKeyWithKEK T销毁会话密钥：SDF_DestroyKey631导出llSA签名公钥原型：int SDF_ExportSignPublicKey_RSA( void*hSessionHandle， unsigned int uiKeyIndex，RSArefPublicKey。pucPublicKey)；描述：导出密码设备内部存储的指定索引位置的签名公钥。 参数：hSessionHandlein与设备建立的会话句柄uiKeylndexin密码设备存储的RSA密钥对索引值puePublicKeyout3RSA公钥结构 返回值：0成功非0 失败，返回错误代码632导出RSA加密公钥原型：int SDF_ExportEncPublicKey RSA(void*hSessionHandle， unsigned int uiKeylndex， RSAretPubllcKey。pucPublicKey)；描述：导出密码设备内部存储的指定索引位置的加密公钥。参数：hSessionHandlein与设备建立的会话句柄 uLKeylndexin 密码设备存储的RSA密钥对索引值 pucPublicKeyout RSA公钥结构返回值：0成功非0 失败，返回错误代码633产生RSA密钥对并输出原型：int SDF GenerateKeyPair_RSA(void*hSessionHandle， unsigned int uiKeyBits， RSArelPublicKey+pucPublicKeyRSArePfivateKey-16 pucPfivateKey)；描述：请求密码设备产生指定模长的RSA密钥对。参数：hSessionHandlein与设备建立的会话句柄uiKeyBitsin指定密钥模长】0GMT 00182012 puePublicKeyout RSA公钥结构pucPrivateKeyoutRSA私钥结构 返回值：0成功非0 失败，返回错误代码634生成会话密钥并用内部RSA公钥加密输出 原型：int SDF_GenerateKeyWithIPK_RSA(void*hSessionHandle， unsigned int uilPKIndex， unsigned int uiKeyBits，unsigned char+pucKey， unsigned int。puiKeyLength， void-ye。phKeyHandle)；描述：生成会话密钥并用指定索引的内部加密公钥加密输出，同时返回密钥句柄。参数：hSessionHandlein 与设备建立的会话旬柄 uilPKlndexin密码设备内部存储公钥的索引值 uiKeyBitsin指定产生的会话密钥长度pueKeyout 缓冲区指针，用于存放返回的密钥密文 puiKeyLength-out返回的密钥密文长度 phKeyHandleout返回的密钥句柄返回值：0 成功非0 失败，返回错误代码 备注：公钥加密数据时填充方式按照PKCS 1 v15的要求进行。635生成会话密钥并用外部RSA公钥加密输出 原型：int SDF_GenerateKeyWithEPK_RSA(void*hSessionHandle，unsigned int uiKeyBits， RSArefPublicKey。pucPublieKey， unsigned char。pucKey，unsigned int“puiKeyLength，void*+phKeyHand!e)：描述：生成会话密钥并用外部公钥加密输出，同时返回密钥旬柄。 参数：hSessionHandlein与设备建立的会话句柄uiKeyBitsin指定产生的会话密钥长度puePublieKeyin输入的外部RSA公钥结构pueKeyout 缓冲区指针，用于存放返回的密钥密文 puiKeyLengtlaout返回的密钥密文长度 phKeyHandleout返回的密钥句柄返回值：0成功非0失败，返回错误代码 备注：公钥加密数据时填充方式按照PKCS 1 v15的要求进行。GMT f10182012636导入会话密钥并用内部liSA私钥解密原型 hat SDF_ImportKe卵nthlSK_RSA( 谳d*hSessionHandle。 unsigned int uiISKIndex，unsigned charpucKey， unsigned int puiKeyLength， void*。phKeyHandle)；描述 导入会话密钥并用内部私钥解密，同时返回密钥句柄。参数 hSessionHandlein与设备建立的会话句柄 密码设备内部存储加密私钥的索引值，对应于加密 时的公钥pucKeyin 缓冲区指针，用于存放输入的密钥密文 puiKeyLengthin 输入的密钥密文长度 phKeyHandleout返回的密钥句柄返回值：0成功非0 失败，返回错误代码 备注：填充方式与公钥加密时相同。637基于RSA算法的数字信封转换int SDF_ExchangeDigitEnvelopeBaseOnRSA(void*hSessionHandle， unsigned int uiKeylndex。 RSArciPublicKey。pucPublicKey， unsigned char+pucDEInput， unsigned int uiDELength，unsigned char。pucDEOutput，unsigned int。puiDELength)；描述：将由内部加密公钥加密的会话密钥转换为由外部指定的公钥加密，可用于数字信封转换。 参数：hSessionHandlein 与设备建立的会话句柄uiKeylndexin密码设备存储的内部RSA密钥对索引值pucPublicKeyin 外部RSA公钥结构pucDEInputin 缓冲区指针，用于存放输入的会话密钥密文 uiDELengthin 输入的会话密钥密文长度 pucDEOutputout缓冲区指针，用于存放输出的会话密钥密文 puiDELengthout 输出的会话密钥密文长度返回值：0成功非0 失败，返回错误代码12GMT 00182012638导出EOC签名公钥hn SDF_ExportSignPublicKey_ECC(void*hSessionHandle，unsigned int uiKeylndex，ECCrefPublicKey+pucPublicKey)；描述：导出密码设备内部存储的指定索引位置的签名公钥。 参数：hSessionHandlein与设备建立的会话句柄uiKeylndexl-in密码设备存储的ECC密钥对索引值pucPublicKeyout ECC公钥结构 返回值：0 成功非0 失败，返回错误代码639导出ECC加密公钥原型：int SDF ExportEnePublicKey_ECC(void*hSessionHandle，unsigned int uiKeylndex，E0crefPublicKey+pucPublicKey)：描述：导出密码设备内部存储的指定索引位置的加密公钥。 参数：hSessionHandlein与设备建立的会话句柄uiKeylrtdexin密码设备存储的ECC密钥对索引值pucPublicKeyoutECC公钥结构 返回值：0成功非0 失败，返回错误代码6310产生Eoc密钥对并输出原型：int SDF_GenerateKeyP虹ECC(void*hSessionHandle， unsigned int uiAlglD， unsigned int uiKeyBits，EcCre伊ublicKeypucPublicKey ECCrefPfivateKey+pucPrivateKey)；描述：请求密码设备产生指定类型和模长的ECC密钥对。参数：hSessiortHartdleEin 与设备建立的会话句柄 uiAlgIDin 指定算法标识 uiKeyBitsin指定密钥长度 pucPublieKeyout ECC公钥结构 pucPrivateKeyoutE(私钥结构返回值：0成功非0 失败，返回错误代码GMT 001820126311生成会话密钥并用内部ECC公钥加密输出 原型：int SDF GenerateKeyWithIPK_ECC(void*hSessionHandle，unsigned int uiIPKIndex， unsigned int uiKeyBits， ECCCipherpueKey，void-：q+phKeyHandle)；描述：生成会话密钥并用指定索引的内部ECC加密公钥加密输出，同时返回密钥旬柄。 参数：hSessionHandlein 与设备建立的会话句柄uiIPKIndexin密码设备内部存储公钥的索引值uiKeyBitsin指定产生的会话密钥长度pueKeyout 缓冲区指针，用于存放返回的密钥密文phKeyHandle-out 返回的密钥句柄 返回值：0 成功非0 失败，返回错误代码6312生成会话密钥并用外部ECC公钥加密输出 原型：int SDF_GenerateKeyWkhEPK_ECC(void*hSessionHandle，unsigned int uiKeyBits， unsigned int uiAlgID， ECCrefPublicKey。pucPublicKey， ECATipher。pucKey，void*phKeyHandle)：描述：生成会话密钥并用外部B0c公钥加密输出，同时返回密钥句柄。 参数：hSessionHandlein 与设备建立的会话句柄uiKeyBitsin指定产生的会话密钥长度 uiAlgIDin外部ECC公钥的算法标识 pucPublicKeyin输入的外部Bcc公钥结构pueKeyout 缓冲区指针，用于存放返回的密钥密文phKeyHandleout 返回的密钥句柄 返回值：0成功非0 失败，返回错误代码6313导入会话密钥并用内部E0c私钥解密 原型：int SDF ImportKeyWithlSKECC(void*hSessionHandle， unsigned int uiISKIndex ECCCipher+pucKey， void*。phKeyHandle)：描述导入会话密钥并用内部ECC加密私钥解密，同时返回密钥句柄。 参数 hSessionHandlein与设备建立的会话句柄GMT 00182012 uiISKIndexin密码设备内部存储加密私钥的索引值，对应于加密时的公钥pucKeyin 缓冲区指针，用于存放输入的密钥密文phKeyHandleout 返回的密钥句柄 返回值：0 成功非0 失败，返回错误代码6314生成密钥协商参数并输出原型：int SDF_GenerateAgreementDataWithEcC(void*hSessionHandle， unsigned im uilSKIndex， unsigned int uiKeyBits，unsigned char。pueSponsorID，un