犐犆犛３５． ０４０ 犔 ８０ 备案号： 中华人民共和国密码行业标准 犌犕／犜 ００１９—２０１２ 通用密码服务接口规范 犝狀 犻 狏 犲 狉 狊 犪 犾犮 狉 狋 狅 狉 犪狆犺狔狊 犲 狉 狏 犻 犮 犲犻 狀 狋 犲 狉 犳 犪 犮 犲狊 犮 犻 犳 犻 犮 犪 狋 犻 狅狀 狔狆 犵 狆犲 ２０１２  １１  ２２ 发布 ２０１２  １１  ２２ 实施 国家密码管理局 发 布 犌犕 犜００１９ ２０１２ — ／ 中 华 人 民 共 和 国 密 码 行 业 标 准 通用密码服务接口规范 ＧＭ／Ｔ００１９—２０１２  中国标准出版社出版发行 北京市朝阳区和平里西街甲 ２ 号（ １０００１３） 北京市西城区三里河北街 １６ 号（ １０００４５） 网址 ｗｗｗ． ｓｐｃ． ｎｅ ｔ． ｃｎ 总编室：（ ０１０） ６４２７５３２３　 发行中心：（ ０１０） ５１７８０２３５ 读者服务部：（ ０１０） ６８５２３９４６ 中国标准出版社秦皇岛印刷厂印刷 各地新华书店经销  开本 ８８０×１２３０ １／１６　 印张 ０． ００　 字数 ００ 千字 年 月第一版 年 ２０１２ 　 　２０１２ 　 月第一次印刷  书号：１５５０６６·２  ２４　 定价 ００． ００ 元 如有印装差错 　 由本社发行中心调换 版权专有 　 侵权必究 举报电话：（ ０１０） ６８５１０１０７ 犌犕／犜 ００１９—２０１２ 目 　　 次 前言 …………………………………………………………………………………………………………… 引言 …………………………………………………………………………………………………………… １　 范围………………………………………………………………………………………………………… ２　 规范性引用文件…………………………………………………………………………………………… ３　 术语和定义………………………………………………………………………………………………… ４　 符号和缩略语……………………………………………………………………………………………… ５　 算法标识和数据结构……………………………………………………………………………………… １　 算法标识与常量定义………………………………………………………………………………… 　５． ２　 密码服务接口数据结构定义和说明………………………………………………………………… 　５． ６　 密码服务接口……………………………………………………………………………………………… １　 通用密码服务接口在公钥密码基础设施应用技术体系框架中的位置…………………………… 　６． ２　 密码服务接口接口组成和功能说明………………………………………………………………… 　６． ７　 密码服务接口函数定义…………………………………………………………………………………… １　 环境类函数…………………………………………………………………………………………… 　７． ２　 证书类函数…………………………………………………………………………………………… 　７． ３　 密码运算类函数……………………………………………………………………………………… 　７． ４　 消息类函数…………………………………………………………………………………………… 　７． 附录 Ａ （规范性附录）　 密码服务接口错误代码定义 ……………………………………………………… 参考文献 ……………………………………………………………………………………………………… Ⅰ 犌犕／犜 ００１９—２０１２ 前 　　 言 １—２００９ 给出的规则起草。 　　 本标准依据 ＧＢ／Ｔ１． 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准中的附录 Ａ 为规范性附录。 本标准由国家密码管理局提出并归口。 本标准起草单位：北京数字认证股份有限公司、上海格 尔软 件 股 份 有 限 公 司、北 京 海 泰 方 圆 科 技 有 限公司、无锡江南信息安全工程技术中心、上海数字证书 认证中心 有限 公 司、卫 士 通 信 息 产 业 股 份 有 限 公司、济南得安计算机技术有限公司、国家信息安全工程技术研究中心。 本标准起草人：刘平、李述胜、谭武征、柳增寿、徐强、刘承、李元正、高志权、袁峰。 本标准凡涉及密码算法相关内容，按照国家有关法规实施。 Ⅱ 犌犕／犜 ００１９—２０１２ 引 　　 言 　　 本标准依托于密码设备层的 ＧＭ／ＴＢＢＢＢＢ《密码设备应用 接口规 范》和 ＧＭ／Ｔ ＣＣＣＣＣ《智 能密码 钥匙密码应用接口规范》，为典型密码服务层和应用层规定了统一的通用密码服务接口。 通用密码服务接口在公钥密码基础设施支撑的前提 下，向应用 系 统 和 典 型 密 码 服 务 层 提 供 各 类 通 用的密码服务，有利于密码服务接口产品的开发，有利于应 用系统 在密 码 服 务 过 程 中 的 集 成 和 实 施，有 利于实现各应用系统的互联互通。 Ⅲ 犌犕／犜 ００１９—２０１２ 通用密码服务接口规范 １　 范围 本标准规定了统一的通用密码服务接口。 本标准适用于公开密钥应用技术体系下密码应用服务的开发，密码应用支撑平台的研制及检测，也 可用于指导直接使用密码设备的应用系统的开发。 ２　 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日 期的 引 用 文 件，仅 注 日 期 的 版 本 适 用 于 本 文 件，凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 ＧＭ／Ｔ０００６　 密码应用标识规范 ＧＭ／Ｔ ＡＡＡＡＡ　 基于 ＳＭ２ 密码算法的数字证书格式规范 ＧＭ／ＴＢＢＢＢＢ　 密码设备应用接口规范 ＧＭ／Ｔ ＣＣＣＣＣ　 智能密码钥匙密码应用接口规范 ＧＭ／Ｔ ＤＤＤＤＤ　ＳＭ２ 密码算法加密签名消息语法规范 ＧＭ／Ｔ ＥＥＥＥＥ　ＳＭ２ 密码算法使用规范 ＰＫＣＳ ＃７： Ｃｒ ｔ ｏｇ ｒ ａｐｈ ｉ ｃＭｅ ｓ ｓ ａｇｅＳｙｎ ｔ ａｘ ｙｐ ３　 术语和定义 下列术语和定义适用于本文件。 ３． １ 数字证书 　犱 犻 犻 狋 犪 犾犮 犲 狉 狋 犻 犳 犻 犮 犪 狋 犲 犵 由认证权威数字签名的包含公开密钥拥有者信息、公开 密钥、签 发 者 信 息、有 效 期 以 及 一 些 扩 展 信 息的数字文件。 ３． ２ 用户密钥 　狌 狊 犲 狉犽犲 狔 存储在设备内部的用于应用密码运算的非对称密钥对，包含签名密钥对和加密密钥对。 ３． ３ 容器 　犮 狅狀 狋 犪 犻 狀犲 狉 密码设备中用于保存密钥所划分的唯一性存储空间。 ４　 符号和缩略语 下列缩略语适用于本文件： ＡＰＩ　　Ａｐｐ ｌ ｉ ｃ ａ ｔ ｉ ｏｎＰｒ ｏｇ ｒ ａｍＩ ｎ ｔ ｅ ｒ ｆ ａ ｃ ｅ应用程序接口，简称应用接口 ＣＡ Ｃｅ ｒ ｔ ｉ ｆ ｉ ｃ ａ ｔ ｉ ｏｎＡｕ ｔ ｈｏ ｒ ｉ ｔ ｙ 证书认证机构 ＣＮ ＣｏｍｍｏｎＮａｍｅ通用名 １ 犌犕／犜 ００１９—２０１２ ＣＲＬ Ｃｅ ｒ ｔ ｉ ｆ ｉ ｃ ａ ｔ ｅＲｅｖｏ ｃ ａ ｔ ｉ ｏｎＬ ｉ ｓ ｔ证书撤销列表 ＤＥＲ Ｄｉ ｓ ｔ ｉ ｎｇｕ ｉ ｓｈｅｄＥｎｃｏｄ ｉ ｎｇＲｕ ｌ ｅ ｓ可区分编码规则 ＤＮ Ｄｉ ｓ ｔ ｉ ｎｇｕ ｉ ｓｈｅｄＮａｍｅ可识别名 ＥＣＣ Ｅｌ ｌ ｉ ｔ ｉ ｃＣｕ ｒ ｖｅＣｒ ｔ ｏｇ ｒ ａｐｈｙ 椭圆曲线密码 ｐ ｙｐ ＬＤＡＰ Ｌ ｉ ｔｗｅ ｉ ｔＤｉ ｒ ｅ ｃ ｔ ｏ ｒ ｃ ｅ ｓ ｓＰｒ ｏ ｔ ｏ ｃ ｏ ｌ轻量级目录访问协议 ｇｈ ｇｈ ｙ Ａｃ ＯＩＤ Ｏｂ ｅ ｃ ｔＩ ｄｅｎ ｔ ｉ ｆ ｉ ｅ ｒ对象标识符 ｊ ＰＫＣＳ ｔ ｈｅＰｕｂ ｌ ｉ ｃ ｔ ｏｇ ｒ ａｐｈｙＳ ｔ ａｎｄａ ｒｄ 公钥密码标准 ｙｐ ＫｅｙＣｒ ５　 算法标识和数据结构 ５． １　 算法标识与常量定义 本规范所使用常量定义、各类算法标识和证书 解 析 标 识 的 具 体 定 义 见 ＧＭ／Ｔ０００６《密 码 应 用 标 识 规范》。 ５． ２　 密码服务接口数据结构定义和说明 ５． ２． １　 常量定义 数据常量标识定义了在规范中用到的常量的取值。 数据常量标识的定义如表 １ 所示。 表 １　 常量定义 常量名 取值 描述 ＳＧＤ＿ＭＡＸ＿ ＣＯＵＮＴ ６４ 枚举出的对象数量最大值 ＳＧＤ＿ＭＡＸ＿ ＮＡＭＥ＿ Ｓ Ｉ ＺＥ ２５６ 证书某项信息的字符串长度最大值 ５． ２． ２　 用户证书列表 表 ２　 用户证书列表 字段名称 数据长度（字节） 含义 ｃ ｅ ｒ ｔＣｏｕｎ ｔ ４ 证书总数 Ｃｅ ｒ ｔ ｉ ｆ ｉ ｃ ａ ｔ ｅ ４ ＤＥＲ 编码的数字证书 ｃ ｅ ｒ ｔ ｉ ｆ ｉ ｃ ａ ｔ ｅＬｅｎ ４ 数字证书的长度 ｃ ｏｎ ｔ ａ ｉ ｎｅ ｒＮａｍｅ ４ 容器名称 ｃ ｏｎ ｔ ａ ｉ ｎｅ ｒＮａｍｅＬｅｎ ４ 容器名称的长度 ｋｅｙＵｓ ａｇｅ ４ 密钥用途 　　 实际数据结构定义： ｔ ｆｓ ｔ ｒｕｃ ｔＳＧＤ＿ ＵＳＲ＿ ＣＥＲＴ＿ ＥＮＵＭＬＩＳＴ＿｛ ｙｐｅｄｅ ｉ ｎ ｔｃ ｅ ｒ ｔＣｏｕｎ ｔ； 　　ｕｎｓ ｇｎｅｄｉ ｉ ｒｃ ｅ ｒ ｔ ｉ ｆ ｉ ｃ ａ ｔ ｅ［ ＳＧＤ＿ＭＡＸ＿ ＣＯＵＮＴ］； 　　ｕｎｓ ｇｎｅｄｃｈａ ［ ＿ ＿ ｉ ｎ ｔｃ ｅ ｒ ｔ ｉ ｆ ｉ ｃ ａ ｔ ｅＬｅｎ ＳＧＤ ＭＡＸ ＣＯＵＮＴ］； 　　ｕｎｓ ｇｎｅｄｉ ｉ ｒｃｏｎ ｔ ａ ｉ ｎｅ ｒＮａｍｅ［ ＳＧＤ＿ＭＡＸ＿ ＣＯＵＮＴ］； 　　ｕｎｓ ｇｎｅｄｃｈａ ２ 犌犕／犜 ００１９—２０１２ ｉ ｎ ｔｃｏｎ ｔ ａ ｉ ｎｅ ｒＮａｍｅＬｅｎ［ ＳＧＤ＿ＭＡＸ＿ ＣＯＵＮＴ］； 　　ｕｎｓ ｇｎｅｄｉ ｉ ｎ ｔｋｅｙＵｓ ａｇｅ［ ＳＧＤ＿ＭＡＸ＿ ＣＯＵＮＴ］； 　　ｕｎｓ ｇｎｅｄｉ ｝ＳＧＤ＿ ＵＳＲ＿ ＣＥＲＴ＿ ＥＮＵＭＬＩ ＳＴ； ５． ２． ３　 密钥容器信息列表 表 ３　 密钥容器信息列表 字段名称 数据长度（字节） 含义 ｋｅｙＰａ ｉ ｒＣｏｕｎ ｔ ４ 密钥容器信息总数 ｃ ｏｎ ｔ ａ ｉ ｎｅ ｒＮａｍｅ ２５６ 容器名称 ｃ ｏｎ ｔ ａ ｉ ｎｅ ｒＮａｍｅＬｅｎ ２５６ 容器名称的长度 ｋｅｙＵｓ ａｇｅ ４ 密钥用途， １：加密； ２：签名； ３：密钥交换 ｋｅｙＴｙｐｅ ４ 密钥类型， １： Ｓ