RA2.0CS接口开发手册

1、RA2.0C/S 接口开发手册1. 概述RA2.0 C/S 接口采用 Apache Axis 来开发 Web Service,可以完 成 B/S 结构全部的证书管理功能，包括证书的申请、补发、换发、 冻结、解冻、吊销、两码重发、制证以及证书查询等。2. 使用对象使用 C/S 结构 RA 系统的开发人员。3. 使用方法开发客户端应用程序时，先将CS客户端程序lib目录下的包 引入到客户端应用程序中。如果应用程序运行在jdk1.3上，将CS客户端程序xml目录下的 包引入到客户端应用程序中。如果 jdk 版本在 1.3 以上不要引入 xml 目录下的包,否则会有包冲突。4. RA 系统 C/S 接

2、口说明4.1 证书申请Public ReturnData certApply(CertApplyVO certApplyVO)功能说明提交一个证书申请请求，返回构造好的证书DN、参考号和授权码，如发生异常，则返回错误码和错误信息输入参数CertApplyVO 包含参数类型参数说明是否必填certTypeE nameStri ng证书类型英文名（只能按下面内 容设置参数）Customers -个人普通Business Customers -个人高级证书Enterprises -企业普通Un its -企业高级Web Servers -Web服务器证书是userNameStri ng用户名（长度限

3、制：80）是engNameStri ng用户英文名（长度限制：80）是idTypeCodeStri ng证件类型编码（参照附件 1）是userIdNoStri ng证件号（长度限制：80）是emailStri ng电子邮件（长度限制：80）是addressStri ng地址（长度限制：80）否telNoStri ng电话号码（长度限制：80）否orga nCodeStri ng机构编码（长度限制：20）是doma inN ameStri ng域名（长度限制：80）否（申请Web服务 器证书时必填）ext InfoStri ng扩展域值（长度限制：512）否输出参数ReturnData 包含:参

4、数类型参数说明dnStri ng证书DNrefNoStri ng证书参考号authCodeStri ng证书授权码errorCodeStri ng:错误码errorI nfoStri ng错误信息错误码和错误信息错误码错误信息80010001该用户证书已经被申请80010203数据有效性检查证书类型不能为空80010207数据有效性检查 该证书已经不存在，请重 新查询80010209数据有效性检查 姓名不能为空80010210数据有效性检查英文名不能为空80010211数据有效性检查证件类型不能为空80010212数据有效性检查证件编号不能为空80010213数据有效性检查电子邮件地址不能为空

5、80010214数据有效性检查电子邮件地址格式不对80010215数据有效性检查机构不能为空80010219数据有效性检查域名不能为空80010222数据有效性检查姓名长度超过数据库限制,长度不能超过80位80010223数据有效性检查英文名长度超过数据库限 制,长度不能超过80位80010224数据有效性检查地址长度超过数据库限制,长度不能超过80位80010225数据有效性检查电子邮件长度超过数据库 限制,长度不能超过80位80010226数据有效性检查域名长度超过数据库限制,长度不能超过80位80010227数据有效性检查电话长度超过数据库限制,长度不能超过80位80010228数据有效

6、性检查证件号码长度超过数据库 限制,长度不能超过80位80010229数据有效性检查身份证号码只能是15位或18位80010230数据有效性检查机构编码长度超过数据库 限制,长度不能超过20位80010231数据有效性检查域名长度超过数据库限制,长度不能超过80位80010232数据有效性检查系统不支持的两码发送方 式80010233数据有效性检查系统不支持的证件类型80010234数据有效性检查系统不支持的证书类型80010235数据有效性检查扩展值长度超过数据库限 制,长度不能超过512位80010401连接CA服务器失败80010402CA处理业务失败80010403释放CA连接失败80

