xecure.crypto
Class PublicRA

java.lang.Object
  |
  +--xecure.crypto.PublicRA
public class PublicRA
extends java.lang.Object

이 클래스는 공인인증기관 연동 소프트포럼 등록기관의 인증서 서비스를 이용하는 함수들을 가진다.

Constructor Summary
PublicRA(XecureConfig config)
          constructs a new PublicRA
 
Method Summary
 int changeUserID(java.lang.String old_user_id, java.lang.String new_user_id)
           
 int getLastError()
          등록기관으로 부터 에러가 전송된 경우 에러코드가 리턴된다.
 java.lang.String getLastErrorMsg()
          등록기관으로 부터 에러가 전송된 경우 에러 메시지가 리턴된다.
 java.lang.Object getResponseFromCertView(java.lang.String entry, int index)
          등록기관으로 부터 전달받은 사용자 인증서 조회 결과 정보를 얻는다.
 java.lang.String getResponseFromChangeUserID(java.lang.String entry)
           
 java.lang.String getResponseFromRegUser(java.lang.String entry)
          등록기관으로 부터 전달받은 사용자 등록결과 정보를 얻는다.
entry : "MESSAGE" - CA 로 부터 전달된 메시지
"REGDATE" - 등록 날짜
"REGSERIAL" - 등록 번호
"COMPANY" - 회사명
"USERNAME" - 사용자 명
"USERID" - 사용자 ID
"SSN" - 주민등록번호 ( 사업자등록번호 )
"REFCODE" - 참조코드
"AUTHCODE" - 인가코드
 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 값을 얻을 수 있다.
 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 euser_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)
          등록기관에 사용자 등록을 요청한다.
 int registerNlNewUser(java.lang.String UserId, java.lang.String certSerial, java.lang.String reserved1, java.lang.String reserved2, java.lang.String reserved3)
          등록기관에 사용자 등록을 요청한다.
 int registerRenewUser(java.lang.String operatorId, java.lang.String user_type, java.lang.String company_name, java.lang.String user_name, java.lang.String euser_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)
          등록기관에 사용자 재등록을 요청한다.
 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 viewRegisterUserResult(java.lang.String reg_date, java.lang.String reg_serial)
          접수 처리 결과 조회 요청
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PublicRA

public PublicRA(XecureConfig config)
constructs a new PublicRA
Parameters:
config - XecureConfig reference
Method Detail

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 euser_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)
등록기관에 사용자 등록을 요청한다. 요청 결과는 getResponseFromRegUser 를 통해 얻는다.
Parameters:
operatorId - 단말기 운영자 ID ( 필수 )
user_type - 사용자 구분코드 ( 필수 ) 개인 : 1 , 법인 : 2 , 단체 : 3
company_name - 법인, 단체명 ( 필수, 영문, 개인 사용안함 )
user_name - 개인명 , 법인단체 세부명 ( 필수, 한글 )
euser_name - 개인 영문명 , 법인단체 영문명 ( 필수 )
user_id - 개인/법인/단체 ID ( 필수 )
ssn - 주민등록번호/사업자등록번호 ( 필수 )
policy_type - 인증 정책 식별코드 - 개인용 : 01 , 법인/단체용 : 02 ( 필수 )
email - 전자우편 ( 옵션 )
cell_phone - 핸드폰 번호 ( 옵션 )
fax - 팩스 번호 ( 옵션 )
zipcode - 우편번호 ( 개인 필수, 법인/단체 옵션 )
address - 주소 ( 개인 필수, 법인/단체 옵션 )
phone - 전화번호 ( 개인 필수, 법인/단체 옵션 )
czipcode - 법인 우편번호 ( 법인/단체 필수, 개인 옵션 )
caddress - 법인 주소 ( 법인/단체 필수, 개인 옵션 )
cphone - 법인 전화번호 ( 법인/단체 필수, 개인 옵션 )
Returns:
0 : 성공, -1101 ~ -1107 : invalid input, -1201, -1203 : sfra 오류 - getLastErrorMsg()를 통해 에러메시지를 얻을 수 있다.

registerRenewUser

public int registerRenewUser(java.lang.String operatorId,
                             java.lang.String user_type,
                             java.lang.String company_name,
                             java.lang.String user_name,
                             java.lang.String euser_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)
등록기관에 사용자 재등록을 요청한다. 요청 결과는 getResponseFromRegUser 를 통해 얻는다.
Parameters:
operatorId - 단말기 운영자 ID ( 필수 )
user_type - 사용자 구분코드 ( 필수 ) 개인 : 1 , 법인 : 2 , 단체 : 3
company_name - 법인, 단체명 ( 필수, 영문, 개인 사용안함 )
user_name - 개인명 , 법인단체 세부명 ( 필수, 한글 )
euser_name - 개인 영문명 , 법인단체 영문명 ( 필수 )
user_id - 개인/법인/단체 ID ( 필수 )
ssn - 주민등록번호/사업자등록번호 ( 필수 )
policy_type - 인증 정책 식별코드 - 개인용 : 01 , 법인/단체용 : 02 ( 필수 )
email - 전자우편 ( 옵션 )
cell_phone - 핸드폰 번호 ( 옵션 )
fax - 팩스 번호 ( 옵션 )
zipcode - 우편번호 ( 개인 필수, 법인/단체 옵션 )
address - 주소 ( 개인 필수, 법인/단체 옵션 )
phone - 전화번호 ( 개인 필수, 법인/단체 옵션 )
czipcode - 법인 우편번호 ( 법인/단체 필수, 개인 옵션 )
caddress - 법인 주소 ( 법인/단체 필수, 개인 옵션 )
cphone - 법인 전화번호 ( 법인/단체 필수, 개인 옵션 )
Returns:
0 : 성공, -1101 ~ -1107 : invalid input, -1201, -1203 : sfra 오류 - getLastErrorMsg()를 통해 에러메시지를 얻을 수 있다.

