Microsoft Word - 证书管理器2.0 编程说明.doc

Size: px

Start display at page:

Download "Microsoft Word - 证书管理器2.0 编程说明.doc"

铅附袁
6 years ago
Views:

1 上海市电子商务安全证书管理中心有限公司证书管理器 Ver 2.0 API 函数接口编程说明一获取证书管理器中证书列表 1 int CMB_InitialDataBase(struct dbcontext *contxt); 建立证书管理器数据库连接, 并初始化数据库环境 2 int CMB_GetUserCertificateLists(struct dbcontext *contxt, int*certmgrcertid, char*commonname, char*vianame, char*cretserialno, char*status, char *PEMCert char*certpcertidlist, char*certpcertnamelist, int * CertPLen ); 反复执行, 每执行一次, 返回一条记录, 直至返回非零 3 int CMB_CloseDataBase(struct dbcontext *); 断开数据库连接, 并释放数据库环境 #include <ShecaMgrCert.h> char * UserName, *ViaName, *CertPCertIdList, *CertPNameList, * Status, *PemCert, *CertSerialNo; char CertPName[64],CertViaName[64],CertPCerId[8]; int CertMgrCertid,CertPNum; int i; UserName = ( char * )malloc(64); ViaName = ( char * )malloc(64); CertPCertIdList = ( char * )malloc(128); CertPNameList = ( char * )malloc(8*64); sstatus = ( char * )malloc(8);

2 PEMCert = ( char * )malloc(2048); CertSerial=( char * )malloc(48); struct dbcontext db; if(cmb_initialdatabase(&db)!=0) free(username); free(vianame); free(certserial); free(certpcertidlist); free(certnamelist); free(status); free(pemcert); while(cmb_getusercertificatelists(&db,&certmgrcertid,username,vianame,certserial,stat us, PEMCert,CertPCertIdList,CertPNameList,&CertPNum)==0).. // Notice: //CertMgrCertId : 从证书管理器中取得的证书标识号. 考虑到区别用户级证书和根级证书的 // 区别, 用户级证书的标识号 = 证书标识号 , 根级证书的标识号 = 证书标识号. // 故对于用户级证书, CertMgrCertId 可能为 10028, 证书标识号 CertId 应为 28. // 故对于根级证书, CertMgrCertId 可能为 28, 证书标识号 CertId 也为 28. //CerPCertIdlist : 证书链中根级证书标识号列表, 每个标识号用八个字符表示, 如 , 子级根证书在前, 父级根证书在后 //CertPNameList : 证书链中根级证书名称列表, 每个名称用 64 个字符表示, 其中含字符串结束符 ( \0 ); 如 SHECA \0.Beijing CA \0..BeijingBOCC SubCA \0. //CertPNum : 证书链中根级证书的个数 for(i=certpnum;i>=1;i--) strncpy(certpcertid,&certpcertidlist[8*(i-1)],8); CertId[8]='\0'; strncpy(certpname,&certpnamelist[64*(i-1)],64); //Notice: // 若当前证书没有别名,ViaName 项为字符 0, 有的话, 返回证书别名 if(strcmp(vianame,"0")==0) //Current Cerificate No ViaName; else //Current Cetificate With ViaName

