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

com.dreamsecurity.jcaos.x509
Class X509CertVerifier

java.lang.Object
  extended bycom.dreamsecurity.jcaos.x509.X509CertVerifier
public class X509CertVerifier
extends java.lang.Object

인증서를 검증한다.

인증서 검증은 다음 과정으로 진행된다.

1. 인증기관 인증서 목록(인증서 경로) 획득
2. 인증서 경로 구축
3. 최상위 인증서 신뢰 여부 확인
4. 인증서 경로 검증
5. 인증서 폐지 여부 확인

Since:
1.0.0.0

Field Summary
static int DONT_CACHE_ARL
          인증서 검증 시 ARL에 대해서 캐쉬를 사용하지 않도록 한다.
static int DONT_CACHE_CAPUBS
          인증서 검증 시 인증 경로에 대해서 캐쉬를 사용하지 않도록 한다.
static int DONT_CACHE_CRL
          인증서 검증 시 CRL에 대해서 캐쉬를 사용하지 않도록 한다.
static int DONT_CACHE_CTL
          인증서 검증 시 CTL에 대해서 캐쉬를 사용하지 않도록 한다.
static int RANGE_FULL_PATH
          인증서 검증 시, 최상위 인증서 부터 최하위(사용자) 인증서까지 전체 경로를 검증한다.
static int RANGE_USER_CERT_ONLY
          인증서 검증 시, 사용자 인증서만을 검증한다.
static int REVOCATION_CHECK_BY_ARL
          인증 경로의 인증기관 인증서 폐지 여부를 인증서 폐지 목록을 이용하여 확인하도록 한다.
static int REVOCATION_CHECK_BY_CRL
          인증 경로의 사용자 인증서 폐지 여부를 인증서 폐지 목록을 이용하여 확인하도록 한다.
static int REVOCATION_CHECK_BY_OCSP
          인증 경로의 사용자 인증서 폐지 여부를 OCSP를 이용하여 확인하도록 한다.
static int REVOCATION_CHECK_NONE
          인증 경로의 모든 인증서 폐지 여부를 확인하지 않도록 한다.
 
Constructor Summary
X509CertVerifier(java.util.Properties env, java.lang.String work_dir)
          인증서 검증을 위한 환경 정보와 작업 경로를 설정하여 X509CertVerifier 클래스를 초기화한다.
 
Method Summary
 void dontUseCache(int dontCache)
          인증서 검증시 사용되는 신뢰 목록, 폐지 목록, 인증서 경로의 저장여부를 설정한다.
 java.lang.Object getRevocationInfo()
          인증서가 폐지된 경우 폐지 정보를 확인한다.
 X509CertPath obtainCertPath(X509Certificate userCert)
          상위 인증서의 경로를 획득한다.
 void setARL(X509CRL arl)
          로컬에 따로 저장해둔 ARL을 사용하고자 하는 경우에 설정한다.
 void setCaPubs(X509CertPath capubs)
          로컬에 따로 저장해둔 인증기관 인증서 목록을 사용하고자 하는 경우에 설정한다.
 void setCertType(java.lang.String type)
          검증하는 인증서의 종류를 설정한다.
 void setCRL(X509CRL crl)
          로컬에 따로 저장해둔 CRL을 사용하고자 하는 경우에 설정한다.
 void setIPS(java.lang.String[] ips)
          수용하는 인증서 정책 집합을 설정한다.
 void setOCSPRequesterCert(X509Certificate cert, PKCS8PrivateKeyInfo priKey)
          OCSP를 이용하여 폐지여부를 확인할때 요청 메시지 서명을 위해서 필요한 요청자의 인증서와 개인키를 설정한다.
 void setRevocationCheckMethod(int method)
          인증서 검증 시, 폐지 여부 확인 방법을 설정한다.
 void setTimeOut(int millisecs)
          OCSP와의 통신 또는 http,ldap 서버에 게시되어있는 데이터 획득 시, TimeOut을 설정한다.
 void setTimeToVerify(java.util.Date date)
          인증서를 검증하는 시점을 설정한다.
 void setTrustedAnchors(java.util.ArrayList certs)
          신뢰하는 최상위 인증서 집합을 설정한다.
 void setVerifyRange(int range)
          인증서 검증 시 검증 범위를 지정한다.
 void verify(X509Certificate cert)
          인증서를 검증한다.
 void verifyStrictly()
          인증서 검증 시, 인증서 규격에 맞에 엄격하게 확인하고자 하는 경우에 지정
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

REVOCATION_CHECK_NONE

public static final int REVOCATION_CHECK_NONE
인증 경로의 모든 인증서 폐지 여부를 확인하지 않도록 한다.

See Also:
setRevocationCheckMethod(int), Constant Field Values

REVOCATION_CHECK_BY_ARL

