com.dreamsecurity.jcaos.x509.X509Certificate
|
JCaosLib V1.4.4.0 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Object
X.509 인증서를 처리하기 위한 클래스이다.
인증서는 사용자신분과 공개키를 연결해주는 문서로 인증기관의 전자 서명 생성키(개인키)로
전자 서명하여 생성이 되며 사용자의 공개키가 사용자의 것임을 증명하는 문서이다.
X.509 인증서에 대한 자세한 정보는 표준문서
RFC3280에서 확인할 수 있다.
인증서(Certificate)의 ASN.1 포맷은 다음과 같다.
Certificate ::= SEQUENCE {
tbsCertificate TBSCertificate,
signatureAlgorithm AlgorithmIdentifier,
signatureValue BIT STRING }
TBSCertificate ::= SEQUENCE {
version [0] EXPLICIT Version DEFAULT v1,
serialNumber CertificateSerialNumber,
signature AlgorithmIdentifier,
issuer Name,
validity Validity,
subject Name,
subjectPublicKeyInfo SubjectPublicKeyInfo,
issuerUniqueID [1] IMPLICIT UniqueIdentifier OPTIONAL,
-- If present, version MUST be v2 or v3
subjectUniqueID [2] IMPLICIT UniqueIdentifier OPTIONAL,
-- If present, version MUST be v2 or v3
extensions [3] EXPLICIT Extensions OPTIONAL
-- If present, version MUST be v3
}
X.509 인증서 객체 생성 예제 :
byte[] certData = <인증서 읽기>
X509Certificate cert = X509Certificate.getInstance(certData);
| Method Summary | |
void |
checkValidity()
인증서가 현재(시스템 현재 시간을 기준) 유효한지 확인한다. |
void |
checkValidity(java.util.Date date)
입력한 시간을 기준으로 인증서가 유효한지 확인한다. |
X509InformationAccess |
getAuthorityInformationAccess()
인증서 확장필드인 "기관 정보 액세스(authorityInformationAccess)"를 획득한다. |
X509AuthorityKeyIdentifier |
getAuthorityKeyIdentifier()
인증서 확장필드인 "기관 키 식별자(authorityKeyIdentifier)"를 획득한다. |
int |
getBasicConstraints()
인증서 확장필드인 기본 제한 필드(basicConstraints)의 "길이 제한(pathLenConstaint)" 값을 획득한다. |
X509CertificatePolicies |
getCertificatePolicies()
인증서 확장필드인 "인증서 정책(certificatePolicies)"를 획득한다. |
X509CRLDistributionPoints |
getCRLDistributionPoints()
인증서 확장필드인 "CRL 배포지점(cRLDistributionPoints)"을 획득한다. |
byte[] |
getEncoded()
DER 인코딩한다. |
java.util.ArrayList |
getExtendedKeyUsage()
인증서에 포함된 공개키의 추가적인 용도를 정의하는 인증서의 확장필드인 "확장 키 용도(extendedKeyUsage)" 값을 획득한다. |
static X509Certificate |
getInstance(byte[] data)
X.509 형식의 인증서를 입력하여 X509Certificate 객체로 변환한다. |
static X509Certificate |
getInstance(java.lang.Object o)
X.509 형식의 인증서를 입력하여 X509Certificate 객체로 변환한다. |
java.util.ArrayList |
getIssuerAlternativeNames()
인증서 확장필드인 "발급자 대체 이름 필드(issuerAlternativeName)"를 획득한다. |
X500Principal |
getIssuerDN()
인증서의 발급자 이름을 획득한다. |
boolean[] |
getKeyUsage()
인증서에 포함된 공개키의 용도를 정의하는 인증서의 확장필드인 "키 용도(keyUsage)" 값을 획득한다. |
X509NameConstraints |
getNameConstraints()
인증서 확장필드인 "이름 제한(NameConstraints)"을 획득한다. |
java.util.Date |
getNotAfter()
인증서 유효기간의 만료 일자를 확인한다. |
java.util.Date |
getNotBefore()
인증서 유효기간의 시작 일자를 획득한다. |
int[] |
getPolicyConstraints()
인증서 확장필드인 "정책 제한(policyConstraints)"을 획득한다. |
java.security.PublicKey |
getPublicKey()
공개키를 획득한다. |
java.math.BigInteger |
getSerialNumber()
인증서의 일련번호를 획득한다. |
java.lang.String |
getSigAlgName()
인증기관에서 인증서 발급 시 사용한 서명 알고리즘을 획득한다. |
byte[] |
getSignature()
인증서의 서명값을 획득한다. |
java.util.ArrayList |
getSubjectAlternativeName()
인증서 확장필드인 "주체 대체 이름 필드(subjectAlternativeName)"를 획득한다. |
X500Principal |
getSubjectDN()
인증서 소유자의 이름을 획득한다. |
byte[] |
getSubjectKeyIdentifier()
인증서 확장필드인 "주체 키 식별자(subjectKeyIdentifier)"를 획득한다. |
X509SubjectPublicKeyInfo |
getSubjectPublicKeyInfo()
공개키 정보를 획득한다. |
byte[] |
getTBSCertificate()
인증서의 tbsCertificate 부분을 획득한다. |
int |
getVersion()
인증서의 버전 값을 획득한다. |
com.dreamsecurity.jcaos.asn1.x509.Certificate |
toASN1Object()
ASN.1 형태의 Certificate를 획득한다. |
boolean |
verify(java.security.PublicKey publicKey)
인증서의 서명값을 검증한다. |
void |
verifyVID(java.lang.String idn,
byte[] random)
인증서 확장필드 주체 대체이름에 포함되어있는 가상 ID(VID) 정보와 식별번호를 이용하여 인증서 소유자를 확인한다. |
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Method Detail |
public static X509Certificate getInstance(java.lang.Object o)
throws java.io.IOException
o - X.509 형식의 인증서 (DER 인코딩된 값 또는 ASN.1 형태)
java.io.IOException - 디코딩 실패시 발생
public static X509Certificate getInstance(byte[] data)
throws java.io.IOException
data - DER 인코딩된 X.509 형식의 인증서
java.io.IOException - 디코딩 실패시 발생public byte[] getEncoded()
public com.dreamsecurity.jcaos.asn1.x509.Certificate toASN1Object()
public int getVersion()
public java.math.BigInteger getSerialNumber()
public X500Principal getIssuerDN()
throws java.io.IOException,
ParsingException
java.io.IOException - 발급자 이름 디코딩 실패시 발생
ParsingException - 지원하지 않는 종류의 이름 형식이 있을 경우에 발생
public X500Principal getSubjectDN()
throws java.io.IOException,
ParsingException
java.io.IOException - 소유자 이름 디코딩 실패시 발생
ParsingException - 지원하지 않는 종류의 이름 형식이 있을 경우에 발생
public java.util.Date getNotBefore()
throws java.text.ParseException
java.text.ParseException - 시간 정보 처리 실패시 발생
public java.util.Date getNotAfter()
throws java.text.ParseException
java.text.ParseException - 시간 정보 처리 실패시 발생public byte[] getTBSCertificate()
public byte[] getSignature()
public java.lang.String getSigAlgName()
public boolean[] getKeyUsage()
throws java.io.IOException
| index | 의미 |
| 0 | digitalSignature |
| 1 | nonRepudiation |
| 2 | keyEncipherment |
| 3 | dataEncipherment |
| 4 | keyAgreement |
| 5 | keyCertSign |
| 6 | cRLSign |
| 7 | encipherOnly |
| 8 | decipherOnly |
java.io.IOException - 키 용도 값 디코딩 실패시 발생
public java.util.ArrayList getExtendedKeyUsage()
throws java.io.IOException
| 리턴값 | 의미 |
| serverAuth | 서버 인증용 |
| clientAuth | 클라이언트 인증용 |
| condeSigning | 코드사이닝용 |
| emailProtection | E-Mail 보호용 |
| timeStamping | 시점확인 서버용 |
| ocspSigning | OCSP 서버용 |
| kisaHSM | 보안토큰 기반의 공인인증서 |
java.io.IOException - 확장 키 용도값 디코딩 실패 시 발생
public int getBasicConstraints()
throws java.io.IOException
java.io.IOException - 기본 제한값 디코딩 실패 시 발생
public X509NameConstraints getNameConstraints()
throws java.io.IOException
java.io.IOException - 이름 제한 정보 디코딩 실패 시 발생
public java.util.ArrayList getSubjectAlternativeName()
throws ParsingException,
java.io.IOException
ParsingException - 지원하지 않는 대체 이름 형태가 존재하는 경우에 발생
java.io.IOException - 주체 대체 이름 디코딩 실패 시 발생
public java.util.ArrayList getIssuerAlternativeNames()
throws ParsingException,
java.io.IOException
ParsingException - 지원하지 않는 대체 이름 형태가 존재하는 경우에 발생
java.io.IOException - 발급자 대체 이름 디코딩 실패 시 발생
public X509AuthorityKeyIdentifier getAuthorityKeyIdentifier()
throws java.io.IOException
java.io.IOException - 기관 키 식별자 정보 디코딩 실패 시 발생
public byte[] getSubjectKeyIdentifier()
throws java.io.IOException
java.io.IOException - 공개키 식별자 정보 디코딩 실패 시 발생
public X509CertificatePolicies getCertificatePolicies()
throws java.io.IOException
java.io.IOException - 인증서 정책 정보 디코딩 실패 시 발생
public int[] getPolicyConstraints()
throws java.io.IOException
| index | 의미 |
| 0 | requireExplicitPolicy |
| 1 | inhibitPolicyMapping |
java.io.IOException - 정책 제한 정보 디코딩 실패 시 발생
public X509CRLDistributionPoints getCRLDistributionPoints()
throws java.io.IOException
java.io.IOException - CRL 배포 지점 디코딩 실패 시 발생
public X509InformationAccess getAuthorityInformationAccess()
throws java.io.IOException
java.io.IOException - 기관 정보 액세스 디코딩 실패 시 발생
public void verifyVID(java.lang.String idn,
byte[] random)
throws java.io.IOException,
ParsingException,
IdentifyException,
java.security.NoSuchAlgorithmException,
java.security.NoSuchProviderException
idn - 인증서 소유자 식별번호random - 인증서 소유자의 개인키에 포함되어있는 본인확인을 위한 랜덤값
java.io.IOException - 주체 대체이름 필드 디코딩 실패시 발생
ParsingException - 본인확인을 위한 정보가 없는 경우에 발생
IdentifyExcepion - 본인확인 실패시 발생
java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생
java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생
IdentifyException
public X509SubjectPublicKeyInfo getSubjectPublicKeyInfo()
throws java.io.IOException,
java.security.NoSuchProviderException,
java.security.NoSuchAlgorithmException,
java.security.spec.InvalidKeySpecException
java.io.IOException - 공개키 정보 디코딩 실패시 발생
java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생
java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생
java.security.spec.InvalidKeySpecException - 적합하지 않은 키 정보인 경우에 발생
public java.security.PublicKey getPublicKey()
throws java.io.IOException,
java.security.NoSuchProviderException,
java.security.NoSuchAlgorithmException,
java.security.spec.InvalidKeySpecException
java.io.IOException - 공개키 정보 디코딩 실패시 발생
java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생
java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생
java.security.spec.InvalidKeySpecException - 적합하지 않은 키 정보인 경우에 발생
public boolean verify(java.security.PublicKey publicKey)
throws java.security.NoSuchAlgorithmException,
java.security.NoSuchProviderException,
java.security.InvalidKeyException,
java.security.SignatureException,
java.io.IOException
publicKey - 인증서 발급 기관 인증서의 공개키
java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생
java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생
java.security.InvalidKeyException - 알고리즘에 대한 적합한 키(잘못된 인코딩, 잘못된 길이, 초기화 되지 않음 등)가 아닌 경우에 발생
java.security.SignatureException - 일반적인 서명과 관련한 예외 사항 발생한 경우 발생
java.io.IOException - 공개키 정보 디코딩 실패시 발생
public void checkValidity()
throws java.security.cert.CertificateExpiredException,
java.security.cert.CertificateNotYetValidException,
java.text.ParseException
java.security.cert.CertificateExpiredException - 만료된 인증서인 경우에 발생
java.security.cert.CertificateNotYetValidException - 인증서가 아직 유효하지 않은 경우에 발생
java.text.ParseException - 인증서의 유효기간 정보 처리 실패시 발생
public void checkValidity(java.util.Date date)
throws java.security.cert.CertificateExpiredException,
java.security.cert.CertificateNotYetValidException,
java.text.ParseException
date - 기준 시간
java.security.cert.CertificateExpiredException - 만료된 인증서인 경우에 발생
java.security.cert.CertificateNotYetValidException - 인증서가 아직 유효하지 않은 경우에 발생
java.text.ParseException - 인증서의 유효기간 정보 처리 실패시 발생
|
JCaosLib V1.4.4.0 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||