3 CMB_CloseDataBase(&db); free(username); free(certpcertidlist); free(vianame); free(certserial); free(status); free(pemcert); 二添加证书 : 由以下六个函数完成 1. int CMB_GetUserCertChain( unsigned short certificatedevicetype, char* certificatedeviceparameter, char* CertChainCetIdList, char* CertChainNameList, int* CertChainNums) 在证书管理器数据库中匹配用户证书对应的证书链返回相关信息 ( 证书链中证书标识号列表, 证书链中证书名称列表, 证书链中证书数目 ) 2. int CMB_AddUserCertificate(unsigned short certificatedevicetype, char* certificatedeviceparameter, char* certificatepassword, unsigned short privatekeydevicetype, char* privatekeydeviceparameter, char* privatekeypassword, int ParentCertId, int*certmgrcertid, char * CertCommonName); 添加他人证书 ( 无私钥 ), 可从他人发来的签名文件中获取其证书, 也可从 Sheca 的 LDAP 服务器获取指定用户的证书返回相关信息 ( 证书标识号, 证书名称 ) 3. int CMB_AddUserCertAndKey(unsigned short certificatedevicetype, char* certificatedeviceparameter, char* certificatepassword, unsigned short privatekeydevicetype char* privatekeydeviceparameter, char* privatekeypassword, int ParentCertId, int*certmgrcertid,

4 将自己的证书和私钥添进数据库返回相关信息 ( 证书标识号, 证书名称 ) char * CertCommonName); #include ShecaCertMgr.h char CertPCertIdList[64],CertPNameList[8*64]; char test[20],certname[64]; int retcode,prikeyflag,certpnum,certid,parentcertid=0; retcode=cmb_getusercertchain(1, a:\usercert.der, CertPCertIdList,CertPNameList,&CertPNum); if (retcode==0) AfxMessageBox(" 匹配证书链成功. "); strncpy(test,&certpcertidlist[8*(certpnum-1)],8); test[8]='\0'; ParentCertId=atoi(test); else AfxMessageBox(" 匹配证书链出错. "); ParentCertId=0; ******************************* if (PriKeyFlag==1) //Add User Cert And Key Together intreturn = CMB_AddUserCertAndKey( 1, A:\UserCert.der, sheca, 1, A:\UserKey.key, sheca, ParentCertId,&CertId,CertName) else //Add User Cetrificate Only intreturn = CMB_AddUserCertificate( 1, A:\UserCert.der, sheca, 1,NULL,NULL, ParentCertId,&CertId,CertName); ******************************** 4. int CMB_InsertCertificate(char* certpem,bool overwrite);

5 插入证书, 无返回信息 5. int CMB_InsertCertAndKey(char * serialno, char * username, char * , char* certpem, char* skpem, char*medium, char* path, bool overwrite); 插入证书与私钥, 无返回信息三证书的导出导入 1 CMB_ExportUserCertificate(char *CertId,int CertType,char *filename); 从证书管理器中导出 sheca 格式用户证书. // 导出标识号为 122 的用户证书到 A:\UserCert.der CMB_ExportUserCertificate( 122,0, A:\UserCert.der ); // 导出标识号为 12 的根级证书到 A:\UserCert.der CMB_ExportUserCertificate( 12,1, A:\UserCert.der ); 四 2 int int CMB_p12CertImport(char* filepath,char*password, int *CertId, char * username, char * CertPCertIdList, char * CertPNameList, int * CertPNum); 导入 p12 格式用户证书和私钥到证书管理器返回证书链信息 3 CMB_p12CertExport(int CertId,char* filename,char* password); 从证书管理器中导出 p12 格式用户证书和私钥证书的管理 1. int CMB_GetCertById(char * CertId,int CertType, char * PemCert); 从证书管理器中取得用户证书. char UserPemCert[2048]; // 取得标识号为 122 的用户 Pem 编码证书

6 CMB_GetCertById( 122,0,UserPemCert); // 导出标识号为 12 的根级 Pem 编码证书 r CMB_GetCertById( 12,1,UserPemCert); 2. int CMB_GetCertId(char* PemCert,int certtype, int * CertId,int * ParentCertId); 从证书管理器中查找用户证书对应的证书标识号和父证书标识号 char UserPemCert[2048]; int CertID, ParentCertId, //By Some Way, User Got Pem Certificate in UserPemCert[2048] // 取得用户 Pem 编码证书的标识号 CMB_GetCertId(UserPemCert,0,&CertId,&ParentCertId); // 导出根级 Pem 编码证书的标识号 CMB_GetCertId(UsrePemCert,1,&CertId,&ParentCertId); 3. int CMB_GetCertStatus(int CertId, int CertType, char * VerifyClass, char *CertStatus); 从证书管理器中取得证书状态 4. int CMB_SetCertStatus(int CertId, int CertType, char * VerifyClass, char *CertStatus); 设置证书状态 5. int CMB_GetCertViaName(char *CertId [input], char *ViaName [input] ); 获取证书别名 6. int CMB_SetCertViaName(char *CertId [input], char *ViaName [input] ); 设置证书别名 7. int CMB_DeleteCertificate(char * CertId, int CetrType); 从证书管理器中删去用户证书 // 删除标识号为 122 的用户证书, 若存在私钥, 连同私钥一起删除 CMB_DeleteCertificate( 122,0); // 删除标识号为 12 的根级证书 r CMB_DeleteCertificate( 12,1);

