DB11T 254.2-2004政务数字证书规范 第2部分：应用接口.pdf

ICS 35. 240. 30L70DB备案号：16484-2005北長京市地方标准DB11/T 254.22004政务数字证书规范第2部分：应用接口Specification of digital certificate for government affairPart 2: Application programming interface2004-12-20发布2005-02-01实施北京市质量技术监督局发布 DB11/T 254.22004目次前言引言1范国围2规范性引用文件3术语和定义、缩略语3.1术语和定义3.2缩略语..4政务数字证书应用接口4.1数字证书应用接口体系结构4.2数字证书应用接口组成和功能说明5政务数字证书应用接口函数定义5.1环境函数5.2设备管理函数5.3证书函数.4密码服务函数5消息函数A(规范性附录）政务数字证书应用接口宏定义和说明34A.1类型宏定义A.2常量宏定义34A.3全局参数34附录B(规范性附录）政务数字证书应用接口数据结构定义和说明36附录C(规范性附录）政务数字证书应用接口错误代码定义和说明37附：录D(资料性附录政务数字证书典型应用框架图38D.1典型应用框架图38D.2典型业务流程分析39附录E(资料性附录）政务数字证书典型应用示例40E.1程序基本流程E.2程序示例说明， DB11/T 254. 22004函数名称PKI_RVPKI_GetVersion (unsigned long *versoin)功能简介取接口版本号参数说明version [OUT]: H版本号version的高2字节表示主版本号，低2字节表示次版本号返回值RV_OK:成功其他：失败5. 2设备管理函数设备管理函数包括以下具体函数：用户登录：PKI_Login.修改 PIN:PKI_ChangePin.注销登录：PKI_Logout5. 2. 1用户登录：FPK1_Login函数名称PKI_RVPKI_Login (unsigned 1ong usrType,unsigned char *pin,unsigned long pinLen)功能简介用户登录密码设备，建立安全令牌参数说明usrType[IN]：用户类型// 0: SUPER_LOGIN 1: USR_LOGINpin[IN]：设备口令pinLen[IN]：设备口令长度返回值RV_OK：成功其他：失败5. 2. 2修改PIN：PK1_ChangePin函数名称PKI_RVPKI_ChangePin (unsigned 1ong usrType,unsigned char *oldPin,unsigned 1ong oldPinLen,unsigned char newPin,unsigned 1long newPinLen) :功能简介修改设备PIN参数说明usrType [IN] :用户类型// 0: SUPER_LOGIN 1: USR_LOGINoldPin[IN]：设备当前口令6 DB11/T 254. 22004oldPinLen[IN]：设备当前口令长度nevPin[IN]：设备新口令nevPinLen[IN]：设备新口令长度返回值RV_OK:成功其他：失败5. 2. 3注销登录：FPK1_Logout函数名称PKI_RVPKI_ Logout(unsigned 1ong usrType)功能简介设备注销登录参数说明usrType[IN]:用户类型// 0: SUPER_LOGIN 1: USR_LOGIN返回值RV_OK:成功其他：失败5. 3证书函数证书函数包括以下具体函数：添加信任的CA根证书：PKI_AddTrustedRootCaCertificate.添加 CA 证书：PKI_AddCaCertificate.添加黑名单：PKI_AddCr1.设置用户证书：PKI_SetUsrCertificate获取用户证书：PKI_GetUsrCertificate.验证用户证书：PKI_VerifyUsrCertificate.根据CRL文件验证用户证书是否被注销：PKI_VerifyUsrCertificateByCr10CSP在线证书状态查询：PKI_OcspVerifyCertificate通过LDAP方式获取证书：PKI_GetCertFromLdap通过LDAP方式根据证书获取CRL：PKI_GetCr1FromLdap取证书信息：PKI_GetCertificateInfo取证书扩展信息：PKI_GetExtTypeInfo5. 3. 1添加信任的CA根证书：PK1_AddTrustedRootCaCertificate函数名称PKI_RVPKI_AddTrustedRootCaCertificate