GM/T 0018-2023密碼設備應用接口規(guī)范

ICS35030

CCSL.80

中華人民共和國密碼行業(yè)標準

GM/T0018—2023

代替GM/T0018—2012

密碼設備應用接口規(guī)范

Cryptographicdeviceapplicationinterfacespecification

2023-12-04發(fā)布2024-06-01實施

國家密碼管理局發(fā)布

GM/T0018—2023

目次

前言

…………………………Ⅲ

引言

…………………………Ⅳ

范圍

1………………………1

規(guī)范性引用文件

2…………………………1

術語和定義

3………………1

縮略語

4……………………1

算法標識和數據結構

5……………………2

算法標識定義

5.1………………………2

基本數據類型定義

5.2…………………2

設備信息定義

5.3………………………2

密鑰分類及存儲定義

5.4………………3

密鑰數據結構定義

5.5RSA……………4

密鑰數據結構定義

5.6ECC……………5

加密數據結構定義

5.7ECC……………5

簽名數據結構定義

5.8ECC……………6

密鑰對保護結構定義

5.9ECC…………6

設備接口描述

6……………7

密碼設備應用接口在公鑰密碼基礎設施應用技術體系框架中的位置

6.1…………7

設備管理類函數

6.2……………………8

密鑰管理類函數

6.3……………………11

非對稱算法運算類函數

6.4……………20

對稱算法運算類函數

6.5………………25

雜湊運算類函數

6.6……………………37

用戶文件操作類函數

6.7………………40

驗證調試類函數

6.8……………………42

附錄規(guī)范性函數返回代碼定義

A()……………………50

附錄規(guī)范性算法相關數據結構和接口函數

B()SM9…………………52

附錄規(guī)范性設備相關接口函數

C()VPN……………69

參考文獻

……………………79

Ⅰ

GM/T0018—2023

前言

本文件按照標準化工作導則第部分標準化文件的結構和起草規(guī)則的規(guī)定

GB/T1.1—2020《1:》

起草

。

本文件代替密碼設備應用接口規(guī)范與相比除結構調整

GM/T0018—2012《》,GM/T0018—2012,

和編輯性改動外主要技術變化如下

,:

更改了密鑰對保護結構見年版的

a)ECC(5.9,20125.8);

刪除了基于算法的數字信封轉換和基于算法的數字信封轉換兩個接口函數見

b)RSAECC(

年版的

20126.3.7、6.3.17);

增加了多包對稱加解密多包計算和單包可鑒別加解密多包可鑒別加解密相關的

c)、MAC、17

個接口函數見年版的

(6.5,20126.5);

增加了帶密鑰的雜湊運算相關的個接口函數見

d)3(6.6);

增加了驗證調試類函數見

e)(6.8);

刪除了第章安全要求見年版的第章

f)7“”(20127);

增加了用戶標識不匹配時的錯誤碼見附錄

g)(A);

增加了標識密碼算法相關數據結構以及標識密碼算法相關的個接口函數的定

h)SM9SM915

義見附錄

(B);

增加了計算工作密鑰計算會話密鑰計算工作密鑰共個接口函數的定義

i)IKE、IPSEC、SSL6

見附錄

(C)。

請注意本文件的某些內容可能涉及專利本文件的發(fā)布機構不承擔識別專利的責任

。。

本文件由密碼行業(yè)標準化技術委員會提出并歸口

。

本文件起草單位中電科網絡安全科技股份有限公司無錫江南信息安全工程技術中心四川大學

:、、、

北京國脈信安科技有限公司格爾軟件股份有限公司北京數字認證股份有限公司興唐通信科技有限

、、、

公司山東得安信息技術有限公司三未信安科技股份有限公司北京海泰方圓科技股份有限公司山東

、、、、

大學

。

本文件主要起草人劉平羅俊龔勛李川袁峰李元正徐強鄭強李述勝李玉峰孔凡玉

:、、、、、、、、、、、

馬洪富高志權徐明翼柳增壽蔣紅宇

、、、、。

Ⅲ

GM/T0018—2023

引言

本文件的目標是為公鑰密碼基礎設施應用體系框架下的服務端密碼設備制定統(tǒng)一的應用接口標

準通過該接口調用密碼設備向上層提供基礎密碼服務為該類密碼設備的開發(fā)使用及檢測提供標

,,。、

準依據和指導有利于提高該類密碼設備的產品化標準化和系列化水平

,、。

Ⅳ

GM/T0018—2023

密碼設備應用接口規(guī)范

1范圍

本文件規(guī)定了公鑰密碼基礎設施應用技術體系下服務端密碼設備應用接口的算法標識數據結構

、

和接口函數

。

本文件適用于服務端密碼設備的研制使用以及基于該類密碼設備的應用開發(fā)

、,。

2規(guī)范性引用文件

下列文件中的內容通過文中的規(guī)范性引用而構成本文件必不可少的條款其中注日期的引用文

。,

件僅該日期對應的版本適用于本文件不注日期的引用文件其最新版本包括所有的修改單適用于

,;,()

本文件

。

信息技術安全技術消息鑒別碼第部分采用專用雜湊函數的機制

GB/T15852.22:

信息安全技術密碼算法使用規(guī)范

GB/T35276SM2

信息技術安全技術可鑒別的加密機制

GB/T36624

所有部分信息安全技術標識密碼算法

GB/T38635()SM9

密碼應用標識規(guī)范

GM/T0006

技術規(guī)范

GM/T0022IPSecVPN