7、010404解析CA响应数据失败80010405CA拒绝申请80010406获得CA返回的业务结果失败80010501数据库操作错误80010601对扩展信息进行编码出错80019999服务器端系统错误调用示例public static void main(String args)tryString wsdl = http:/ localhost:8080/raWeb/services/CSProcessor?WSDL;URL wsdlUrl = new URL(wsdl);/取得Web服务CSProcessorSoapBindingStub service = (CSProcessorSoa

8、pBindingStub)new CSProcessorServiceLocator(). getCSProcessor(wsdlUrl);/构造输入参数对象CertApplyVO certApplyVO = new CertApplyVO();/设置用户姓名certApplyVO.setUserName(test);/设置用户英文名certApplyVO. setEngName (test);/设置用户地址certApplyVO.setAddress(Beijing);/设置邮编certApplyVO.setZipCode(246725);/设置电子邮件certApplyVO.setEmai

9、l();/设置电话号码certApplyVO.setTelNo(12345678);/设置证件类型certApplyVO.setldTypeCode(RAConstant.PASSPORT);/设置证件号certApplyVO.setUserldNo(5108888888888x);/设置机构编码certApplyVO.setOrganCode(10001);/证书类型certApplyVO.setCertTypeEname(RAConstant.CERT_TYPE_USER);/证书起始时间certApplyVO.setStartTime(200705100

10、00000);/证书截止时间certApplyVO.setEndTime(20080509100000);com.cfca.ra.cs.generated.ReturnData result = service.certApply(certApplyVO);if (result != null) if(result.getErrorCode = null) /判断返回错误码是否为空，如果为空，则表明申请成功System.out.println(dn = + result.getDn(); 返回的证书 DN(cn 中包含序号)System.out.println(refNo = + result

11、.getRefNo();返回的证书参考号System.out.println(authCode = + result.getAuthCode();/ 返回的证书授权码(明文)catch(Exception e)e.printStackTrace();4.2证书补发Public ReturnData certRe new(Stri ng dn)功能说明提交一个证书补发请求。吊销旧证书，获得新证书的两码。新证书的有效截止日期不变。输入参数参数类型参数说明是否必填dnStri ng做补发操作的证书DN(长度限制：256)是输出参数ReturnData 包含:参数类型参数说明refNoStri ng证

12、书参考号authCodeStri ng证书授权码errorCodeStri ng错误码errorI nfoStri ng错误信息错误码和错误信息错误码错误信息80050001要操作的证书不存在或证书不是激活状态80050303状态检查 证书已经不是“激活”状态80050401连接CA服务器失败80050402CA处理业务失败80050403释放CA连接失败80050404解析CA响应数据失败80050405CA拒绝申请80050406获得CA返回的业务结果失败80050501数据库操作错误80059999服务器端系统错误调用示例public static void main(String ar

13、gs)System.out.println(RA2.0 C/S 接口功能测试!);try String wsdl = http:/ localhost:8080/raWeb/services/CSProcessor?WSDL;URL wsdlUrl = new URL(wsdl);/取得Web服务CSProcessorSoapBindingStub service = (CSProcessorSoapBindingStub)new CSProcessorServiceLocator(). getCSProcessor(wsdlUrl);/调用证书补发业务(参数为证书 DN )ReturnDat

14、arenewData=service.certRenew(cn=0411endUser00001endUser0000100000001,ou=Customers,ou=tccb,o=CFCA TEST CA,c=cn);if(renewData != null)if(result.getErrorCode = null) /判断返回错误码是否为空，如果为恐则表明补发成功System.out.println(dn = + result.getDn(); 返回的证书 DNSystem.out.println(refNo = + result.getRefNo();返回的证书参考号System.o

15、ut.println(authCode = + result.getAuthCode();返回的证书授权码(明文)elseSystem.out.println(The result is null!); catch (Exception e) e.printStackTrace();4.3证书换发Public Retur nData certUpdate(Stri ng dn)功能说明提交一个证书换发请求。吊销旧证书，获得新证书的两码。新 证书的有效截止日期改变。输入参数参数类型参数说明是否必填dnStri ng做换发操作的证书DN(长度限制：256)是输出参数ReturnData 包含:参数

16、类型参数说明refNoStri ng证书参考号authCodeStri ng证书授权码errorCodeStri ng错误码errorI nfoStri ng错误信息错误码和错误信息错误码错误信息80080001要操作的证书不存在或证书不是激活状态80080002要操作的证书现在不能被换发，必须在有效 期截止日前*月内进行换发80080303状态检查 证书已经不是“激活”状态80080401连接CA服务器失败80080402CA处理业务失败80080403释放CA连接失败80080404解析CA响应数据失败80080405CA拒绝申请80080406获得CA返回的业务结果失败80080501数

17、据库操作错误80089999服务器端系统错误调用示例public static void main(String args)System.out.println(RA2.0 C/S 接口功能测试!);try String wsdl = http:/ localhost:8080/raWeb/services/CSProcessor?WSDL;URL wsdlUrl = new URL(wsdl);/取得Web服务CSProcessorSoapBindingStub service = (CSProcessorSoapBindingStub)newCSProcessorServiceLocato

18、r(). getCSProcessor(wsdlUrl);/调用证书换发业务ReturnDataupdateDataservice.certUpdate(cn=0411endUser00001endUser0000100000001,ou=Customers,ou=tccb,o=CFC A TEST CA,c=cn );if(updateData != null)if(updateData.getErrorCode = null) / 判断返回错误码是否为空，如果为空则表明换 发成功System.out.println(dn = + result.getDn(); 返回的证书 DNSystem

19、.out.println(refNo = + result.getRefNo(); 返回的证书参考号 System.out.println(authCode = + result.getAuthCode();返回的证书授权码(明文)elseSystem.out.println(errorlnfo= + result.getErrorlnfo(); / 返回的错误信息elseSystem.out.println(The result isnull!); catch (Exception e) e.printStackTrace();4.4证书冻结Public ReturnData certFre

20、eze(Stri ng dn)功能说明提交一个证书冻结请求。将证书状态置为“冻结”输入参数参数类型参数说明是否必填dnStri ng证书DN (长度限制：256)是输出参数ReturnData 包含:参数类型参数说明errorCodeStri ng错误码errorI nfoStri ng错误信息错误码和错误信息错误码错误信息80140001要操作的证书不存在或证书不是激活状态80140303状态检查 证书已经不是“激活”状态80140401连接CA服务器失败80140402CA处理业务失败80140403释放CA连接失败80140404解析CA响应数据失败80140405CA拒绝申请80140

21、406获得CA返回的业务结果失败80140501数据库操作错误80149999服务器端系统错误调用示例public static void main(String args)System.out.println(RA2.0 C/S 接口功能测试!);try String wsdl = http:/ /localhost:8080/raWeb/services/CSProcessor?WSDL;URL wsdlUrl = new URL(wsdl);/取得Web服务CSProcessorSoapBindingStub service = (CSProcessorSoapBindingStub)n

22、ew CSProcessorServiceLocator(). getCSProcessor(wsdlUrl);/调用证书冻结服务ReturnDatafreezeData=service.certFreeze(cn=0411endUser00001endUser0000100000001,ou=Customers,ou=tccb,o=CFCA TEST CA,c=cn );if(freezeData != null)System.out.println(freezeData.getErrorCode();System.out.println(freezeData.getErrorlnfo();

23、elseSystem.out.println(” 证书冻结成功); catch (Exception e) e.printStackTrace();4.5证书解冻Public ReturnData certU nfreeze(Stri ng dn)功能说明提交一个证书解冻请求。将证书状态置为“激活”输入参数参数类型参数说明是否必填dnStri ng做解冻操作的证书DN是（长度限制：256）输出参数ReturnData 包含:参数类型参数说明errorCodeStri ng错误码errorI nfoStri ng错误信息错误码和错误信息错误码错误信息80170001要操作的证书不存在或证书不是冻

24、结状态80170304状态检查 证书已经不是“冻结”状态80170401连接CA服务器失败80170402CA处理业务失败80170403释放CA连接失败80170404解析CA响应数据失败80170405CA拒绝申请80170406获得CA返回的业务结果失败80170501数据库操作错误80179999服务器端系统错误调用示例public static void main(String args)System.out.println(RA2.0 C/S 接口功能测试!);try String wsdl = http:/ localhost:8080/raWeb/services/CSProc

25、essor?WSDL;URL wsdlUrl = new URL(wsdl);/取得Web服务CSProcessorSoapBindingStub service = (CSProcessorSoapBindingStub)new CSProcessorServiceLocator(). getCSProcessor(wsdlUrl);/调用证书解冻业务ReturnDataunFreezeDataservice.certUnFreeze(cn=0411endUser00001endUser0000100000001,ou=Customers,ou=tccb,o=CF CA TEST CA,c=

26、cn );if(unFreezeData != null)System.out.println(unFreezeData.getErrorCode();System.out.println(unFreezeData.getErrorlnfo();elseSystem.out.println(” 证书解冻成功); catch (Exception e) e.printStackTrace();4.6两码重发Public Retur nData codeRese nd (Stri ng dn)功能说明提交一个证书两码重发请求。重新取得两码。输入参数参数类型参数说明是否必填dnStri ng证书DN

27、 (长度限制：256)是输出参数ReturnData 包含:参数类型参数说明refNoStri ng证书参考号authCodeStri ng证书授权码errorCodeStri ng错误码:errorI nfoStri ng错误信息错误码和错误信息错误码错误信息80200001要操作的证书不存在或证书不是未下载状 态80200301状态检查 证书已经不是“未下载”状态80200401连接CA服务器失败80200402CA处理业务失败80200403释放CA连接失败80200404解析CA响应数据失败80200405CA拒绝申请80200406获得CA返回的业务结果失败80200501数据库操作

28、错误80209999服务器端系统错误调用示例public static void main(String args)System.out.println(RA2.0 C/S 接口功能测试!);try String wsdl = http:/ localhost:8080/raWeb/services/CSProcessor?WSDL;URL wsdlUrl = new URL(wsdl);/取得Web服务CSProcessorSoapBindingStub service = (CSProcessorSoapBindingStub)new CSProcessorServiceLocator()

29、. getCSProcessor(wsdlUrl);/调用两码重发业务(参数为证书 DN )ReturnDatacodeResendData=service.codeResend(cn=0411endUser00001endUser0000100000001,ou=Customers,ou=tccb,o=CFC A TEST CA,c=cn );if(codeResendData != null)if(codeResendData.getErrorCode = null ) /如果错误码为空，说明两码重发成功System.out.println(dn = + result.getDn(); /

30、 返回的证书 DNSystem.out.println(refNo = + result.getRefNo();返回的证书参考号System.out.println(authCode = + result.getAuthCode(); / 返回 的证 书授权 码(明文) elseSystem.out.println(errorlnfo= + result.getErrorlnfo(); / 返回的错误信息elseSystem.out.println(The result isnull!); catch (Exception e) e.printStackTrace();4.7证书吊销Publi

31、c ReturnData certRevoke (Stri ng dn)功能说明提交一个证书吊销请求。如果该证书已经被被下载，则将证书 状态置为“吊销”；如果证书还未被下载，则删除 RA中记录以及 CA中的记录。输入参数参数类型参数说明是否必填dnStri ng证书DN (长度限制：256)是输出参数ReturnData 包含:参数类型参数说明errorCodeStri ng错误码errorl nfoStri ng错误信息常用错误码和错误信息错误码错误信息80110001要操作的证书不存在80110002证书已经被吊销或冻结，不能再吊销80110303状态检查 证书已经不是“激活”状态8011

32、0401连接CA服务器失败80110402CA处理业务失败80110403释放CA连接失败80110404解析CA响应数据失败80110405CA拒绝申请80110406获得CA返回的业务结果失败80110501数据库操作错误80119999服务器端系统错误调用示例public static void main(String args)System.out.println(RA2.0 C/S 接口功能测试!);try String wsdl = http:/ localhost:8080/raWeb/services/CSProcessor?WSDL;URL wsdlUrl = new URL

33、(wsdl);/取得Web服务CSProcessorSoapBindingStub service = (CSProcessorSoapBindingStub)new CSProcessorServiceLocator(). getCSProcessor(wsdlUrl);/调用证书吊销业务ReturnDatareturndataservice.certRevoke(cn=0411endUser00001endUser0000100000001,ou=Customers,ou=tccb,o=CFC A TEST CA,c=cn );if (retundata != null) System.o

34、ut.println(retundata.getErrorCode();System.out.println(retundata.getErrorlnfo(); else System.out.println(” 证书吊销成功); catch (Exception e) e.printStackTrace();4.8制证Public ReturnData certSign (String ref, String authCode,Stri ng pkcs10)功能说明提交一个制证请求。获得证书的签名信息、加密信息、加密私钥信息输入参数参数类型参数说明是否必填refNoStri ng证书参考号是

35、authCodeStri ng授权码是pkcs10Stri ngpkcs10请求是输出参数ReturnData 包含:参数类型参数说明en cCertPemStri ng用PEM规则编码的加密 证书sig nCertPemStri ng用PEM规则编码的签名 证书en cPriKeyPemStri ng用PEM规则编码的加密 私钥errorCodeStri ng错误码errorI nfoStri ng错误信息错误码和错误信息错误码错误信息80260001要操作的证书不存在80260301状态检查 证书已经不是“未下载”状态80260401连接CA服务器失败80260402CA处理业务失败802

36、60403释放CA连接失败80260404解析CA响应数据失败80260405CA拒绝申请80260406获得CA返回的业务结果失败80260501数据库操作错误80269999服务器端系统错误调用示例public static void main(String args) tryString wsdl = http:/ localhost:8080/raWeb/services/CSProcessor?WSDL;URL wsdlUrl = new URL(wsdl);/取得Web服务CSProcessorSoapBindingStub service = (CSProcessorSoapBi

37、ndingStub)new CSProcessorServiceLocator(). getCSProcessor(wsdlUrl);/证书参考号String refNo = 384db115fe0c4cc27f3fa1f37d8f5c20;/授权码String authCode = 20433aaadeec3a406d2ed0e914363ef0;/ p10请求字符串String pkcs10 =;/调用制证业务com.cfca.ra.cs.generated.ReturnData result = service.certSign(refNo, authCode, pkcs10); if

38、(result != null) if(result.getErrorCode = null) /如果错误码为空，则说明制证成功/签名信息System.out.pri ntln(* result.getSignCertPem();/加密信息System.out.pri ntln(* result.getEncCertPem();/加密私钥System.out.pri ntln(*signCertPem =+encCertPem =+encPriKeyPem =+result.getEncPriKeyPem(); elseSystem.out.println(errorlnfo= + resul

39、t.getErrorlnfo(); / 返回的错误信息 else System.out.println(The result is null!);catch(Exception e)e.printStackTrace();4.9证书查询Public SearchResult searchCert (SearchC on diti on con dit on)功能说明通过一些证书条件或者用户信息来查询证书对象。输入参数参数类型参数说明是否必填certTypeE nameStri ng证书类型英文名Customers -个人普通Business Customers -个人高级证书Enterpris

40、es -企业普通Un its -企业高级Web Servers - Web 服务器 证书否certStatusint证书状态-1:全部状态3:未下载4:激活5:冻结6:吊销是dnStri ng证书DN否refNoStri ng证书参考号否expireTimeStri ng证书过期时间（格式为：YYYY -MM-DD）否addTimeFromStri ng证书发放时间段的起始日 期（格式为：YYYY -MM-DD）否addTimeToStri ng证书发放时间段的截止日 期（格式为：YYYY -MM-DD）否orga nCodesStri ng多机构编码的组合，用”;”连接。如 ”1001;10

41、02;2001 ”否userNameStri ng用户姓名否domaiNameStri ng服务器证书域名否telNoStri ng电话号码否userIdTypeCodeStri ng证件类型编码（参照附件1）否userIdNoStri ng证件号否emailStri ng用户电子邮件否queyExactlyBoolea n是否精确查询否输出参数SearchResult数组，SearchResul包含:参数类型参数说明userNameStri ng用户姓名dnStri ng证书DNrefNoStri ng4七口 参考号startTimeStri ng证书起始时间en dTimeStri ng证

42、书过期时间certStatusCodeStri ng证书状态编码3:未下载4:激活5:冻结6:吊销certTypeStri ng证书类型调用示例public static void main(String args)System.out.println(RA2.0 C/S 接口功能测试!);try String wsdl = http:/ localhost:8080/raWeb/services/CSProcessor?WSDL;URL wsdlUrl = new URL(wsdl);/取得Web服务CSProcessorSoapBindingStub service = (CSProces

43、sorSoapBindingStub)new CSProcessorServiceLocator(). getCSProcessor(wsdlUrl);/构造查询条件SearchCondition cond = new SearchCondition();cond.setCertTypeEname(Customers);cond.setCertStatus(-1);cond.setUserldTypeCode(T);cond.setQueryExactly(false);cond.setDn(132987423987498);cond.setRefNo(3e77adf01);cond.setU

44、serName(用户代表);/调用证书查询SearchResult searchResults = service.searchCert(cond);if(searchResults != null)System.out.println(” 证书查询结果：+ searchResults.length);elseSystem.out.println(Searching for cert has been over, but the result is null.);System.out.println(”证书查询测试结束：); catch (Exception e) e.printStackTr

45、ace();4.10证书删除Public ReturnData certDelete (Stri ng dn)功能说明如果证书还未被下载，则删除RA中记录以及CA中的记录输入参数参数类型参数说明是否必填dnStri ng证书DN (长度限制：256)是输出参数ReturnData 包含:参数类型参数说明errorCodeStri ng错误码errorI nfoStri ng错误信息常用错误码和错误信息错误码错误信息80230001要操作的证书不存在80230002证书已经被吊销或冻结，不能再吊销80230303状态检查 证书已经不是“激活”状态80230401连接CA服务器失败80230402

46、CA处理业务失败80230403释放CA连接失败80230404解析CA响应数据失败80230405CA拒绝申请80230406获得CA返回的业务结果失败80230501数据库操作错误80239999服务器端系统错误调用示例public static void main(String args)System.out.println(RA2.0 C/S 接口功能测试!);try /*/SSL方式调用时使用System.setProperty(tocol.handler.pkgs,tocol);System.setPr

47、operty(.ssl.keyStore, E:/yanzhengT.jks);System.setProperty(.ssl.keyStorePassword, Abcd1234);System.setProperty(.ssl.trustStore, E:/yanzhengT.jks);System.setProperty(.ssl.trustStorePassword, Abcd1234);String wsdl = https:/localhost:8443/raWeb/services/CSProcessor?W

48、SDL;*/String wsdl = http:/localhost:8080/raWeb/services/CSProcessor?WSDL;URL wsdlUrl = new URL(wsdl);CSProcessorSoapBindingStub service = (CSProcessorSoapBindingStub)new CSProcessorServiceLocator(). getCSProcessor(wsdlUrl);service.setTimeout(60000);/未下载证书删除测试开始：System.out.println(”未下载证书删除测试开始：”)；ReturnDatadeleteDataservice.certDelete(cn=0411CSUCT10091601CSUCT1009160100000001,ou=Customers,ou=tccb,o=CFCA TEST CA,c=cn);if(deleteData != null)System.out.println(deleteData.getErrorCode();System.out.println(deleteData.getErrorlnfo();elseSystem.out.println(The re