xecure.crypto
Class PrivateRA

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

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

Constructor Summary
PrivateRA(XecureConfig config)
          constructs a new PrivateRA
 
Method Summary
 Certificate getCertificate(java.lang.String id)
          등록기관에 인증서를 요청한다.
 int getLastError()
          등록기관으로 부터 에러가 전송된 경우 에러코드가 리턴된다.
-2001 : 사설등록기관 호스트명 에러
-2002 : 사설등록기관 소켓 생성 실패
-2003 : 사설등록기관 소켓 연결 실패
-2004 : 사설등록기관 소켓 데이타 읽기 실패
-2005 : 사설등록기관 소켓 데이타 쓰기 실패
-2006 : 사설등록기관 RSA 암호 실패
-2007 : 사설등록기관 RSA 복호 실패
-2008 : 사설등록기관 내부 오류
-2009 : 사설등록기관 잘못된 메시지
-2011 : 사설등록기관 서버 인증서 읽기 오류
-2012 : 사설등록기관 서버 개인키 읽기 오류
-2013 : 사설등록기관 인증서 읽기 오류
-2014 : 사설등록기관 서버 인증서 형식 오류
-2015 : 사설등록기관 서버 개인키 읽기 오류
-2016 : 사설등록기관 인증서 읽기 오류
-2017 : 사설등록기관 프로토콜 오류
-2018 : 사설등록기관 전달 인수 부족 오류
-2019 : 사설등록기관 인증요구서 생성 오류
-2020 : 사설등록기관 잘못된 인증기관 메시지 오류
-2021 : 사설등록기관 인증 서비스 요청 실패
-2025 : 사설등록기관 메시지 암호 실패
-2026 : 사설등록기관 메시지 복호 실패
-3000 : 사설등록기관 입력 변수 부족 오류
-3010 : 서버 Xecure 설정 파일 오류
 java.lang.String getLastErrorMsg()
          등록기관으로 부터 에러가 전송된 경우 에러 메시지가 리턴된다.
 Certificate renewCertificate(java.lang.String certRequest, java.lang.String id, java.lang.String name, java.lang.String nation, java.lang.String address, java.lang.String organization, java.lang.String unit, java.lang.String email)
          등록기관에 인증서 갱신 요청을 한다.
 Certificate replaceCertificate(java.lang.String certRequest, java.lang.String id, java.lang.String name, java.lang.String nation, java.lang.String address, java.lang.String organization, java.lang.String unit, java.lang.String email)
          등록기관에 인증서 교체 요청을 한다.
 Certificate requestCertificate(java.lang.String certRequest, java.lang.String id, java.lang.String name, java.lang.String nation, java.lang.String address, java.lang.String organization, java.lang.String unit, java.lang.String email)
          등록기관에 인증서 발급 요청을 한다.
 java.lang.String revokeCertificate(java.lang.String id)
          등록기관에 인증서 폐기 요청을 한다.
 Certificate updateCertificate(java.lang.String id, java.lang.String name, java.lang.String nation, java.lang.String address, java.lang.String organization, java.lang.String unit, java.lang.String email)
          등록기관에 인증서 변경 요청을 한다.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PrivateRA

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

requestCertificate

public Certificate requestCertificate(java.lang.String certRequest,
                                      java.lang.String id,
                                      java.lang.String name,
                                      java.lang.String nation,
                                      java.lang.String address,
                                      java.lang.String organization,
                                      java.lang.String unit,
                                      java.lang.String email)
등록기관에 인증서 발급 요청을 한다. 등록기관은 인증기관에 인증서 발급을 요청하고 인증서를 받아 전달한다. 전달된 인증서는 Certificate object 로 리턴된다.
등록기관으로 부터 에러가 전송될 경우 null 이 리턴된다. getLastError 와 getLastErrorMsg 함수에서 에러 코드와 에러 메시지를 얻을 수 있다.
Parameters:
certRequest - 클라이언트로 부터 전달된 공개키 정보, 반드시 전달되어야 한다. null 이면 안된다.
id - 인증서 요청자의 ID, 반드시 전달되어야 한다. null 이면 안된다.
name - 인증서 요청자의 이름, 반드시 전달되어야 한다. null 이면 안된다.
nation - 인증서 요청자의 국가 코드, 반드시 전달되어야 한다. null 이면 안된다.
address - 인증서 요청자의 주소
organization - 인증서 요청자의 기관명
unit - 인증서 요청자의 부서명
email - 인증서 요청자의 email 주소
Returns:
발급된 인증서

replaceCertificate

public Certificate replaceCertificate(java.lang.String certRequest,
                                      java.lang.String id,
                                      java.lang.String name,
                                      java.lang.String nation,
                                      java.lang.String address,
                                      java.lang.String organization,
                                      java.lang.String unit,
                                      java.lang.String email)
등록기관에 인증서 교체 요청을 한다. 등록기관은 인증기관에 인증서 교체을 요청하고 인증서를 받아 전달한다. 전달된 인증서는 Certificate object 로 리턴된다.
인증서 교체는 이미 발급된 인증서에 대해서 공개키/개인키 정보를 교체하는 서비스이다.
등록기관으로 부터 에러가 전송될 경우 null 이 리턴된다. getLastError 와 getLastErrorMsg 함수에서 에러 코드와 에러 메시지를 얻을 수 있다.
Parameters:
certRequest - 클라이언트로 부터 전달된 공개키 정보, 반드시 전달되어야 한다. null 이면 안된다.
id - 인증서 요청자의 ID, 반드시 전달되어야 한다. null 이면 안된다.
name - 인증서 요청자의 이름, 반드시 전달되어야 한다. null 이면 안된다.
nation - 인증서 요청자의 국가 코드, 반드시 전달되어야 한다. null 이면 안된다.
address - 인증서 요청자의 주소
organization - 인증서 요청자의 기관명
unit - 인증서 요청자의 부서명
email - 인증서 요청자의 email 주소
Returns:
발급된 인증서

