DB11∕T 254.2-2018 政務(wù)數(shù)字證書(shū)規(guī)范 第2部分：應(yīng)用接口

DB11/T254.2第2部分：應(yīng)用接口Part2:ApplicationProgrammin北京市質(zhì)量技術(shù)監(jiān)督局發(fā)布I III 12規(guī)范性引用文件 13術(shù)語(yǔ)和定義、縮略語(yǔ) 14結(jié)構(gòu)組成 25政務(wù)數(shù)字證書(shū)應(yīng)用接口定義 2附錄A(規(guī)范性附錄)政務(wù)數(shù)字證書(shū)應(yīng)用接口錯(cuò)誤代碼定義和說(shuō)明 附錄B(資料性附錄)政務(wù)數(shù)字證書(shū)典型調(diào)用示例 例(資料性附錄)”;Ⅲ1政務(wù)數(shù)字證書(shū)規(guī)范第2部分：應(yīng)用接口GB/T25069—2010信息安全技術(shù)術(shù)語(yǔ)CA證書(shū)認(rèn)證機(jī)構(gòu)(CertificationAuthority)CSP加密服務(wù)提供者(CryptographicServiceProvider)0ID對(duì)象標(biāo)識(shí)符(ObjectIdentifier)2密鑰密鑰密鑰3(:)來(lái)分隔功能描述：根據(jù)索引獲取設(shè)備的序列號(hào)功能描述：獲取設(shè)備詳細(xì)信息4DB11/T254.2—2018設(shè)備的VID_PID(16進(jìn)制數(shù)據(jù))5.3訪問(wèn)控制接口5.3.2設(shè)備登出參數(shù)：CertID[IN]證書(shū)參數(shù)：CertID[IN]證書(shū)操作唯一標(biāo)識(shí)<0表示獲取重試次數(shù)失敗備注：無(wú)5.3.4修改登錄口令5功能描述：修改證書(shū)口令參數(shù)：CertID[IN]證書(shū)操作唯一標(biāo)識(shí)OIdPassWd[IN]原始口令，646位可顯示字符NewPassWd[IN]新口令，6-46位可顯示字符返回值：成功返回TRUE,失敗返回FALSE備注：無(wú)5.4容器管理接口5.4.1獲取容器數(shù)量備注：無(wú)5.4.2獲取所有容器名稱接口原型：BSTRSOF_GetAIIContainerName(BSTRsDe功能描述：獲取所有容器名稱參數(shù)：sDeviceSN[IN]設(shè)備序列號(hào)返回值：成功返回所有容器名稱，失敗或設(shè)備內(nèi)不存在容器時(shí)返回空。返回格式為使用“&”符號(hào)分隔的容器名，即<容器名>&<容器名>&<容器名>...備注：無(wú)5.4.3刪除容器功能描述：刪除容器參數(shù)：sDeviceSN[IN]設(shè)備序列號(hào)sContainerName[IN]容器名稱5.5密碼服務(wù)接口5.5.1產(chǎn)生密鑰對(duì)功能描述：產(chǎn)生密鑰對(duì)參數(shù)：sDeviceSN[IN]6之間返回值：成功返回TRUE,失敗返回FALSE5.5.2導(dǎo)出公鑰接口原型：BSTRExportPubKey(BSTRs功能描述：導(dǎo)出公鑰sContainerName[IN]容器名稱5.5.3導(dǎo)出證書(shū)請(qǐng)求功能描述：導(dǎo)出證書(shū)請(qǐng)求sContainerName[IN]容器名稱sDN[IN]DN信息，如果D5.5.4導(dǎo)入簽名證書(shū)接口原型：booleanImportSi功能描述：導(dǎo)入簽名證書(shū)sContainerName[IN]容器名稱sCert[IN]Base64編碼的簽名證書(shū)返回值：成功返回TRUE,失敗返回FALSE備注：無(wú)接口原型：booleanImportEn功能描述：導(dǎo)入加密證書(shū)和加密密鑰對(duì)參數(shù)：sDeviceSN[IN]設(shè)備序列號(hào)sContainerName[IN]容器名稱7接口原型：BSTRSOF_EncryptData(BSTRCert,功能描述：產(chǎn)生數(shù)字信封接口原型：BSTRSOF_DecryptData(BSTRCertID,功能描述：解數(shù)字信封密8接口原型：BSTRSOF_SignMessage(shortdwFIag,BSTRCertID,BSTRInData)功能描述：對(duì)數(shù)據(jù)進(jìn)行數(shù)字簽名。功能描述：對(duì)數(shù)據(jù)進(jìn)行驗(yàn)證簽名。1:原文3:簽名值接口原型：BSTRSOF_PubKeyEncrypt(BSTRsCert,BSTRsIn功能描述：公鑰加密數(shù)據(jù)9sInData[IN]無(wú)5.5.15私鑰解密數(shù)據(jù)接口原型：BSTRSOF_PriKeyDecryp功能描述：私鑰解密數(shù)據(jù)參數(shù)：CertID[IN]證書(shū)操作唯sInData[IN]Base64編碼的密文數(shù)據(jù)返回值：正確返回明文數(shù)據(jù)，失敗返回空備注：無(wú)5.5.16對(duì)稱加密數(shù)據(jù)接口原型：BSTRSOF_SymEncry功能描述：對(duì)稱加密數(shù)據(jù)參數(shù)：sKey[IN]Base64編碼的對(duì)稱密鑰備注：無(wú)5.5.17對(duì)稱解密數(shù)據(jù)功能描述：對(duì)稱解密數(shù)據(jù)參數(shù)：sKey[IN]Base64編碼的對(duì)稱密鑰返回值：正確返回明文數(shù)據(jù)，失敗返回空備注：無(wú)5.5.18數(shù)據(jù)摘要功能描述：對(duì)數(shù)據(jù)做摘要返回值：正確返回Base64編碼的數(shù)據(jù)，失敗返回空5.6證書(shū)接口5.6.1獲取證書(shū)用戶列表接口原型：BSTRSOF_GetUserList()功能描述：獲取已安裝的證書(shū)用戶列表。參數(shù)：無(wú)備注：返回的證書(shū)用戶列表格式為：用戶名1||CertID1&&&用戶名2||CertID2&8&用戶名3||CertID3&8&...。CertID是證書(shū)操作唯一標(biāo)識(shí)，格式為容器名稱/設(shè)備序列號(hào)。通5.6.2導(dǎo)出用戶簽名證書(shū)5.6.3導(dǎo)出用戶加密證書(shū)接口原型：BSTRSOF_ExportExchangeUserC備注：無(wú)5.6.4驗(yàn)證證書(shū)有效性接口原型：LONGSOF_ValidateCert(BSTRBa功能描述：驗(yàn)證證書(shū)有效性參數(shù)：Base64Enco返回值：正確返回0失敗返回其他值如下：4證書(shū)不被信任2超過(guò)有效期范圍-3證書(shū)已作廢-4證書(shū)已凍結(jié)-5證書(shū)未生效備注：無(wú)功能描述：獲取證書(shū)基本信息參數(shù)：Cert[IN]Type[IN]信息類型4頒發(fā)者國(guó)家名(C)多個(gè)用逗號(hào)(,)分割11證書(shū)有效開(kāi)始日期格式12證書(shū)有效結(jié)束日期格式13使用者國(guó)家名(C)多個(gè)用逗號(hào)(,)分割14使用者組織名(0)多個(gè)用逗號(hào)(,)分割19使用者EMAIL(E)多個(gè)用逗號(hào)(,)分割20證書(shū)公鑰Base64編碼格式22使用者UID接口原型：BSTRSOF_GetCertInfoB功能描述：獲取證書(shū)的唯一實(shí)體標(biāo)識(shí)5.7通用接口接口原型：BSTRSOF_GetLastErrMsg()返回值：錯(cuò)誤描述信息錯(cuò)誤碼(十進(jìn)制)1設(shè)備序列錯(cuò)誤(索引值錯(cuò)誤)23456789導(dǎo)出公鑰失敗尚未登錄導(dǎo)入證書(shū)失敗寫(xiě)入ENVSN失敗錯(cuò)誤碼(十進(jìn)制)導(dǎo)出證書(shū)失敗導(dǎo)出PKCS10證書(shū)請(qǐng)求失敗寫(xiě)入文件失敗公鑰加密數(shù)據(jù)失敗保留不存在證書(shū)DB11/T254.(資料性附錄)政務(wù)數(shù)字證書(shū)典型調(diào)用示例下面的示例用JavaScript語(yǔ)言展示了產(chǎn)生隨機(jī)數(shù)的功能。在示例中，首先加載了一個(gè)命名為XTXApp的廠商自定義COM控件，調(diào)用控件的相應(yīng)接口，完成產(chǎn)生隨機(jī)數(shù)的功能。其它接口也可以遵照標(biāo)準(zhǔn)調(diào)用。document.writeIn("<0BJECTclassid="CLSID:3F367B74-92D9-4C5E-AB93-234F8A91D5E6”height=1id=XTXAPPstyle="HEIGHT:1px;LEFT:10px;TOP:28px;WIDTH:1pxdocument.writeIn("</0XTXAPP.SOF_GetVersioclsid={3F367B74-92D9-4C5E-AB93-234F8A91D5E6}event_OnUsbkeyChange=0nUsbKeyChangewidth=1height=1XTXAPP=document.getElementB}}alert("請(qǐng)檢查證書(shū)應(yīng)用環(huán)境是否正確安裝!");}{alert("OnUsbKeyChange}