GM-T 0033-2023 時(shí)間戳接口規(guī)范

中華人民共和國密碼行業(yè)標(biāo)準(zhǔn)代替GM/T0033—2014Interfacespecificationsoftimestamp國家密碼管理局發(fā)布IGM/T0033—2023 Ⅲ 1 1 14縮略語 1 2 25.2密碼服務(wù)接口 2 2 36.1時(shí)間戳服務(wù)接口在公鑰密碼應(yīng)用技術(shù)體系框架中的位置 36.2時(shí)間戳服務(wù)接口的邏輯結(jié)構(gòu) 3 4 4 5 7 7 7 7 8 8 8 89.2初始化環(huán)境函數(shù) 99.3清除環(huán)境函數(shù) 99.4生成時(shí)間戳請(qǐng)求 99.5生成時(shí)間戳響應(yīng) 9.6獲取時(shí)間戳響應(yīng)的狀態(tài)信息 9.7驗(yàn)證時(shí)間戳有效性 9.8獲取時(shí)間戳主要信息 9.9解析時(shí)間戳詳細(xì)信息 附錄A(規(guī)范性)時(shí)間戳服務(wù)接口錯(cuò)誤代碼定義 附錄B(資料性)時(shí)間戳服務(wù)接口應(yīng)用示例 Ⅲ本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定RFC5035(見7.1)、RFC6211(見7.1),刪除了規(guī)范性引用文件GM/T0006(見2014年版的5.1)、RFC3066(見2014年版的7.2),將規(guī)范性引用文件GM/T0010更改為GB/T35275(見7.1,2014年版的7.2),將規(guī)范性引用文件RFC3369更改為GB/T31503(見7.2,2014年版的c)增加了縮略語“TSA”HTFPS(師第4d)更敢了圖1(見6.1,2011年版的6.1);e)更敢了時(shí)間戳請(qǐng)求格式中有關(guān)雜湊算法標(biāo)識(shí)的二義，增加了國間戳響應(yīng)中對(duì)算法保護(hù)域的要f)更政了8.4的名稱EEP方式"HTTTP方(見8.4,2014年版的8.4);以支持更多的時(shí)間微清求的底性了見于597,2011年酸的9.6)——2014年首次發(fā)布為GM/T0033—2014;時(shí)間戳接口規(guī)范1范圍本文件規(guī)定了時(shí)間戳服務(wù)接口的請(qǐng)求和響應(yīng)消息的格式、傳輸方式和時(shí)間戳服務(wù)接口函數(shù)。本文件適用于基于公鑰密碼應(yīng)用技術(shù)體系框架內(nèi)的時(shí)間戳服務(wù)相關(guān)產(chǎn)品的研制。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T20520信息安全技術(shù)公鑰基礎(chǔ)設(shè)施時(shí)間戳規(guī)范信息安全技術(shù)電子文檔加密與簽名消息語法信息安全技術(shù)SM2-密碼第法那密簽省消息語決規(guī)范通用密碼服務(wù)腰自規(guī)密碼模塊安全技術(shù)要求SM9密碼算法加密簽名消法規(guī)范EQ\*jc3\*hps20\o\al(\s\up7(密碼),erne)500公基礎(chǔ)設(shè)施間戳議(Tsptaon509PblickeyInfra-(ESS)UpdateAddongCerDNgotithmAgidiyRFC6211加密消息語法(CMS)算法標(biāo)識(shí)符保護(hù)屬性[CryptographicMessageSyntax(CMS)AlgorithmIdentifferProtectionAttrib3術(shù)語和定義GM/Z4001界定的以及下列術(shù)語和定義適用于本文件。時(shí)間戳服務(wù)timestampservice時(shí)間戳系統(tǒng)給用戶提供的頒發(fā)時(shí)間戳的服務(wù)。4縮略語下列縮略語適用于本文件。DER可區(qū)分編碼規(guī)則(DistinguishedEncodingRules)HTTP超文本傳輸協(xié)議(HyperTextTransferProtocol)HTTPS基于安全套接層的超文本傳輸協(xié)議(HyperTextTransferProtocoloverSecureSockets工2TSA時(shí)間戳機(jī)構(gòu)(TimeStampAuthority)說明簽發(fā)時(shí)間簽發(fā)者的通用名時(shí)間戳服務(wù)器的證書時(shí)間戳服務(wù)器的證書鏈時(shí)間源的來源時(shí)間精度響應(yīng)方式STF_SUBJECT_COUNTRY_OSTF_SUBJECT_ORGANIZATION_OSTF_SUBJECT_EMAIL_O隨機(jī)數(shù)時(shí)間戳請(qǐng)求/響應(yīng)中的擴(kuò)展域時(shí)間戳服務(wù)器證書序列號(hào)為其他標(biāo)識(shí)保留3應(yīng)用1～應(yīng)用應(yīng)用1～應(yīng)用N時(shí)間戳服務(wù)密碼資源管理(云環(huán)境)電子簽章4應(yīng)用1～應(yīng)用應(yīng)用1～應(yīng)用N應(yīng)用層環(huán)境函數(shù)時(shí)間戳服務(wù)函數(shù)TimeStampReq::=SEQUENCE{messageImprintMessageImprint,reqPolicyTSAPolicyIdnonceINTEGERcertReqBOOLEANDEFAULTFALSE,extensionshashAlgorithmAlgorithmIdentifier,在hashAlgorithm域中表示的算法應(yīng)使用GM/T0028中的算法，并在返回消息中設(shè)置reqPolicy的類型是TSAPolicyId,TSAPolicyId按照RFC3161中的定義。書。SignerInfo及Attribute結(jié)構(gòu)按照GB/T35275中的定義tribute結(jié)構(gòu)，其值類型為CMSAlgorithmProtection,CMSAlgorithmProtection按照RFC5RFC5035中的定義。TSA的公鑰簽名證書存放在響應(yīng)消息中SignedData部分的timeStampTokenTimeStampTokenPKIStatusInfo::=SEQUENCE{}(0),—申請(qǐng)使用了不支持的算法(2),—非法的申請(qǐng)6(25)—系統(tǒng)內(nèi)部錯(cuò)誤}TimeStampToken是一個(gè)ContentInfo●該時(shí)間戳的使用條件；——messageImprint應(yīng)同TimeStampReq中類似的域有相同的值，前提是雜湊值的長度與——serialNumber域是TSA分配的一個(gè)整數(shù)。一個(gè)特定的TSA發(fā)出的 —genTime是TSA創(chuàng)建時(shí)間戳的時(shí)間。應(yīng)用UTC時(shí)間表示，以減少使用本地時(shí)區(qū)造成的7 accuracy表示時(shí)間可能出現(xiàn)的最大誤差，genTime加上accuracy的值，可以求得TSA創(chuàng)建這}如果seconds、millis或者micros未出現(xiàn)，則未出現(xiàn)域的值應(yīng)被賦為0。當(dāng)accuracy這個(gè)可選 ordering表示時(shí)間戳排序條件。若ordering域不出現(xiàn)，或者ordering域出現(xiàn)但被置為false,則genTime域只表示TSA創(chuàng)建時(shí)間戳響時(shí)間。在這種情況下，當(dāng)兩個(gè)時(shí)間戳中第一個(gè)的genTime與第二個(gè)的genTime之差大于這兩個(gè)genTime的精確度的和，同一個(gè)TSA或者不同的TSA簽發(fā)的時(shí)間戳標(biāo)志才有可能排序。如果ordering域出現(xiàn)并被置為true,同一個(gè)TSA發(fā)的每一個(gè)時(shí)間戳都可以依據(jù)genTime排序，而不必考慮genTime精確度。 once域若在VimeStampReg中出現(xiàn)，則此處也應(yīng)出現(xiàn)，其值應(yīng)等于TimeStampReq中的值。 tsa域是為鑒別TSA名字提供的個(gè)線索，薦出現(xiàn)應(yīng)與驗(yàn)證時(shí)間戳的證書里的subjectnames中的一個(gè)相同 以由組織或者團(tuán)體自行定義序聲明注冊(cè)8時(shí)間戳服務(wù)接口的通信方式及格式8.1電子郵件方式采用電子郵件方式時(shí)，用聲健用地子郵作而一企5A習(xí)指的重子酈件地理發(fā)送時(shí)間戳申請(qǐng)，TSA將頒發(fā)的時(shí)間戳通過電子郵件返回給用戶。申請(qǐng)與頒發(fā)應(yīng)使用以下MIME對(duì)象。a)申請(qǐng)消息Content-Typeoapplication/timContent-TransferEncodimg:base64b)響應(yīng)消息Content-Type:application/Content-Transfer-Enco8.2文件方式采用文件方式時(shí)，用戶將申請(qǐng)消息存儲(chǔ)在一個(gè)擴(kuò)展名為.tsq的文件中傳送給TSA,TSA將產(chǎn)生的響應(yīng)消息保存在一個(gè)擴(kuò)展名為.tsr的文件中返回給用戶。請(qǐng)求文件和響應(yīng)文件應(yīng)只包含消息的DER編碼。采用Socket方式時(shí)，用戶與TSA應(yīng)通過安全的socket傳輸申請(qǐng)消息和響應(yīng)消息。通信的消息格式應(yīng)符合RFC31613.3中的格式和定義。8Content-Type:application/tContent-Type:application/t9返回值：STF_TS_OK:成功返回值：STF_TS_OK:成功原型：SGD_UINT32STF_CreateTSRequest(void*uiHashAlgID[IN]:密碼uiNonceLength[IN]:隨機(jī)數(shù)Nonce的長度pucTSRequest[OUT]:時(shí)間戳請(qǐng)求備注：uiReqType:0代表時(shí)間戳響應(yīng)應(yīng)包含時(shí)間戳服務(wù)器的證書，1代表時(shí)間戳響應(yīng)不包含時(shí)間戳服務(wù)器的證書。pucNonce:在時(shí)間戳請(qǐng)求TimeStampReq中Nonce是可選的，當(dāng)時(shí)間戳請(qǐng)求中不包含Nonce時(shí)，該變量取值為空指針NULL,uiNonceLength取值為0。pucReqPolicy:在時(shí)間戳請(qǐng)求TimeStampReq中reqPolicy是可選的，當(dāng)時(shí)間戳請(qǐng)求中不包含reqPolicy時(shí)，該變量取值為空指針NULL,uiReqPolicyLength取值為0。puiTSRequestlength[IN/OUT].人口值為指定的用于存放時(shí)間戳請(qǐng)求的字符數(shù)組的最大長度，出口值為時(shí)間戳請(qǐng)求的實(shí)際長度。9.5生成時(shí)間戳響應(yīng)原型：SGD_UINT32STF_CreateTSResponse(void*5GDumNE8puEGD_UI的T32SeriSGDpucTSRespons描述：根據(jù)時(shí)間戳請(qǐng)求包生成時(shí)間戳響應(yīng)包參數(shù)：hTSHandle[IN]:時(shí)間戳環(huán)境句柄uiTSRequestLength[IN]:時(shí)間戳請(qǐng)求的長度pucSeraINumber[IN]:TSA為生成的時(shí)間戳響應(yīng)分配的序列號(hào)uiSerialNurmberLengthJIN]:TSA為生成的助間戳響應(yīng)分配的序列號(hào)的長度uiSignatureAlgIDFIN]:簽名算法標(biāo)識(shí)pucTSCert[IN]:TSA的簽名證書uiTSCertLength[IN]:TSA簽名證書的長度pucTSResponse[OUT]:時(shí)間戳響應(yīng)puiTSResponseLength[IN/OUT]:時(shí)間戳響應(yīng)的長度返回值：STF_TS_OK:成功備注：pucTSCert:表示TSA的簽名證書，DER編碼格式。在時(shí)間戳請(qǐng)求中可能會(huì)要求TSA在響應(yīng)中包含TSA的簽名證書，此外在計(jì)算時(shí)間戳響應(yīng)中包含的ESSCertIDv2時(shí)，也要用到TSA的證書。puiTSResponseLength[IN/OUT]:入口值為指定的用于存放時(shí)間戳的字符數(shù)組的最大長度，出口值為時(shí)間戳的實(shí)際長度。原型：SGD_UINT32STF_GetTSStatus(void*hTSHan返回值：STF_TS_OK:成功返回值：STF_TS_OK:成功備注：該函數(shù)驗(yàn)證時(shí)間戳響應(yīng)是否有效。調(diào)用本函數(shù)的前提是時(shí)間戳響應(yīng)中包含TimeS-原型：返回值：STF_TS_OK:成功SGD_UINT32(規(guī)范性)表A.1給出了時(shí)間戳服務(wù)接口錯(cuò)誤代碼定義。說明正常返回輸入的用戶信息超出規(guī)定范圍分配給tsrequest的內(nèi)存空間不夠時(shí)間戳格式錯(cuò)誤申請(qǐng)使用了不支持的算法非法的申請(qǐng)申請(qǐng)消息中包括了不支持的擴(kuò)展有不理解或不可用的附加信息系統(tǒng)內(nèi)部錯(cuò)誤預(yù)留SGD_UINT8message[128]="hiShecaLcIl5uurgooddone";SGD_UINT8tsrequest[512SGD_UINT32tsrequestlength=5120,tsresponselength=5120,tsresponsestatus;retcode=STF_InitEnvironment*錯(cuò)誤處理*/}/*生成時(shí)間戳請(qǐng)求*/retcode=STF_CreateTSRequest(handele,message,strlen(message),1,NUSGD_SM3,"12345678",