xecure.expcmp
Class XecureCAClient

java.lang.Object
  |
  +--xecure.expcmp.XecureCAClient
public class XecureCAClient
extends java.lang.Object

XecureCAClient 클래스는 XecureCA 와 통신하여 사용자 인증서를 발급받는다. RA의 역할을 직접 수행하는 class 이다. (GPKI 용)
ver 2.1 에서는 cmp 기능 (공개키와 개인키를 생성하고, XecureRA 를 통해 등록된 사용자 정보로 인증서 발급을 XecureCA 에 요청)은 Deprecated 되었다. (Client Control 에서 수행)

Constructor Summary
XecureCAClient(XecureExpConfig config)
          XecureCAClient Constructor
 
Method Summary
 int getLastError()
          발급기관으로부터 에러가 전송된 경우 에러코드가 리턴된다.
 java.lang.String getLastErrorMsg()
          발급기관으로부터 에러가 전송된 경우 에러 메시지가 리턴된다.
 java.lang.Object getResponseFromCertView(java.lang.String entry, int index)
          발급기관으로 부터 전달받은 사용자 인증서 조회 결과 정보를 얻는다.
 java.lang.String getResponseFromRegUser(java.lang.String entry)
          발급기관으로 부터 전달받은 사용자 등록결과 정보를 얻는다.