7 8. int CMB_UpdateUserCertificate(int CertId, int CertType, int CertCheckMode, char* CertStatus); 更新证书管理器中的用户证书. // 更新标识号为 122 的用户证书, 更新模式为 1( 证书链完整性, 证书有效期, //CRL 废除校验 ) CMB_UpdateUserCertificate( 122,0,1,CertStatus); // 更新标识号为 12 的根级证书, 更新模式为 3( 证书链完整性, 证书有效期, //CRL 废除,OCSP 查询校验 ) CMB_UpdateUserCertificate( 12,1,3,CertStatus); //NOTICE: // CertCheckMode, 证书更新模式, 常值如下 : 0: 证书链完整性和证书有效期校验 1: 证书链完整性, 证书有效期和 CRL 校验 2: 证书链完整性, 证书有效期和 OCSP 校验 3: 证书链完整性, 证书有效期,CRL 和 OCSP 校验 // 返回的 CertStatus 字符串, 有效字段为前六个字符分别是 : CertStatus[0]: 该 CertStatus 字段的有效性 0, 有效, 1 无效 CertStatus[1]: 证书链完整性状态, 0, 有效, 1 无效 CertStatus[2]: 证书有效期状态, 0, 有效, 1 无效 CertStatus[3]: CRL 废除状态, 0, 有效, 1 无效 CertStatus[4]: OCSP 查询状态, 0, 有效, 1 无效 CertStatus[5]: 私钥存在状态, 0, 有效, 1 无效为取得当前证书的有效状态值, 需接合更新模式 (CertCheckMode), 从 CertStatus 字符串中读取相应的状态值 9. int CMB_ChangePasswd( char *CertId, char *oldpassword, char *newpassword); 对证书管理器中的私钥进行密码修改五加密解密签名验证进行加密签名验证前, 必须将装入对方的证书 ;

8 进行解密和签名前, 可以通过 CMB_LoadUserPrivateKey() 函数将私钥装入内存 int CMB_LoadUserPrivateKey(char* CertId, char* privatekeypassword); 解密和签名操作完毕, 可以调用 CMB_ClearUserPrivateKey() 清空内存私钥 int CMB_ClearUserPrivateKey(); 注意 : 证书常用加密解密签名验证 API 接口同证书管理器 Ver1.0, 现对证书管理器 Ver2.0 新增功能作一说明 1. int CMB_VerifyCertByCRL(unsigned char *DerCert, unsigned short DerCertLen, int isroot); 证书 CRL 教验返回 0 证书 CRL 教验通过. 其它不通过 2. int CMB_ VerifyCertByOCSP (unsigned char *DerCert, unsigned short DerCertLen, unsigned char *ParentDerCert, unsigned short ParentDerCertLen, int isroot) 证书 OCSP 教验返回 0 证书 ocsp 教验通过. 其它不通过

中国金融认证中心（CFCA）

中国金融认证中心（CFCA） CFCA 1 2007 05 1 9 1.1... 9 1.2... 10 1.3... 10 1.3.1 *. 10 1.3.2... 11 1.3.3 12 1.3.4 12 1.3.5 12 1.4 12 1.4.1 12 1.4.2 13 1.5 13 1.5.1 13 1.5.2... 13 1.5.3 CPS.. 14 1.5.4 CPS 14 1.6 14 2 15 2.1 15 2.2