renewCertificate

public Certificate renewCertificate(java.lang.String certRequest,
                                    java.lang.String id,
                                    java.lang.String name,
                                    java.lang.String nation,
                                    java.lang.String address,
                                    java.lang.String organization,
                                    java.lang.String unit,
                                    java.lang.String email)
등록기관에 인증서 갱신 요청을 한다. 등록기관은 인증기관에 인증서 갱신을 요청하고 인증서를 받아 전달한다. 전달된 인증서는 Certificate object 로 리턴된다.
인증서 갱신은 이미 발급된 인증서에 대해서 유효기간을 연장하는 서비스이다.
등록기관으로 부터 에러가 전송될 경우 null 이 리턴된다. getLastError 와 getLastErrorMsg 함수에서 에러 코드와 에러 메시지를 얻을 수 있다.
Parameters:
certRequest - 클라이언트로 부터 전달된 공개키 정보, 반드시 전달되어야 한다. null 이면 안된다.
id - 인증서 요청자의 ID, 반드시 전달되어야 한다. null 이면 안된다.
name - 인증서 요청자의 이름, 반드시 전달되어야 한다. null 이면 안된다.
nation - 인증서 요청자의 국가 코드, 반드시 전달되어야 한다. null 이면 안된다.
address - 인증서 요청자의 주소
organization - 인증서 요청자의 기관명
unit - 인증서 요청자의 부서명
email - 인증서 요청자의 email 주소
Returns:
발급된 인증서

updateCertificate

public Certificate updateCertificate(java.lang.String id,
                                     java.lang.String name,
                                     java.lang.String nation,
                                     java.lang.String address,
                                     java.lang.String organization,
                                     java.lang.String unit,
                                     java.lang.String email)
등록기관에 인증서 변경 요청을 한다. 등록기관은 인증기관에 인증서 변경을 요청하고 인증서를 받아 전달한다. 전달된 인증서는 Certificate object 로 리턴된다.
인증서 변경은 이미 발급된 인증서에 대해서 인증서 내부 정보를 변경하는 서비스이다.
등록기관으로 부터 에러가 전송될 경우 null 이 리턴된다. getLastError 와 getLastErrorMsg 함수에서 에러 코드와 에러 메시지를 얻을 수 있다.
Parameters:
id - 인증서 요청자의 ID, 반드시 전달되어야 한다. null 이면 안된다.
name - 인증서 요청자의 이름, 반드시 전달되어야 한다. null 이면 안된다.
nation - 인증서 요청자의 국가 코드, 반드시 전달되어야 한다. null 이면 안된다.
address - 인증서 요청자의 주소
organization - 인증서 요청자의 기관명
unit - 인증서 요청자의 부서명
email - 인증서 요청자의 email 주소
Returns:
발급된 인증서

revokeCertificate

public java.lang.String revokeCertificate(java.lang.String id)
등록기관에 인증서 폐기 요청을 한다. 등록기관은 인증기관에 인증서 폐기를 요청하고 결과 메시지를 얻는다.
등록기관으로 부터 에러가 전송될 경우 null 이 리턴된다. getLastError 와 getLastErrorMsg 함수에서 에러 코드와 에러 메시지를 얻을 수 있다.
Parameters:
id - 인증서 폐기자의 ID, 반드시 전달되어야 한다. null 이면 안된다.
Returns:
폐기 결과 메시지

getCertificate

public Certificate getCertificate(java.lang.String id)
등록기관에 인증서를 요청한다. 요청하는 인증서는 ID 로 찾는다.
등록기관으로 부터 에러가 전송될 경우 null 이 리턴된다. getLastError 와 getLastErrorMsg 함수에서 에러 코드와 에러 메시지를 얻을 수 있다.
Parameters:
id - 찾고자 하는 사용자의 id
Returns:
인증서 Certificate object

getLastError

public int getLastError()
등록기관으로 부터 에러가 전송된 경우 에러코드가 리턴된다.
-2001 : 사설등록기관 호스트명 에러
-2002 : 사설등록기관 소켓 생성 실패
-2003 : 사설등록기관 소켓 연결 실패
-2004 : 사설등록기관 소켓 데이타 읽기 실패
-2005 : 사설등록기관 소켓 데이타 쓰기 실패
-2006 : 사설등록기관 RSA 암호 실패
-2007 : 사설등록기관 RSA 복호 실패
-2008 : 사설등록기관 내부 오류
-2009 : 사설등록기관 잘못된 메시지
-2011 : 사설등록기관 서버 인증서 읽기 오류
-2012 : 사설등록기관 서버 개인키 읽기 오류
-2013 : 사설등록기관 인증서 읽기 오류
-2014 : 사설등록기관 서버 인증서 형식 오류
-2015 : 사설등록기관 서버 개인키 읽기 오류
-2016 : 사설등록기관 인증서 읽기 오류
-2017 : 사설등록기관 프로토콜 오류
-2018 : 사설등록기관 전달 인수 부족 오류
-2019 : 사설등록기관 인증요구서 생성 오류
-2020 : 사설등록기관 잘못된 인증기관 메시지 오류
-2021 : 사설등록기관 인증 서비스 요청 실패
-2025 : 사설등록기관 메시지 암호 실패
-2026 : 사설등록기관 메시지 복호 실패
-3000 : 사설등록기관 입력 변수 부족 오류
-3010 : 서버 Xecure 설정 파일 오류
Returns:
error code

getLastErrorMsg

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