public static final int REVOCATION_CHECK_BY_ARL
인증 경로의 인증기관 인증서 폐지 여부를 인증서 폐지 목록을 이용하여 확인하도록 한다.

See Also:
setRevocationCheckMethod(int), Constant Field Values

REVOCATION_CHECK_BY_CRL

public static final int REVOCATION_CHECK_BY_CRL
인증 경로의 사용자 인증서 폐지 여부를 인증서 폐지 목록을 이용하여 확인하도록 한다.

See Also:
setRevocationCheckMethod(int), Constant Field Values

REVOCATION_CHECK_BY_OCSP

public static final int REVOCATION_CHECK_BY_OCSP
인증 경로의 사용자 인증서 폐지 여부를 OCSP를 이용하여 확인하도록 한다.

See Also:
setRevocationCheckMethod(int), Constant Field Values

DONT_CACHE_CAPUBS

public static final int DONT_CACHE_CAPUBS
인증서 검증 시 인증 경로에 대해서 캐쉬를 사용하지 않도록 한다.

See Also:
dontUseCache(int), Constant Field Values

DONT_CACHE_CTL

public static final int DONT_CACHE_CTL
인증서 검증 시 CTL에 대해서 캐쉬를 사용하지 않도록 한다.

See Also:
dontUseCache(int), Constant Field Values

DONT_CACHE_ARL

public static final int DONT_CACHE_ARL
인증서 검증 시 ARL에 대해서 캐쉬를 사용하지 않도록 한다.

See Also:
dontUseCache(int), Constant Field Values

DONT_CACHE_CRL

public static final int DONT_CACHE_CRL
인증서 검증 시 CRL에 대해서 캐쉬를 사용하지 않도록 한다.

See Also:
dontUseCache(int), Constant Field Values

RANGE_FULL_PATH

public static final int RANGE_FULL_PATH
인증서 검증 시, 최상위 인증서 부터 최하위(사용자) 인증서까지 전체 경로를 검증한다. (기본값)

See Also:
setVerifyRange(int), Constant Field Values

RANGE_USER_CERT_ONLY

public static final int RANGE_USER_CERT_ONLY
인증서 검증 시, 사용자 인증서만을 검증한다.
항목 확인 내용
경로 구축 발급자 인증서까지 구축
최상위 인증기관 신뢰 여부 신뢰 여부 확인하지 않음
검증 범위 사용자 인증서의 발급자 이름, 서명값, 유효기간
폐지여부 확인 사용자 인증서의 폐지여부만 확인(옵션에 따라 CRL 또는 OCSP 또는 하지 않음)

See Also:
setVerifyRange(int), Constant Field Values
Constructor Detail

X509CertVerifier

public X509CertVerifier(java.util.Properties env,
                        java.lang.String work_dir)
인증서 검증을 위한 환경 정보와 작업 경로를 설정하여 X509CertVerifier 클래스를 초기화한다. 작업 경로에는 인증서 검증시 사용되는 정보를 저장하기 위한 캐쉬 위치가 된다.

Parameters:
env - Properities 형식의 환경 정보
work_dir - 작업 경로
Method Detail

verifyStrictly

public void verifyStrictly()
인증서 검증 시, 인증서 규격에 맞에 엄격하게 확인하고자 하는 경우에 지정

setIPS

public void setIPS(java.lang.String[] ips)
수용하는 인증서 정책 집합을 설정한다. 각 인증서 정책은 OID("1.2.3.4.5") 형식이어야 한다. 해당 값을 지정하지 않으면 모든 인증서를 수용한다.

Parameters:
ips - String 배열 형식의 인증서 정책 집합

setCertType

public void setCertType(java.lang.String type)
검증하는 인증서의 종류를 설정한다. 해당 값을 지정하지 않으면 모든 종류의 인증서를 수용한다.

Parameters:
type - 검증하는 인증서 종류 ("sign", "km", "ocsp", "tsa")

setTimeToVerify

public void setTimeToVerify(java.util.Date date)
인증서를 검증하는 시점을 설정한다. 해당 값을 지정하지 않으면 시스템의 현재 시간을 기준으로 검증한다.

Parameters:
date - 인증서 검증 시점

setTrustedAnchors

public void setTrustedAnchors(java.util.ArrayList certs)
신뢰하는 최상위 인증서 집합을 설정한다. 해당 값은 반드시 지정해 주어야 한다.

Parameters:
certs - 신뢰하는 최상위 인증서 집합

dontUseCache

public void dontUseCache(int dontCache)
인증서 검증시 사용되는 신뢰 목록, 폐지 목록, 인증서 경로의 저장여부를 설정한다. 지정하지 않으면 모든 정보를 캐쉬에 저장한다. 이때 캐쉬 위치는 클래스 초기화시 지정한 작업 경로에 "cache" 디렉토리를 생성하여 해당 위치에 저장된다.