registerNlNewUser

public int registerNlNewUser(java.lang.String UserId,
                             java.lang.String certSerial,
                             java.lang.String reserved1,
                             java.lang.String reserved2,
                             java.lang.String reserved3)
등록기관에 사용자 등록을 요청한다. 요청 결과는 getResponseFromRegUser 를 통해 얻는다.
Parameters:
operatorId - 단말기 운영자 ID ( 필수 )
user_type - 사용자 구분코드 ( 필수 ) 개인 : 1 , 법인 : 2 , 단체 : 3
company_name - 법인, 단체명 ( 필수, 영문, 개인 사용안함 )
user_name - 개인명 , 법인단체 세부명 ( 필수, 한글 )
euser_name - 개인 영문명 , 법인단체 영문명 ( 필수 )
user_id - 개인/법인/단체 ID ( 필수 )
ssn - 주민등록번호/사업자등록번호 ( 필수 )
policy_type - 인증 정책 식별코드 - 개인용 : 01 , 법인/단체용 : 02 ( 필수 )
email - 전자우편 ( 옵션 )
cell_phone - 핸드폰 번호 ( 옵션 )
fax - 팩스 번호 ( 옵션 )
zipcode - 우편번호 ( 개인 필수, 법인/단체 옵션 )
address - 주소 ( 개인 필수, 법인/단체 옵션 )
phone - 전화번호 ( 개인 필수, 법인/단체 옵션 )
czipcode - 법인 우편번호 ( 법인/단체 필수, 개인 옵션 )
caddress - 법인 주소 ( 법인/단체 필수, 개인 옵션 )
cphone - 법인 전화번호 ( 법인/단체 필수, 개인 옵션 )
Returns:
0 : 성공, -1101 ~ -1107 : invalid input, -1201, -1203 : sfra 오류 - getLastErrorMsg()를 통해 에러메시지를 얻을 수 있다.

getResponseFromRegUser

public java.lang.String getResponseFromRegUser(java.lang.String entry)
등록기관으로 부터 전달받은 사용자 등록결과 정보를 얻는다.
entry : "MESSAGE" - CA 로 부터 전달된 메시지
"REGDATE" - 등록 날짜
"REGSERIAL" - 등록 번호
"COMPANY" - 회사명
"USERNAME" - 사용자 명
"USERID" - 사용자 ID
"SSN" - 주민등록번호 ( 사업자등록번호 )
"REFCODE" - 참조코드
"AUTHCODE" - 인가코드
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 : 성공, -1121 : invalid input, -1201, -1203 : sfra 오류 - 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 - 인증서 일련번호, 2 - 개인ID, 3 - 주민등록번호
rec_start_num - 요청 레코드 시작 번호
rec_req_num - 요청 레코드수, 20 을 초과할 수 없음
Returns:
0 보다 큰 수 : 리턴된 레코드 수
-1122 : invalid serivce code
-1123 : invalid request record number. It cannot exceed 20.
-1201, -1203 : sfra 오류 - getLastErrorMsg()를 통해 에러메시지를 얻을 수 있다.

getResponseFromCertView

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

viewRegisterUserResult

public int viewRegisterUserResult(java.lang.String reg_date,
                                  java.lang.String reg_serial)
접수 처리 결과 조회 요청
Parameters:
reg_date - 접수 날짜
reg_serial - 접수 등록 번호
Returns:
0 : 성공
-1131 : 등록일시와 접수일련번호 입력 오류
-1201, -1203 : sfra 오류 - 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" - 유효기간 종료
"PUBKEY" - 전자서명 검증키
Returns:
value for entry

changeUserID

public int changeUserID(java.lang.String old_user_id,
                        java.lang.String new_user_id)

getResponseFromChangeUserID

public java.lang.String getResponseFromChangeUserID(java.lang.String entry)

getLastError

public int getLastError()
등록기관으로 부터 에러가 전송된 경우 에러코드가 리턴된다.
-1101 : missing user_type, user_name, user_id, ssn, policy_type
-1102 : People Cert requires zipcode, address, phone field.
-1103 : Company Cert requires company_name, company zipcode, company address, company phone field.
-1104 : Invalid user type
-1105 : Invalid policy type
-1106 : People Cert requires policy type '01'
-1107 : Company Cert requires policy type '02'
-1121 : Invalid service code for modification of cert status
-1122 : invalid serivce code for viewCertificate
-1123 : invalid request record number. It cannot exceed 20.
-1131 : 등록일시와 접수일련번호 입력 오류

-1201 : RA 서비스 처리 상에서의 에러
-1202 : 메모리 에러
-1203 : CA, RA 와의 커넥션 상에서의 에러
Returns:
error code

getLastErrorMsg

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