犐犆犛３５．０４０ 犆犆犛犔８０ 中华人民共和国密码行业标准 犌犕／犜００８８—２０２０ 云服务器密码机管理接口规范 犆犾狅狌犱犮狉狔狆狋狅犵狉犪狆犺犻犮狊犲狉狏犲狉犿犪狀犪犵犲犿犲狀狋犻狀狋犲狉犳犪犮犲狊狆犲犮犻犳犻犮犪狋犻狅狀 ２０２０１２２８ 发布 ２０２１０７０１ 实施 国家密码管理局 发 布 犌犕／犜００８８—２０２０ 目 　　 次 前言 ………………………………………………………………………………………………………… Ⅲ １　 范围 ……………………………………………………………………………………………………… １ ２　 规范性引用文件 ………………………………………………………………………………………… １ ３　 术语和定义 ……………………………………………………………………………………………… １ ４　 缩略语 …………………………………………………………………………………………………… ２ ５　 系统结构和接口位置 …………………………………………………………………………………… ２ ６　 通讯协议和数据结构 …………………………………………………………………………………… ３ 　６．１　 通讯协议 …………………………………………………………………………………………… ３ 　６．２　 请求方法和 ＵＲＬ 规则 ……………………………………………………………………………… ３ 　６．３　 授权类别 …………………………………………………………………………………………… ３ 　６．４　 认证信息 …………………………………………………………………………………………… ３ 　６．５　 状态信息 …………………………………………………………………………………………… ３ 　６．６　 回调数据 …………………………………………………………………………………………… ３ 　６．７　 运行状态 …………………………………………………………………………………………… ４ ７　 管理接口描述 …………………………………………………………………………………………… ４ 　７．１　 接口列表 …………………………………………………………………………………………… ４ 　７．２　ＣＨＳＭ 配置管理类接口 …………………………………………………………………………… ５ 　　７．２．１　 获取 ＣＨＳＭ 详细信息 ………………………………………………………………………… ５ 　　７．２．２　 获取 ＣＨＳＭ 运行状态 ………………………………………………………………………… ６ 　　７．２．３　 获取 ＣＨＳＭ 所有状态信息 …………………………………………………………………… ７ 　　７．２．４　 配置 ＣＨＳＭ 网络信息 ………………………………………………………………………… ８ 　　７．２．５　 配置 ＣＨＳＭ 的 ＮＴＰ 服务 …………………………………………………………………… ８ 　　７．２．６　 配置 ＣＨＳＭ 的影像上传地址 ………………………………………………………………… ９ 　　７．２．７　 配置 ＣＨＳＭ 的日志上传地址 ………………………………………………………………… ９ 　　７．２．８　 导出 ＣＨＳＭ 影像 …………………………………………………………………………… １０ 　　７．２．９　 导入 ＣＨＳＭ 影像 …………………………………………………………………………… １１ 　　７．２．１０　 升级 ＣＨＳＭ ………………………………………………………………………………… １１ 　　７．２．１１　 重启 ＣＨＳＭ ………………………………………………………………………………… １２ 　　７．２．１２　 备份 ＣＨＳＭ ………………………………………………………………………………… １２ 　　７．２．１３　 恢复 ＣＨＳＭ ………………………………………………………………………………… １３ 　７．３　ＶＳＭ 配置管理类接口 …………………………………………………………………………… １４ 　　７．３．１　 获取 ＶＳＭ 详细信息 ………………………………………………………………………… １４ 　　７．３．２　 获取 ＶＳＭ 运行状态 ………………………………………………………………………… １５ 　　７．３．３　 配置 ＶＳＭ 网络信息 ………………………………………………………………………… １５ 　　７．３．４　 配置 ＶＳＭ Ｔｏｋｅｎ 信息 ……………………………………………………………………… １６ 　　７．３．５　 导出 ＶＳＭ 影像 ……………………………………………………………………………… １６ 　　７．３．６　 导入 ＶＳＭ 影像 ……………………………………………………………………………… １７ Ⅰ 犌犕／犜００８８—２０２０ 　　７．３．７　 启动 ＶＳＭ …………………………………………………………………………………… １７ 　　７．３．８　 停止 ＶＳＭ …………………………………………………………………………………… １８ 　　７．３．９　 重启 ＶＳＭ …………………………………………………………………………………… １８ 　　７．３．１０　 重置 ＶＳＭ …………………………………………………………………………………… １９ 　　７．３．１１　 升级 ＶＳＭ …………………………………………………………………………………… １９ 　　７．３．１２　 创建 ＶＳＭ …………………………………………………………………………………… ２０ 　　７．３．１３　 删除 ＶＳＭ …………………………………………………………………………………… ２１ 　７．４　 授权配置类接口 …………………………………………………………………………………… ２１ 　　７．４．１　 获取 ＣＨＳＭ 云平台公钥的指纹 …………………………………………………………… ２１ 　　７．４．２　 配置 ＣＨＳＭ 的云平台公钥 ………………………………………………………………… ２２ 附录 Ａ （规范性）　 接口返回状态码定义和说明 ………………………………………………………… ２３ 参考文献 …………………………………………………………………………………………………… ２４ Ⅱ 犌犕／犜００８８—２０２０ 前 　　 言 　　 本文件按照 ＧＢ／Ｔ１．１—２０２０《标准化工作导则 　 第 １ 部分 ：标准化文件的结构和起草规则》的规定 起草 。 请注意本文件的某些内容可能涉及专利 。 本文件的发布机构不承担识别专利的责任 。 本文件由密码行业标准化技术委员会提出并归口 。 本文件起草单位 ：北京江南天安科技有限公司 、阿里云计算有限公司 、北京三未信安科技发展有限 公司 、新飞凡（上海）云计算服务有限公司 、无锡江南信息安全工程技术中心 、成都卫士通信息产业股份 有限公司 、兴唐通信科技有限公司 、中国科学院数据与通信研究教育保护中心 。 本文件主要起草人：李国、胡杰、马晓艳、张钊、苏建东、杨李贝、高志权、吕鹂啸、罗俊、吴庆国、徐明翼、 张超 、梁乐 、王伟 、曹硕 。 Ⅲ 犌犕／犜００８８—２０２０ 云服务器密码机管理接口规范 １　 范围 本文件规定了云平台管理系统与云服务器密码机之间的设备管理接口和协议 。 本文件适用于云服务器密码机的研制和检测 ，也适用于云平台管理系统的开发和使用 。 ２　 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款 。 其中 ，注日期的引用文 件 ，仅该日期对应的版本适用于本文件 ；不注日期的引用文件 ，其最新版本 （包括所有的修改单 ）适用于 本文件 。 ＧＢ／Ｔ３２９０５　 信息安全技术 　ＳＭ３ 密码杂凑算法 ＧＢ／Ｔ３２９０７　 信息安全技术 　ＳＭ４ 分组密码算法 ＧＢ／Ｔ３２９１８（所有部分）　 信息安全技术 　ＳＭ２ 椭圆曲线公钥密码算法 ＧＢ／Ｔ３５２７６　 信息安全技术 　ＳＭ２ 密码算法使用规范 ３　 术语和定义 下列术语和定义适用于本文件 。 ３．１ 云服务器密码机 　犮犾狅狌犱犺狅狊狋犲犱犺犪狉犱狑犪狉犲狊犲犮狌狉犻狋狔犿狅犱狌犾犲（犆犎犛犕）；犮犾狅狌犱犮狉狔狆狋狅犵狉犪狆犺犻犮狊犲狉狏犲狉 在云计算环境下 ，采用虚拟化技术 ，以网络形式 ，为多个租户的应用系统提供密码服务的密码设备 。 ３．２ 虚拟密码机 　狏犻狉狋狌犪犾狊犲犮狌狉犻狋狔犿狅犱狌犾犲（犞犛犕）；狏犻狉狋狌犪犾犮狉狔狆狋狅犵狉犪狆犺犻犮狊犲狉狏犲狉 云服务器密码机上 ，采用虚拟化技术创建出来的提供类同实体密码机服务的密码服务实例 。 ３．３ 犆犎犛犕 数据影像 　犆犎犛犕犱犪狋犪犻犿犪犵犲 简称 ＣＨＳＭ 影像 。 包含 ＣＨＳＭ 内所有 ＶＳＭ 中的与用户相关的配置 、密钥及敏感信息等 ，并使用加密和签名机制保 护影像的安全性 。 用于 ＣＨＳＭ 的漂移过程 。 ３．４ 犞犛犕 数据影像 　犞犛犕犱犪狋犪犻犿犪犵犲 简称 ＶＳＭ 影像 。 包含 ＶＳＭ 内与用户相关的配置 、密钥及敏感信息等 ，并使用加密和签名机制保护影像的安全性 。 用于 ＶＳＭ 的漂移过程 。 ３．５ 犞犛犕 漂移 　犞犛犕犱狉犻犳狋 当一台 ＶＳＭ 发生故障时 ，云平台管理系统自动将此 ＶＳＭ 的数据影像导入至另外一台空闲正常的 １ 犌犕／犜００８８—２０２０ ＶＳＭ 上 ，并快速切换用户网络 。 在用户无感知的情况下 ，恢复 ＶＳＭ 的可用性 。 ３．６ 云平台公钥 　犪狌狋犺犲狀狋犻犮犪狋犻狅狀狆狌犫犾犻犮犽犲狔 用于鉴别云平台管理系统的身份 ，验证管理报文的合法性 。 ３．７ 公钥指纹 　狆狌犫犾犻犮犽犲狔犳犻狀犵犲狉狆狉犻狀狋 对公钥进行杂凑运算（ＳＭ３ 算法）的结果 ，作为公钥指纹 。 ４　 缩略语 下列缩略语适用于本文件 。 ＡＰＩ：应用程序编程接口（ＡｐｐｌｉｃａｔｉｏｎＰｒｏｇｒａｍｍｉｎｇＩｎｔｅｒｆａｃｅ） ＣＨＳＭ：云服务器密码机（ＣｌｏｕｄｈｏｓｔｅｄＨａｒｄｗａｒｅＳｅｃｕｒｉｔｙ Ｍｏｄｕｌｅ） ＨＴＴＰ：超文本传输协议（ＨｙｐｅｒＴｅｘｔＴｒａｎｓｆｅｒＰｒｏｔｏｃｏｌ） ＨＴＴＰＳ：安全的 ＨＴＴＰ 协议（ＨｙｐｅｒＴｅｘｔＴｒａｎｓｆｅｒＰｒｏｔｏｃｏｌｏｖｅｒＳｅｃｕｒｅＳｏｃｋｅｔＬａｙｅｒ） ＪＳＯＮ：ＪＳ 对象标记（ＪａｖａＳｃｒｉｐｔＯｂｊｅｃｔＮｏｔａｔｉｏｎ） ＲＥＳＴｆｕｌ：表现层状态转移（ＲｅｐｒｅｓｅｎｔａｔｉｏｎａｌＳｔａｔｅＴｒａｎｓｆｅｒ） ＵＲＩ：统一资源标识符（