Parameters:
dontCache - 저장하지 않을 항목을 설정한다.

setVerifyRange

public void setVerifyRange(int range)
인증서 검증 시 검증 범위를 지정한다. 지정하지 않으면 전체 경로(RANGE_FULL_PATH)를 검증한다.

Parameters:
range - 인증서 검증 범위
Since:
1.4.1.0

setCaPubs

public void setCaPubs(X509CertPath capubs)
로컬에 따로 저장해둔 인증기관 인증서 목록을 사용하고자 하는 경우에 설정한다. 지정하지 않으면 환경파일을 이용하여 인증경로를 획득한다.

Parameters:
capubs - 인증기관 인증서 목록

setCRL

public void setCRL(X509CRL crl)
로컬에 따로 저장해둔 CRL을 사용하고자 하는 경우에 설정한다. 지정하지 않으면 사용자 인증서에 있는 CRL 배포지점을 이용하여 CRL을 획득한다.

Parameters:
crl - 사용자 인증서 폐지목록

setARL

public void setARL(X509CRL arl)
로컬에 따로 저장해둔 ARL을 사용하고자 하는 경우에 설정한다. 지정하지 않으면 인증기관 인증서에 있는 CRL 배포지점을 이용하여 ARL을 획득한다.

Parameters:
arl - 인증기관 인증서 폐지목록

setRevocationCheckMethod

public void setRevocationCheckMethod(int method)
인증서 검증 시, 폐지 여부 확인 방법을 설정한다. 지정하지 않으면 인증기관 인증서는 ARL을 이용하고 사용자 인증서는 OCSP를 이용하여 확인한다. 만약 OCSP 사용을 실패하면 CRL을 이용한다.

Parameters:
method - 폐지 여부 확인 방법

setOCSPRequesterCert

public void setOCSPRequesterCert(X509Certificate cert,
                                 PKCS8PrivateKeyInfo priKey)
OCSP를 이용하여 폐지여부를 확인할때 요청 메시지 서명을 위해서 필요한 요청자의 인증서와 개인키를 설정한다. OCSP를 이용하여 폐지여부를 확인하고자 하는 경우에는 해당 값을 지정할것을 권고한다.

Parameters:
cert - 요청자의 서명용 인증서
priKey - 요청자의 서명용 개인키

setTimeOut

public void setTimeOut(int millisecs)
OCSP와의 통신 또는 http,ldap 서버에 게시되어있는 데이터 획득 시, TimeOut을 설정한다.

verify

public void verify(X509Certificate cert)
            throws ObtainCertPathException,
                   BuildCertPathException,
                   TrustRootException,
                   ValidateCertPathException,
                   RevokedCertException,
                   RevocationCheckException,
                   java.security.cert.CertificateNotYetValidException,
                   java.security.cert.CertificateExpiredException
인증서를 검증한다.

Parameters:
cert - 검증할 인증서
Throws:
ObtainCertPathException - 인증서 경로를 획득하는데 실패한 경우에 발생
BuildCertPathException - 인증서 경로를 구축하는데 실패한 경우에 발생
TrustRootException - 인증서 경로의 최상위 인증기관 인증서를 신뢰할 수 없는 경우에 발생
ValidateCertPathException - 인증서 경로를 검증하는데 실패한 경우에 발생
RevokedCertException - 인증서 경로 중 폐지된 인증서가 있는 경우에 발생
RevocationCheckException - 인증서 경로의 폐지 여부를 확인하는데 실패한 경우에 발생
java.security.cert.CertificateNotYetValidException - 인증서 경로 중 아직 유효하지 않은 인증서가 있는 경우에 발생
java.security.cert.CertificateExpiredException - 인증서 경로 중 만료된 인증서가 있는 경우에 발생

getRevocationInfo

public java.lang.Object getRevocationInfo()
인증서가 폐지된 경우 폐지 정보를 확인한다. CRL(ARL)을 이용하여 폐지 여부를 확인한 경우에는 X509CRLEntry, OCSP를 이용하여 폐지 여부를 확인한 경우에는 SingleResponse 형태로 리턴된다.

Returns:
X509CRLEntry, SingleResponse 형식의 폐지 정보

obtainCertPath

public X509CertPath obtainCertPath(X509Certificate userCert)
                            throws ObtainCertPathException
상위 인증서의 경로를 획득한다.

Parameters:
userCert - 싱위 인증서 경로를 획득하고자 하는 하위(사용자) 인증서
Returns:
인증서 경로
Throws:
ObtainCertPathException - 경로 획득 실패시 발생
Overview  Package   Class  Tree  Deprecated  Index  Help 
JCaosLib
V1.4.4.0
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

Copyright ⓒ2007-2011 DreamSecurity Co.,Ltd . All rights reserved