GM-T 0087-2020 清晰版 瀏覽器密碼應(yīng)用接口規(guī)范

ICS35.040CCSL80中華人民共和國(guó)密碼行業(yè)標(biāo)準(zhǔn)瀏覽器密碼應(yīng)用接口規(guī)范BAPI2020-12-28發(fā)布2021-07-01實(shí)施國(guó)家密碼管理局發(fā)布ⅠGM／T0087—2020 1范圍 2規(guī)范性引用文件 3術(shù)語(yǔ)、定義和縮略語(yǔ) 3.1術(shù)語(yǔ)和定義 4概述 5數(shù)據(jù)結(jié)構(gòu) 5.2密鑰對(duì)字典 6密碼接口 6.1接口定義 6.2加密方法 6.3解密方法 6.4簽名方法 6.5驗(yàn)證簽名方法 6.6雜湊方法 6.7生成密鑰方法 6.8派生密鑰方法 6.9派生比特方法 6.10導(dǎo)入密鑰方法 6.11導(dǎo)出密鑰方法 6.12封裝密鑰方法 6.13解封密鑰方法 7算法流程 7.2SM2加密算法 7.3SM2簽名算法 7.5SM4-ECB算法 ⅢGM／T0087—2020本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。本文件由密碼行業(yè)標(biāo)準(zhǔn)化技術(shù)委員會(huì)提出并歸口。本文件起草單位：北京海泰方圓科技股份有限公司、無(wú)錫江南信息安全工程技術(shù)中心、格爾軟件股份有限公司、成都衛(wèi)士通信息產(chǎn)業(yè)股份有限公司、吉大正元信息技術(shù)股份有限公司。本文件主要起草人：柳增壽、蔣紅宇、徐明翼、鄭強(qiáng)、羅俊、趙麗麗。1GM／T0087—2020瀏覽器密碼應(yīng)用接口規(guī)范驗(yàn)證和隨機(jī)數(shù)生成等操作。本文件定義的API適用于瀏覽器中用戶或服務(wù)的認(rèn)證、文檔或代碼的簽名、通信的機(jī)密性與完整性保證等。2規(guī)范性引用文件下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T32918（所有部分）信息安全技術(shù)SM2橢圓曲線公鑰密碼算法GB/T32905GB/T32907信息安全技術(shù)信息安全技術(shù)SM3密碼雜湊算法SM4分組密碼算法3術(shù)語(yǔ)、定義和縮略語(yǔ)下列術(shù)語(yǔ)和定義適用于本文件。字典一種使用鍵-值對(duì)作為元素的集合。3.1.2承諾異步功能。下列縮略語(yǔ)適用于本文件。2GM／T0087—2020密碼支撐。圖1密碼資源的層次關(guān)系5數(shù)據(jù)結(jié)構(gòu)IDL:取的數(shù)值應(yīng)有最小的類型化數(shù)組的長(zhǎng)度（即除了0之外，至多7個(gè)前導(dǎo)0比特）。API應(yīng)接受任意數(shù)目的前導(dǎo)0比特。5.2密鑰對(duì)字典IDL:{IDL:3GM／T0087—2020{dictionaryJsonWebKey{booleanext;瀏覽器密碼API應(yīng)用中進(jìn)行本地的高效調(diào)用。算法對(duì)象是一個(gè)網(wǎng)頁(yè)IDL字典對(duì)象，它用于為特定操作來(lái)指定算法和附加參數(shù)。IDL:IDL:{4GM／T0087—2020{密碼接口提供了通用密碼功能的接口，其中包含了一個(gè)使用真隨機(jī)值作為種子的密碼學(xué)強(qiáng)偽隨機(jī)數(shù)生成器。。IDL:行開(kāi)放。IDL:enumKeyUsage{CryptoKey{其中，5GM／T0087—2020的一部分而暴露。他們表示具體實(shí)現(xiàn)本規(guī)范時(shí)的內(nèi)部狀態(tài)。內(nèi)部組成通過(guò)雙方括號(hào)內(nèi)的名字進(jìn)行表述。-6密碼接口IDL：sc｛6GM／T0087—2020“raw”非格式化字節(jié)序列。用于秘密密鑰。符合RFC5280格式的私鑰信息格式的DER編碼。出InvalidAccessError;鑰和明文；密文進(jìn)行解密。它應(yīng)執(zhí)行下列步驟：出InvalidAccessError;7GM／T0087—2020據(jù)進(jìn)行簽名。它應(yīng)遵循下列步驟：出InvalidAccessError;k)將Promise對(duì)象返回。6.5驗(yàn)證簽名方法對(duì)數(shù)據(jù)進(jìn)行驗(yàn)簽。它應(yīng)遵循下列步驟：出InvalidAccessError;l)將result作為Promise對(duì)象返回。它應(yīng)遵循下列步驟：8GM／T0087—2020驗(yàn)簽操作；i)將result作為Promise對(duì)象返回。6.7生成密鑰方法ror;l)將result作為Promise對(duì)象返回。6.8派生密鑰方法Bits”;承諾返回錯(cuò)誤碼，則結(jié)束算法承諾，則結(jié)束算法；Error;9GM／T0087—2020性，拋出InvalidAccessError；ror；6.9派生比特方法deriveBits“deriveBits”；承諾返回錯(cuò)誤碼，則結(jié)束算法承諾，則結(jié)束算法；InvalidAccessError；6.10導(dǎo)入密鑰方法GM／T0087—2020承諾返回錯(cuò)誤碼，則結(jié)束算法承諾，則結(jié)束算法；l)將result作為Promise對(duì)象返回。承諾返回錯(cuò)誤碼，則結(jié)束算法；和格式來(lái)指定；h)將result作為Promise對(duì)象返回。6.12封裝密鑰方法承諾返回錯(cuò)誤碼，則結(jié)束算法；name屬性，拋出InvalidAccessError;GM／T0087—2020來(lái)確定；否則，否則：o)將result作為Promise對(duì)象返回。6.13解封密鑰方法絕承諾返回錯(cuò)誤碼，則結(jié)束算法；name屬性，則拋出InvalidAccessError;ror;GM／T0087—2020否則，否則：指定；s)將result作為Promise對(duì)象返回。所示。表1預(yù)定義的異常類型消息NotSupportedError算法不支持SyntaxError缺失所需參數(shù)或參數(shù)超出范圍InvalidStateError密鑰當(dāng)前狀態(tài)下不支持請(qǐng)求的操作InvalidAccessError提供的密鑰不支持請(qǐng)求的操作UnknownError未知原因?qū)е碌牟僮魇。ɡ鐑?nèi)存溢出）DataError提供給操作的數(shù)據(jù)不符合要求操作失敗7算法流程。GM／T0087—20207.2SM2加密算法生成密鑰內(nèi)容如下。派生密鑰內(nèi)容如下。的name屬性，拋出InvalidAccessError異常。h）返回result。導(dǎo)入密鑰內(nèi)容如下。GM／T0087—2020DataError異常。（非壓縮的點(diǎn)格式必須要支持）。DataError“SM2”,拋出DataError異常。拋出DataError異常。DataError轉(zhuǎn)換步驟中確定的橢圓曲線的私鑰。DataError異常。GM／T0087—2020●否則：e)如果format是“raw”:導(dǎo)出密鑰內(nèi)容如下。GM／T0087—2020設(shè)置version域?yàn)?。f)如果format是“raw”:格式。h)返回result。7.3SM2簽名算法簽名內(nèi)容如下。frSM2GM／T0087—2020rnresult驗(yàn)簽內(nèi)容如下。生成密鑰內(nèi)容如下。的公鑰。對(duì)的私鑰。。導(dǎo)入密鑰內(nèi)容如下。GM／T0087—2020DataError異常。（非壓縮的點(diǎn)格式必須要支持）。DataError“SM2”,拋出DataError異常。DataError轉(zhuǎn)換步驟中確定的橢圓曲線的私鑰。DataError異常。GM／T0087—2020●否則：e)如果format是“raw”:導(dǎo)出密鑰內(nèi)容如下。設(shè)置version域?yàn)?。GM／T0087—2020f)如果format是“raw”:非壓縮格式。h)返回result?！癝M4-CBC”算法標(biāo)識(shí)符用來(lái)使用GB/T32907規(guī)范的SM4以CBC模式進(jìn)行加密和解密操作，當(dāng)在CBC模式執(zhí)行時(shí)，不是塊大小(128字節(jié)）的整數(shù)倍的消息可以進(jìn)行填充，在密碼應(yīng)用接口中，填充方加密內(nèi)容如下。解密內(nèi)容如下。GM／T0087—2020生成密鑰內(nèi)容如下。taxError。導(dǎo)入密鑰內(nèi)容如下。b)如果format是“raw”:●如果data的比特長(zhǎng)度不是128,拋出DataError異常?！穹駝t拋出DataError異常。GM／T0087—2020導(dǎo)出密鑰內(nèi)容如下。異常。b)如果format是“raw”:●否則拋出DataError異常。根據(jù)JSONWEBALGORITHM的6.4進(jìn)行編碼。e)返回result。7.5SM4-ECB算法 “SM4-ECB”算法標(biāo)識(shí)符用來(lái)使用GB/T32907規(guī)范的SM4以ECB模式進(jìn)行加密和解密操作，當(dāng)在ECB模式執(zhí)行時(shí)，不是塊大小(128字節(jié)）的整數(shù)倍的消息可以進(jìn)行填充，在密碼應(yīng)用接口中，填充方加密內(nèi)容如下。作為輸入明文。解密內(nèi)容如下。GM／T0087—2020生成密鑰內(nèi)容如下。taxError。導(dǎo)入密鑰內(nèi)容如下。b)如果format是“raw”:●如果data的比特長(zhǎng)度不是128,拋出DataError異常。●否則拋出DataError異常。GM／T0087—2020導(dǎo)出密鑰內(nèi)容如下。b)如果format是“raw”:●否則拋出DataError異常。根據(jù)JSONWEBALGORITHM的6.4進(jìn)行編碼。e)返回result?！?中華人民共和國(guó)密碼行業(yè)標(biāo)準(zhǔn)瀏覽器密碼應(yīng)用接口規(guī)范GM/T0087—2020*中國(guó)標(biāo)準(zhǔn)出版社出版發(fā)行北京市朝陽(yáng)區(qū)