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

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