CQCCA数字证书安全登录接口说明

CQCCA数字证书安全登录

接口说明

1V-CTK控件

V-CTK是由中认环宇独立开发，完成对Windows平台证书操作的COM控件，利用控件提供的接口，可以设置系统证书列表的过滤条件，显示证书的各种属性，使用证书对字符串签名验证，以及对数据加密解密。

控件CLISID：D382D2C6-F022-4C9B-B33B-A8B0055FE72D

1.1V-CTK控件的安装

两种安装方式：

●通过网页")

●通过CQCCA数字签名组件安装

执行CQCCA数字签名组件.exe安全程序。

说明：可在CQCCA网站上下载这个组件。

1.2创建V-CTK控件对象

在您页面HTML源码的之间加入

1.

2.id=SignForm

3.classid=clsid:D382D2C6-F022-4C9B-B33B-A8B0055FE72D>

4.

以上代码会创建一个名为SignForm的V-CTK对象。

1.3V-CTK控件的使用

1.1.1证书过滤

系统中可能存储着大量证书，用户进行特定的邮件或交易操作时，可能只对部分的证书感兴趣，使用证书过滤条件可以方便的选择用户希望的证书。

证书过滤接口：SignForm.Filter；

该接口提供三个属性设置过滤条件：

1)SignForm.Filter.Subject：根据证书的主题过滤证书；

2)SignForm.Filter.Issuers：数组类型，根据证书的颁发者主题过滤证

书；

3)SignForm.Filter.SerialNumber：根据证书的序列号过滤证书。

JavaScript代码举例：

1.SignForm.Filter.Issuers=new Array(

2.// 设置证书过滤条件：颁发者为CQCCA

3."C=CN, O=China Quality Certification Center, CN=CQC CA"

4.);

1.1.2返回证书集合

JavaScript代码：var certs = SignForm.MyCertificates;

上述代码返回了证书集合；如果在上述代码前先执行证书过滤代码，则返回的是过滤后的证书集合。

集合的元素类型是Certificate类型；

1.1.3通过Certificate对象访问证书的属性

在选择了当前证书后可利用对象提供的各种功能获得数字证书的属性，例如：证书通用名：https://www.360docs.net/doc/411246185.html,monName

证书主题：CurCert.Subject

颁发者主题：CurCert.Issuer

证书CSP：CurCert.CSP

证书序列号：CurCert.SerialNumber

JavaScript代码举例：

1.// 返回证书集合第0个元素的证书主题

2.var certSubject = SignForm.MyCertificates(0).Subject;

1.1.4使用Certificate对象进行数字签名

使用数字证书进行数字签名的JavaScript代码如下：

signedData = CurCert.SignMessage(originalText)

其中：

originalText：为待签名的数据。

signedData：为函数返回的PKCS7格式签名数据。

2V-STK - Java证书应用开发套件

V-STK是由中认环宇独立开发，完成对客户端签名数据的验证等操作。Java 证书应用开发套件SECeasePKI.1.2.0.0.jar（目前最新版本1.2.0.0）可运行于Java Runtime Environment 1.4 or 1.5及以上版本。

2.1V-STK的集成

V-STK支持于Java项目，本文用JavaEE项目为例，介绍如何集成到Java Web 项目中。

2.1.1依赖的lib包

1)SECeasePKI.1.2.0.0.jar

2)bcmail-jdk15.jar

3)bcprov-jdk15-137.jar

4)commons-logging.jar

5)log4j.jar

2.1.2V-STK配置文件

主要用于CRL的更新策略配置，需将配置文件引入到工程中，代码如下：

BC

60

ldap://https://www.360docs.net/doc/411246185.html,:389/CN=crl,OU=CQC CA CRL,O=China Quality Certification Center,C=CN@certificateRevocationList;binary

cafiles/CQCCA.crl

cafiles/CQCCA.cer

将上面的代码保持到xml文件中，并存放在WEB-INF目录下，同时在WEB-INF目录建立cafiles目录，用于存放CQCCA.crl文件和CQCCA.cer文件。

2.1.3V-STK启动

Java代码：

1.CVM.config(“V-STK配置文件路径”);

通常在Java WEB应用启动时启动V-STK，可以把上一行代码写入Servlet或系统监听中，随着应用的启动一并执行。

2.2利用V-STK验证证书签名

2.2.1验证签名方法

1.java.security.cert.X509Certificate x509Cert

=SVM.verifySignature(oriToSign, signedData);

其中：

oriToSign：为待签名的数据。

signedData：为函数返回的PKCS7格式签名数据。

返回值：X509Certificate格式的证书对象

https://www.360docs.net/doc/411246185.html,.secease.cert.X509Certificate cert=

X509Certificate.getInstance(x509Cert);

作用：将x509Cert对象转换为com.secease.cert.X509Certificate对象2.2.2判断验签结果

1.int ret = CVM.verifyCertificate(cert);

上述代码会返回一个int类型的状态，参照下面的常量类判断签名的结果。

public interface com.secease.cvm.CertificateStatus {

public final int CVM_INIT_ERROR = -1;

public final int VALID = 0;// 正常

public final int EXPIRED = 1;// 过期但没有被吊销过

public final int REVOKED = 2;// 已吊销但还没有过期

public final int UNKNOWN_ISSUER = 3;// 不是系统所支持的CA所颁发

public final int ILLEGAL_ISSUER = 4;// 非法CA所颁发证书

public final int CRL_UNAVAILABLE = 5;// 没有可供查询的CRL

public final int REVOKED_AND_EXPIRED = 6;// 过期而且被吊销

public final int UNKNOWN_STATUS = 7;

public final int ACCOUNT_MISMATCH = 8;// 账户不匹配

}

3caloginDemo工程介绍

caloginDemo功能是数字证书登录的演示，在开发过程中可以参考此工程的结构来进行代码的整合，整合时参考一下几点：

1、secease目录包含所用到的控件，只需加入工程中即可。

2、将WEB-INF/lib中的jar包加入工程。

3、将WEB-INF下的cafiles文件夹和ca-config.xml配置文件拷入工程目录下。Cafiles文件夹

中有两个文件CQCCA.cer和CQCCA.crl，其中CQCCA.cer是根证书，CQCCA.crl是证书吊销列表，存放被吊销的证书信息。证书吊销列表需要定时更新，ca-config.xml中配置了列表的更新地址和更新间隔时间。

4、修改web.xml文件，在web.xml文件中添加下列代码：

CAConfig

com.cqcca.CAConfig

CVMConfigFile

/WEB-INF/ca-config.xml

1

5、参考index.jsp文件书写调用函数：

<%

String randStr = String.valueOf(System.currentTimeMillis());

session.setAttribute("loginRand", randStr);

%>

该部分语句在服务器端产生随机数，并将该随机数存放在session中。

通过该段代码将secease中的控件以及封装好的函数加载进来。

表单提交函数function formSubmit()中，signature = SignMessage(form.random.value)语句用来对对象进行签名，签名对象为服务器端产生的随机数，签名结果为signature。

onChange="javascript:SelectCertByIndex(this.value);" class="select">

通过该语句将证书信息加载到选择证书的下拉框中。

该段代码用来过滤证书信息。SetFilters()函数包含三个参数：证书颁发者、证书主题和证书序列号，设定三个参数过滤证书后，通过InitCertList()函数来初始化下拉框列表。