Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

xecure.crypto
Class PublicRA

java.lang.Object
  extended byxecure.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)
          등록기관으로 부터 전달받은 사용자 등록결과 정보를 얻는다.
 java.lang.String getResponseFromResultView(java.lang.String entry)
          등록기관으로 부터 전달받은 접수 처리 결과 정보를 얻는다.
 int modifyCertStatus(java.lang.String operatorId, java.lang.String policy_type, java.lang.String cert_serial, java.lang.String service_code)
          등록기관에 사용자 인증서 상태 변경을 요청한다.
 int modifyCertStatus(java.lang.String operatorId, java.lang.String policy_type, java.lang.String cert_serial, java.lang.String service_code, int flag)
          등록기관에 사용자 인증서 상태 변경을 요청한다.
 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 registerUpdateUser(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 policy_type, 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 policy_type, java.lang.String service_code, java.lang.String service_key, int rec_start_num, int rec_req_num, int flag)
          등록기관에 사용자 인증서 조회를 요청한다.
 int viewRegisterUserResult(java.lang.String reg_date, java.lang.String reg_serial, java.lang.String policy_type, java.lang.String user_id)
          접수 처리 결과 조회 요청
 
Methods inherited from class java.lang.Object
equals, 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 , 특수목적용 : 06 (필수)
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 , 특수목적용 : 06 (필수)
email - 전자우편 ( 옵션 )
cell_phone - 핸드폰 번호 ( 옵션 )
fax - 팩스 번호 ( 옵션 )
zipcode - 우편번호 ( 개인 필수, 법인/단체 옵션 )
address - 주소 ( 개인 필수, 법인/단체 옵션 )
phone - 전화번호 ( 개인 필수, 법인/단체 옵션 )
czipcode - 법인 우편번호 ( 법인/단체 필수, 개인 옵션 )
caddress - 법인 주소 ( 법인/단체 필수, 개인 옵션 )
cphone - 법인 전화번호 ( 법인/단체 필수, 개인 옵션 )
Returns:
0 : 성공, -1101 ~ -1107 : invalid input, -1201, -1203 : sfra 오류 - getLastErrorMsg()를 통해 에러메시지를 얻을 수 있다.

registerUpdateUser

public int registerUpdateUser(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 , 특수목적용 : 06 (필수)
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 를 통해 얻는다.

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" - 인가코드
"POLICYTYPE" - 인증서 정책 식별코드
"ROOTHASH" - 최상위 인증기관의 인증서 해쉬값

Returns:
value for entry

modifyCertStatus

public int modifyCertStatus(java.lang.String operatorId,
                            java.lang.String policy_type,
                            java.lang.String cert_serial,
                            java.lang.String service_code)
등록기관에 사용자 인증서 상태 변경을 요청한다.

Parameters:
operatorId - 단말기 운영자 ID
policy_type - 인증서 정책 식별코드
cert_serial - 인증서 일련번호 파라미터가 3개인 ModifyCertStatus 는 인증서 시리얼은 헥사임을 가정한다
정수를 사용할 경우에는 4개의 파라미터를 가지는 ModifyCertStatus 를 사용해야 한다
Returns:
0 : 성공, -1121 : invalid input, -1201, -1203 : sfra 오류 - getLastErrorMsg()를 통해 에러메시지를 얻을 수 있다.

modifyCertStatus

public int modifyCertStatus(java.lang.String operatorId,
                            java.lang.String policy_type,
                            java.lang.String cert_serial,
                            java.lang.String service_code,
                            int flag)
등록기관에 사용자 인증서 상태 변경을 요청한다.

Parameters:
operatorId - 단말기 운영자 ID
policy_type - 인증서 정책 식별코드
cert_serial - 인증서 일련번호
flag - 인증서 시리얼의 부가적인 정보 "1" - 인증서 시리얼이 헥사임을 나타낸다
"0" - 인증서 시리얼이 정수임을 나타낸다
Returns:
0 : 성공, -1121 : invalid input, -1201, -1203 : sfra 오류 - getLastErrorMsg()를 통해 에러메시지를 얻을 수 있다.

viewCertificate

public int viewCertificate(java.lang.String operatorId,
                           java.lang.String policy_type,
                           java.lang.String service_code,
                           java.lang.String service_key,
                           int rec_start_num,
                           int rec_req_num)
등록기관에 사용자 인증서 조회를 요청한다.

Parameters:
operatorId - 단말기 운영자 ID
policy_type - 인증서 정책 식별코드
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()를 통해 에러메시지를 얻을 수 있다.

viewCertificate

public int viewCertificate(java.lang.String operatorId,
                           java.lang.String policy_type,
                           java.lang.String service_code,
                           java.lang.String service_key,
                           int rec_start_num,
                           int rec_req_num,
                           int flag)
등록기관에 사용자 인증서 조회를 요청한다.

Parameters:
operatorId - 단말기 운영자 ID
policy_type - 인증서 정책 식별코드
service_code - 조회구분코드, 조회구분
service_key - 조회구분코드에 대한 조회 정보 . 구분코드 1 - 인증서 일련번호, 2 - 개인ID, 3 - 주민등록번호
rec_start_num - 요청 레코드 시작 번호
rec_req_num - 요청 레코드수, 20 을 초과할 수 없음
flag - 인증서 시리얼 플래그 플래그 0 - 정수형 시리얼 1- 헥사형 시리얼
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" - 총 레코드 수
"POLICYTYPE" - 인증정책 식별코드
index - : begin from 1
Returns:
value for entry

viewRegisterUserResult

public int viewRegisterUserResult(java.lang.String reg_date,
                                  java.lang.String reg_serial,
                                  java.lang.String policy_type,
                                  java.lang.String user_id)
접수 처리 결과 조회 요청

Parameters:
reg_date - 접수 날짜
reg_serial - 접수 등록 번호
policy_type - 인증정책 식별코드
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, POLICYTYPE, ROOTHASH 값을 얻을 수 있다.
인증서 발급후일 경우, REGTYPE 값으로 '2' 가 리턴된다.
EVENTDATE, SERIAL, EVENTTYPE, VALIDFROM, VALIDTO, SSN, POLICYTYPE, USERDN 값을 얻을 수 있다.

Parameters:
entry - "MESSAGE" - 응답메시지
"REGDATE" - 등록일시
"REGSERIAL" - 접수 일련번호
"REGTYPE" - 접수처리결과 타입코드 : '1' 인증서 발급전, '2' 인증서 발급후
"COMPANY" - 법인명
"USERNAME" - 개인명 , 법인단체 세부명
"USERID" - 개인 (법인) ID
"SSN" - 주민등록번호
"REFCODE" - 참조번호
"AUTHCODE" - 인가코드
"EVENTDATE" - 이벤트발생일
"SERIAL" - 인증서일련번호
"EVENTTYPE" - 이벤트 타입코드
"VALIDFROM" - 유효기간 시작
"VALIDTO" - 유효기간 종료
"USERDN" - 가입자 DN명
"POLICYTYPE" - 인증정책 식별코드
"ROOTHASH" - 최상위 인증기관의 인증서 해쉬값
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
Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD