T_HBCCIA 0002-2023 湖北省重要网络和信息系统 密码应用接口规范.docx

ICS35.040L80

备案号：T/HBCCIA

湖北省商用密码协会团体标准T/HBCCIA0002—2023

湖北省重要网络和信息系统密码应用接口规范

CryptographicapplicationinterfacespecificationforcriticalnetworksandinformationsystemsinHubeiProvince

2023-12-27发布2023-12-27实施

湖北省商用密码协会发布

I

T/HBCCIA0002—2023

目次

前言 III

引言 IV

1范围 1

2规范性引用文件 1

3术语和定义 2

4缩略语 2

5接口概述 3

6密码应用接口规范 3

6.1HTTP接口规范 3

6.2C接口规范 31

6.3JAVA接口规范 43

6.4JavaScript接口规范 53

6.5Objective-C接口规范 60

附录A（资料性附录）湖北省重要网络和信息系统密码应用技术指南应用和数据安全接口调用示例 73

A．1指南一接口调用示例 73

A．2指南二接口调用示例 74

A．3指南三接口调用示例 76

A．4指南四接口调用示例 79

A．5指南五接口调用示例 80

A．6指南六接口调用示例 81

A．7指南七接口调用示例 82

A．8指南八接口调用示例 84

A．9指南九接口调用示例 84

附录B（规范性）HTTP接口响应状态码 97

III

T/HBCCIA0002—2023

T/HBCCIA0002—2023

前言

本文件按照GB/T1.1-2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由湖北省商用密码协会提出并归口。

本文件起草单位：湖北省密码管理局、武汉信安珞珈科技有限公司、武汉大学、华中科技大学、武汉思为同飞网络技术股份有限公司、湖北东方网盾信息安全技术有限公司。

本文件起草人：胡进、闵国华、陈辉、李涛、曾军林、何德彪、彭聪、徐鹏、王婧、梅松、钟骁、李荣。

IV

T/HBCCIA0002—2023

引言

本文件是在《湖北省重要网络和信息系统密码应用技术指南》的基础上，依托于密码模块、密码设备、密码系统、密码服务平台等典型密码服务层相关标准规范，向上为应用层规定了统一的密码应用接口。

本文件密码应用接口将密码模块、密码设备、密码系统、密码服务平台等各类密码产品或标准或非标的密码服务接口转换成统一的密码服务接口，通过统一的密码服务接口向上为应用系统提供各类密码服务。

本文件旨在推动密码在重要信息系统的合规、正确、有效应用。本文件适用于重要信息系统规划、建设、运行各个阶段，为重要信息系统的规划设计、建设实施和运行维护过程中合规、正确、有效的应用密码技术，保障重要信息系统安全提供指导。

1

T/HBCCIA0002—2023

湖北省重要网络和信息系统密码应用接口规范

1范围

本文件规定了密码模块、密码设备、密码系统、密码服务平台等密码产品到上层应用之间的接口。本文件适用于密码产品多场景、多开发语言对外提供的密码服务，也适用于密码产品的开发和使用。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件，凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GM/Z4001密码术语

GB/T15852信息技术安全技术消息鉴别码

GB/T25069信息安全技术术语

GB/T37092信息安全技术密码模块安全要求

GB/T32918信息安全技术SM2椭圆曲线公钥密码算法

GB/T35276信息安全技术SM2密码算法使用规范

GB/T32905信息安全技术SM3密码杂凑算法

GB/T32907信息安全技术SM4分组密码算法

GB/T38636信息安全技术传输层密码协议(TLCP)

GB/T39786信息安全技术信息系统密码应用基本要求

GM/T000