2025智能交通運輸系統(tǒng)車載安全密碼設備應用接口規(guī)范

前 GM/T0016-2012GB/T0018-2012arithmeticasymmetriccryptographicalgorithm/publickeycryptographicdevicekeykey-encrypting1071SM4ECBSM4CBCSM4CFBSM4OFB11（續(xù)SM4MACSM4CCMAESCCM312所示。2RSA0783SM3SHA1SHA256SHA38448163281632布爾類型，取值為TRUE8typedefUINT88typedefUINT816typedefINT1616typedefUINT1632typedefINT3232typedefUINT3232typedefUINT3216typedefUINT164（續(xù)4（2232typedefUINT3232typedefUINT328UTF8typedefCHAR*typedefvoid*typedefHANDLEtypedefHANDLEtypedefHANDLE885-15-2（擴展typedefstructSCHARucHwVersion[32];SCHARucFwVersion[32];SCHARucSwVersion[32];6以'\0'為結束符的ASCII以'\0'為結束符的ASCII以'\0'為結束符的ASCIItypedefstructSCHARscManufacturer[64];SCHARscIssuer[64];SCHARscLable[32];SCHARscSerialNumber[32]; 7BYTEtypedefUINT32u32BitLen; UINT328RSA8UCHARn實際長度為u32BitLen/8typedefUINT32u32BitLen; UCHARucPrime1ExPonent[128];UCHARucPrime2ExPonent[128];UCHARucCoefficient[128];9RSA8UCHAR實際長度為u32BitLen/8UCHAR實際長度為u32BitLen/16UCHARpcrt實際長度為u32BitLen/16UCHARqcrt實際長度為u32BitLen/16UCHARq實際長度為u32BitLen/16typedef 10ECCUCHARx#defineECC_XCOORDINATE_LENUCHARy#defineECC_YCOORDINATE_LENtypedef 11ECCUCHAR#defineECC_PRIVATE_KEY_LENtypedef 12ECCUCHARrUCHARscurve|EccPubKey||13ECCECC6432typedefstructBYTEr[ECC_MAX_XCOORDINATE_BITS_LEN/8];BYTE注：ECC_MAX_MODULUS_BITS_LENECC算法模數的最大長度13：14ECCBYTErBYTEstypedefITS_智能交通_CA=1,14智能交通CAIEEE1609.2或GB/T37376IEEE1609.2或GB/T37376SM2格式為x.509RSA格式為x.50915為容器索引定義表的示例。15（是否設置（是否設置CA（是否設置（是否設置函數原型INT32ITSGetDevState(UINT32*功能描述 [OUT]0-空閑；1-運算中；2-故障 函數原型INT32ITSGetDevInfo(DevInfo_t功能描述 [OUT]設備信息 函數原型INT32ITSDevAuth(UCHAR*pucAuthData,UINT32 [IN]認證數 [IN]認證數據的長度 函數原型INT32ITSChangeDevAuthKey(UCHAR*pucKeyValue,UINT32功能描述[IN][IN] 函數原型INT32ITSVerifyPin(SCHAR*pscPinUINT32u32PinLenUINT32功能描述校驗PINPINPIN碼的剩余重0PIN碼已經鎖死[INPIN[INPIN[OUT] 函數原型INT32ITSChangePin(UINT32u32OldPinLen,SCHAR*pscOldPin,UINT32u32NewPinLen,SCHAR*pscNewPin,UINT32*pu32RetryCount)PINPINPIN碼的剩余重試0PIN碼已經鎖死 [IN]舊PIN碼長度 [IN]舊PIN碼 [IN]新PIN碼長度 [IN]新PIN碼 [OUT] 函數原型 INT32ITSReloadPin(UINT32u32PinLen,SCHAR*pscPin,UINT32u32MasterKeyLen,UCHAR*pucMasterKey,UINT32*pu32RetryCount)功能描述當用戶PINPINPIN碼被設置成新值，PIN碼的重試次數也恢復到原值 [IN]新PIN碼長 [IN]新PIN碼u32MasterKeyLen[IN]密碼設備主控密鑰長度 [IN]密碼設備主控密鑰 [OUT]主控密鑰錯誤后返回的重試次數 函數原型 INT32ITSUpdateMasterKey(UINT32u32OldMasterKeyLen,UCHAR*pucOldMasterKey,UINT32u32NewMasterKeyLen,UCHAR*pucNewMasterKey)功能描述 u32OldMasterKeyLen[IN]舊的主控密鑰長度 [IN]舊的主控密鑰u32NewMasterKeyLen[IN]新的主控密鑰長度 [IN]新的主控密鑰 密碼設備初始主控密鑰為16字節(jié)全0，禁止主控密鑰以明文形式傳入密碼設備，可在接口函數原型 INT32ITSImportCert(UINT32u32Index,ITSCertType_eeCertType,UINT32 UCHAR*pucCert) [IN]容器索eCertType[IN]證書類型 [IN]證書長度 [IN]證書 函數原型INT32ITSExportCert(UINT32u32Index,ITSCertType_eeCertType,UCHAR*pucCertData,UINT32u32DataLenUINT32*pu32CertLen) [IN]容器索 [IN]pucCertData[OUT]存取證書的緩沖區(qū)指針 [IN]存取證書的緩沖區(qū)長度pu32CertLen[OUT]導出的證書長度指針 函數原型INT32ITSDeleteCert(UINT32u32IndexITSCertType_e[IN][IN]函數原型INT32ITSGetRandom(UINT32u32RandomLenUCHAR*功能描述 [IN]隨機數長 [OUT]返回的隨機數 函數原型INT32ITSGenerateEccKey(UINT32u32IndexUINT32功能描述生成ECC密鑰對，存儲在密碼設備內 [IN]密鑰對索引 [IN]算法標識，0-SM2；1-nistP256；2-brainpoolP256r1 函數原型INT32ITSExportEccKey(UINT32u32IndexUINT32u32AlgIdEccPubKey_t功能描述ECC[IN]][OUTECC INT32ITSEccPubKeyEncrypt(UINT32u32AlgId,EccPubKey_t*ptPubKeyUCHAR*pucData,UINT32u32DataLenUCHAR*pucDataOutputUINT32u32OutputLenUINT32*功能描述使用ECC [IN]算法標識，0-SM2；1-nistP256；2-brainpoolP256r1 [IN]ECC公鑰數據結構 [IN] [IN]輸入的待加密數據長度pucDataOutput[OUT]緩沖區(qū)指針，用于存放輸出的數據 [IN]緩沖區(qū)長度pu32OutDataLen[OUT]輸出的數據長度 INT32ITSEccPriKeyDecryptIndex(UINT32u32AlgId,UINT32u32Index,UCHAR*pucData, ECC [IN]ECC密鑰對索引 [IN]輸入的待解密數據 [IN]輸入的待解密數據長度pucDataOutput[OUT]緩沖區(qū)指針，用于存放輸出的數據 [IN]緩沖區(qū)長度pu32OutDataLen[OUT]輸出的數據長度 函數原型INT32ITSEccPriKeySignIndex(UINT32u32AlgId,UINT32u32Index,UCHAR*pucData,UINT32u32DataLen,EccSignature_t ECC [IN]算法標識，0-SM2；1-nistP256；2-brainpoolP256r1 [IN]ECC密鑰對索引 [IN]輸入的待簽名數據 [IN]輸入的待簽名的數據長度ptEccSignature[OUT]簽名值 函數原型INT32ITSEccPubKeyVerify(UINT32u32AlgId,EccPubKey_t*ptPubKey,UCHAR*pucData,UINT32u32DataLen,EccSignature_t 功能描述使用ECC [IN]算法標識，0-SM2；1-nistP256；2-brainpoolP256r1 [IN]ECC公鑰 [IN]輸入的待驗證數據 [IN]輸入的待驗證的數據長度ptEccSignature[IN]簽名值 uint32ImportSymmKey(uint32nAlg,uint32nKeyIndex,uint32nLock,uint32nKeyLen,uint8*szKey,uint8*szMac); [IN]導入密鑰算法:0-ALL;1-DES;2-AES;3- [IN] [IN]密鑰是否鎖定，不可修改:0-不鎖定;1-鎖定 [IN]密鑰的長度 [IN]KMC [IN]校驗值，使用KMC對密鑰信息計算的MAC值，4字節(jié) 0：成功 [IN]密鑰存儲的索引號 0：成功函數原型uint32ExportSymmKey(uint32nKeyIndex,uint32nKekIndex,uint32*nAlg,uint32*nKeyLen,uint8*szKey,uint8*szCV);功能描述 [IN]密鑰存儲的索引 [IN] [OUT]密鑰算法0-ALL1-DES2-AES3- [OUT] [OUT] [OUT]密鑰的校驗值 0：成功SM4ECB函數原型uint32SM4ECBIndex(uint32nMode,uint32nKeyIndex,uint32nDatalen,uint8*szData,uint32*nOutlen,uint8*szOutData);功能描述SM4使用內部密鑰,ECB [IN]運算模式：0-加密；1-解 [IN] [IN] [IN] [OUT] [OUT]運算結果 0：成功SM4CBC函數原型uint32SM4CBCIndex(uint32nMode,uint32nKeyIndexuint8*szIVuint32nDatalen,uint8*szData,uint32*nOutlen,uint8*szOutData);功能描述SM4CBC [IN]運算模式：0-加密；1-解 [IN] [IN] [IN] [IN] [OUT] [OUT]運算結果 0：成功SM4CCM函數原型uint32SM4CCMIndex(uint32nMode,uint32nKeyIndex,uint32nIVLen,uint8*szIV,uint32nDatalen,uint8*szData,uint32*pnOutlen,uint8*szOutData);功能描述SM4CCM [IN]運算模式：0-加密；1-解 [IN] [IN] [IN] [IN] [IN]nMode1，數據格式:密文||標簽(16字節(jié)) [OUT] [OUT]nMode0，數據格式:密文||標簽(16字節(jié)) 0：成15所示：15智能交通-SM2智能交通-SM2智能交通-SM2智能交通-SM2函數原型uint32ECertGenKeyIndex(uint32indexuint8alguint8*szX,uint8*功能描述智能交通終端證書密鑰對產生，密鑰對內部存儲 [IN]證書索引 [IN]算法0-SM21-nistP256;2-brainpoolP256r1nistP256brainpoolP256r1非必實現算法 [OUT]X32 [OUT]公鑰Y，定長32字節(jié) 0：成功函數原型uint32ECertSignIndex(uint32indexuint8*hashuint8*ruint8*功能描述 [IN]證書索 [IN]HASH32 [OUT]R32 [OUT]簽名S，定長32字節(jié) 0：成功函數原型uint32ECertSM2SignIndexWithIDA(uint32indexuint32lenuint8*data,uint8*x,uint8*y,uint8*r,uint8*s);功能描述使用終端私鑰簽名SM2算法，數據先執(zhí)行SM3-E哈希 [IN]證書索引 [IN] [IN] [IN] [IN] [OUT]R32 [OUT]簽名S，定長32字節(jié) 0：成功函數原型uint32智能交通ECertSM2SKDecryptIndex(uint32index,uint32nDatalen,uint8*szData,uint32*nOutlen,uint8*szOutData);功能描述智能交通-SM2 [OUT] [OUT]輸出數據 0：成功函數原型uint32GetPK(uint32indexuint8*szXuint8*功能描述智能交通- [IN]證書索 [OUT]X32 [OUT]公鑰Y，定長32字節(jié) 0：成功函數原型uint32ECertSignIndexExp(uint32indexuint8*hashuint8*expuint8*c,uint8*r,uint8*s);功能描述SM2HASHPrivatekeyaexpc [OUT]R32 [OUT]簽名S，定長32字節(jié) 0：成功函數原型uint32智能交通ECertSM2SignIndexExpWithIDA(uint32index,uint32len,uint8*data,uint8*x,uint8*y,uint8*exp,uint8*c,uint8*r,uint8*s);功能描述SM