entry : "MESSAGE" - CA 로 부터 전달된 메시지
"REGDATE" - 등록 날짜
"REGSERIAL" - 등록 번호
"COMPANY" - 회사명
"USERNAME" - 사용자 명
"USERID" - 사용자 ID
"SSN" - 주민등록번호 ( 사업자등록번호 )
"REFCODE" - 참조코드
"AUTHCODE" - 인가코드
"CERTTYPE" - 인증서 용도
"CERTCLASS" - 인증서 등급 ( always "0000")
"CORPCODE" - CORPCODE
 java.lang.String getResponseFromResultView(java.lang.String entry)
          발급기관으로 부터 전달받은 접수 처리 결과 정보를 얻는다. (
 java.security.cert.X509Certificate getUserCertificate()
          Deprecated requestCertificate 함수호출시 얻은 인증서를 리턴한다.
 byte[] getUserCertificateByte()
          Deprecated requestCertificate 함수호출시 얻은 인증서를 리턴한다.
 byte[] getUserPrivateKey()
          Deprecated requestCertificate 함수호출시 얻은 암호화된 개인키를 리턴한다.
 int modifyCertStatus(java.lang.String operatorId, java.lang.String cert_serial, java.lang.String service_code)
          발급기관에 사용자 인증서 상태 변경을 요청한다.
 int registerNewUser(java.lang.String operatorId, java.lang.String user_type, java.lang.String company_name, java.lang.String user_name, java.lang.String user_id, java.lang.String ssn, java.lang.String policy_type, java.lang.String email, java.lang.String cell_phone, java.lang.String fax, java.lang.String zipcode, java.lang.String address, java.lang.String phone, java.lang.String czipcode, java.lang.String caddress, java.lang.String cphone, java.lang.String cert_type, java.lang.String cert_class, java.lang.String corp_code)
          발급기관에 사용자 등록을 요청한다.
 int requestCertificate(java.lang.String ca_ip, int ca_port, java.lang.String ref_code, java.lang.String auth_code, java.lang.String class_id, int key_size, byte[] user_key_pwd)
          Deprecated (CMP 는 Client control에서 일괄 수행한다)공개키와 개인키를 생성하고 XecureCA 와 CMP 프로토콜을 진행하여 인증서를 발급받는다.
 int viewCertificate(java.lang.String operatorId, java.lang.String service_code, java.lang.String service_key, int rec_start_num, int rec_req_num)
          발급기관에 사용자 인증서 조회를 요청한다.
 int viewCertificate(java.lang.String operatorId, java.lang.String service_code, java.lang.String service_key, java.lang.String corp_code, int rec_start_num, int rec_req_num)
          발급기관에 사용자 인증서 조회를 요청한다.
 int viewRegisterUserResult(java.lang.String user_id)
          인증서 등록 결과 조회 요청 (아직 지원되지 않음)
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

XecureCAClient

public XecureCAClient(XecureExpConfig config)
XecureCAClient Constructor
Parameters:
config - xecure.exp.XecureExpConfig
Method Detail

requestCertificate

public int requestCertificate(java.lang.String ca_ip,
                              int ca_port,
                              java.lang.String ref_code,
                              java.lang.String auth_code,
                              java.lang.String class_id,
                              int key_size,
                              byte[] user_key_pwd)
Deprecated (CMP 는 Client control에서 일괄 수행한다)공개키와 개인키를 생성하고 XecureCA 와 CMP 프로토콜을 진행하여 인증서를 발급받는다. XecureCA 에 사용자 등록을 하면, 참조번호, 인가코드, 인증서 등급 정보를 받는다. 이 정보를 제공하고, 개인키를 암호화할 패스워드를 입력하면, 암호화된 개인키와 인증서를 얻는다. 개인키는 getUserPrivateKey() 함수로, 인증서는 getUserCertificate() 함수롤 얻을 수 있다.
Parameters:
ca_ip - String XecureCA IP 주소
ca_port - int XecureCA port
ref_code - String 참조코드
auth_code - String 인가코드
class_id - String 인증서 등급
key_size - int 키 사이즈 ( 64, 128, 256 bytes )
user_key_pwd - byte[] 개인키 암호 패스워드
Returns:
성공 : 0, 에러 : 0이 아닌 값 ( getLastError(), getLastErrorMsg() 참조 )
Throws:
java.security.cert.CertificateException, - java.io.IOException

getUserCertificate

public java.security.cert.X509Certificate getUserCertificate()
                                                      throws java.security.cert.CertificateException,
                                                             java.io.IOException
Deprecated requestCertificate 함수호출시 얻은 인증서를 리턴한다.
Returns:
X509Certificate

getUserCertificateByte

public byte[] getUserCertificateByte()
Deprecated requestCertificate 함수호출시 얻은 인증서를 리턴한다.
Returns:
X509Certificate der encoded byte array

getUserPrivateKey

public byte[] getUserPrivateKey()
Deprecated requestCertificate 함수호출시 얻은 암호화된 개인키를 리턴한다.
Returns:
encrypted private key

registerNewUser

public int registerNewUser(java.lang.String operatorId,
                           java.lang.String user_type,
                           java.lang.String company_name,
                           java.lang.String user_name,
                           java.lang.String user_id,
                           java.lang.String ssn,
                           java.lang.String policy_type,
                           java.lang.String email,
                           java.lang.String cell_phone,
                           java.lang.String fax,
                           java.lang.String zipcode,
                           java.lang.String address,
                           java.lang.String phone,
                           java.lang.String czipcode,
                           java.lang.String caddress,
                           java.lang.String cphone,
                           java.lang.String cert_type,
                           java.lang.String cert_class,
                           java.lang.String corp_code)
발급기관에 사용자 등록을 요청한다. 요청 결과는 getResponseFromRegUser 를 통해 얻는다.
Parameters:
operatorId - 단말기 운영자 ID ( 필수 )
user_type - 사용자 구분코드 ( 필수 ) 개인 : 1 , 법인 : 2
company_name - 법인, 단체명 ( 필수)
user_name - 개인명 , 법인단체 세부명 ( 필수, 한글 )
user_id - 개인/법인/단체 ID ( 필수 )
ssn - 주민등록번호/사업자등록번호 ( 필수 )
policy_type - 인증 정책 식별코드 - 개인용 : 01 , 법인/단체용 : 02 ( 사용안함 )
email - 전자우편 ( 옵션 )
cell_phone - 핸드폰 번호 ( 옵션 )
fax - 팩스 번호 ( 옵션 )
zipcode - 우편번호 ( 개인 필수, 법인/단체 옵션 )
address - 주소 ( 개인 필수, 법인/단체 옵션 )
phone - 전화번호 ( 개인 필수, 법인/단체 옵션 )
czipcode - 법인 우편번호 ( 법인/단체 필수, 개인 옵션 )
caddress - 법인 주소 ( 법인/단체 필수, 개인 옵션 )
cphone - 법인 전화번호 ( 법인/단체 필수, 개인 옵션 )
cert_type - 인증서 용도 ( XecureCA 설정값, 필수 )
cert_class - 인증서 등급 ( XecureCA 설정값, 필수 )
Returns:

0 : 성공
그외 : error (getLastError(), getLastErrorMsg() 참조)

getResponseFromRegUser

public java.lang.String getResponseFromRegUser(java.lang.String entry)
발급기관으로 부터 전달받은 사용자 등록결과 정보를 얻는다.
entry : "MESSAGE" - CA 로 부터 전달된 메시지
"REGDATE" - 등록 날짜
"REGSERIAL" - 등록 번호
"COMPANY" - 회사명
"USERNAME" - 사용자 명
"USERID" - 사용자 ID
"SSN" - 주민등록번호 ( 사업자등록번호 )
"REFCODE" - 참조코드
"AUTHCODE" - 인가코드
"CERTTYPE" - 인증서 용도
"CERTCLASS" - 인증서 등급 ( always "0000")
"CORPCODE" - CORPCODE
Returns:
value for entry

modifyCertStatus

public int modifyCertStatus(java.lang.String operatorId,
                            java.lang.String cert_serial,
                            java.lang.String service_code)
발급기관에 사용자 인증서 상태 변경을 요청한다.
Parameters:
operatorId - 단말기 운영자 ID
cert_serial - 인증서 일련번호
serivce_code -
"30" - 인증서 폐지
"40" - 인증서 효력정지
"41" - 인증서 효력회복
Returns:
0 : 성공
그외 : error (getLastError(), getLastErrorMsg() 참조)

viewCertificate

public int viewCertificate(java.lang.String operatorId,
                           java.lang.String service_code,
                           java.lang.String service_key,
                           int rec_start_num,
                           int rec_req_num)
발급기관에 사용자 인증서 조회를 요청한다.
Parameters:
operatorId - 단말기 운영자 ID
service_code - 조회구분코드, 조회구분
service_key - 조회구분코드에 대한 조회 정보 . 구분코드 1 - 인증서 일련번호(hex) (2 - 개인ID, 3 - 주민등록번호 은 현재 지원 안됨)
rec_start_num - 요청 레코드 시작 번호 ( 반드시 0 으로 지정 )
rec_req_num - 요청 레코드수, 20 을 초과할 수 없음 ( 반드시 1 로 지정 )
Returns:
0 보다 큰 수 : 리턴된 레코드 수
그외 : error (getLastError(), getLastErrorMsg() 참조)

viewCertificate

public int viewCertificate(java.lang.String operatorId,
                           java.lang.String service_code,
                           java.lang.String service_key,
                           java.lang.String corp_code,
                           int rec_start_num,
                           int rec_req_num)
발급기관에 사용자 인증서 조회를 요청한다.
Parameters:
operatorId - 단말기 운영자 ID
service_code - 조회구분코드, 조회구분
service_key - 조회구분코드에 대한 조회 정보 . 구분코드 1 - 인증서 일련번호(hex) 2 - 개인ID ( 3 - 주민등록번호 은 현재 지원 안됨)
corp_code - Corp Code (2 - 개인ID 에서 필요)
rec_start_num - 요청 레코드 시작 번호 ( 반드시 0 으로 지정 )
rec_req_num - 요청 레코드수, 20 을 초과할 수 없음 ( 반드시 1 로 지정 )
Returns:
0 보다 큰 수 : 리턴된 레코드 수
그외 : error (getLastError(), getLastErrorMsg() 참조)

getResponseFromCertView

public java.lang.Object getResponseFromCertView(java.lang.String entry,
                                                int index)
발급기관으로 부터 전달받은 사용자 인증서 조회 결과 정보를 얻는다.
Parameters:
entry - "SERIAL" - 인증서 일련번호
"USERID" - 사용자 ID
"USERDN" - 사용자 DN
"SSN" - 주민등록번호 ( 사업자등록번호 ), some CA not supported..
"VALIDFROM" - 유효기간 시작
"VALIDTO" - 유효기간 만료
"STATUS" - 인증서 상태 ( "10" 정상, "30" 폐지, "40" 효력정지 )
"CERTTYPE" - 인증서 용도 (0으로 fixed)
"CERTCLASS" - 인증서 등급 (0으로 fixed)
"RECNUM" - 레코드 번호 ( 미사용 )
"TOTALRECNUM" - 총 레코드 수 ( 미사용 )
index - : begin from 1
Returns:
value for entry

viewRegisterUserResult

public int viewRegisterUserResult(java.lang.String user_id)
인증서 등록 결과 조회 요청 (아직 지원되지 않음)
Parameters:
user_id - 사용자 ID
Returns:
0 : 성공
그외 : error (getLastError(), getLastErrorMsg() 참조)

getResponseFromResultView

public java.lang.String getResponseFromResultView(java.lang.String entry)
발급기관으로 부터 전달받은 접수 처리 결과 정보를 얻는다. (아직 지원되지 않음)
인증서 발급전일 경우 , REGTYPE 값으로 '1' 이 리턴된다.
COMPANY, USERNAME, USERID, SSN, REFCODE, AUTHCODE 값을 얻을 수 있다.
인증서 발급후일 경우, REGTYPE 값으로 '2' 가 리턴된다.
EVENTDATE, SERIAL, EVENTTYPE, VALIDFROM, VALIDTO, SSN, PUBKEY 값을 얻을 수 있다.
Parameters:
entry - "MESSAGE" - 응답메시지
"REGDATE" - 등록일시
"REGSERIAL" - 접수 일련번호
"REGTYPE" - 접수처리결과 타입코드 : '1' 인증서 발급전, '2' 인증서 발급후
"COMPANY" - 법인명
"USERNAME" - 개인명 , 법인단체 세부명
"USERID" - 개인 (법인) ID
"SSN" - 주민등록번호
"REFCODE" - 참조번호
"AUTHCODE" - 인가코드
"EVENTDATE" - 이벤트발생일
"SERIAL" - 인증서일련번호
"EVENTTYPE" - 이벤트 타입코드
"VALIDFROM" - 유효기간 시작
"VALIDTO" - 유효기간 종료
"CERTTYPE" - 인증서 용도
"CERTCLASS" - 인증서 등급
Returns:
value for entry

getLastError

public int getLastError()
발급기관으로부터 에러가 전송된 경우 에러코드가 리턴된다.
-1101 : missing user_type, user_id, ssn, cert type, cert class
-1102 : Invalid user type
-1103 : Invalid service code for cert view
-1123 : Request Record number cannot exceed 20.
-1131 : missing user_id

-3010 : config 설정 오류

-8031 ~ 32 : Can't read file
-37430 : INVALID_PASSWORD
-37480 : ENCODE_ASN ERR
-37481 : DECODE_ASN ERR

-70XX, -6XX : RMP ERR
-7026 : cannot connect server

그외...
Returns:
error code

getLastErrorMsg

public java.lang.String getLastErrorMsg()
발급기관으로부터 에러가 전송된 경우 에러 메시지가 리턴된다.
Returns:
error message