java.security.cert.Certificate
java.security.cert.X509Certificate
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: 상자 | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public abstract class X509Certificate
X. 509 인증서 의 추상 클래스입니다. 이 클래스는 X. 509 인증서 의 모든 속성에 액세스하기 위한 표준적인 방법을 제공합니다.
기본적인 X. 509 v3 형식은 1996 년 6 월에 ISO/IEC 및 ANSI X9에 의해 책정되어 아래와 같이 ASN. 1 으로 기술됩니다.
Certificate ::= SEQUENCE {
tbsCertificate TBSCertificate,
signatureAlgorithm AlgorithmIdentifier,
signature BIT STRING }
이러한 인증서는 인터넷의 시큐러티 시스템으로 인증등의 기능을 지원 하기 위해서 넓게 사용되고 있습니다. 대표적인 어플리케이션에는 Privacy Enhanced Mail (PEM), Transport Layer Security (SSL), 신뢰할 수 있는 소프트웨어 배포를 위한 코드 서명 및 Secure Electronic Transactions (SET)등이 있습니다.
이러한 인증서는 「인증서 발행국 (CA)」에 의해 관리 및 보증되고 있습니다. CA는 데이터를 X. 509 표준 형식으로 하고 나서, 그 데이터에 디지털 서명 하는 것으로써 인증서를 작성하는 서비스입니다. CA는 신뢰할 수 있는 제삼자로서 기능해, 직접은 안면이 없는 주체끼리를 소개합니다. CA 인증서는 그 CA 자신으로 또는 「루트」CA 등의 다른 CA에 의해 서명되고 있습니다.
자세한 것은, http://www.ietf.org/rfc/rfc2459.txt에 있는 RFC 2459 「Internet X. 509 Public Key Infrastructure Certificate and CRL Profile」를 참조하십시오.
tbsCertificate
ASN. 1 정의는 다음과 같습니다.
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 인증서 의 인스턴스를 생성하는 방법을 나타내고 있습니다.
InputStream inStream = new FileInputStream("fileName-of-cert");
CertificateFactory cf = CertificateFactory.getInstance("X. 509");
X509Certificate cert = (X509Certificate) cf.generateCertificate(inStream);
inStream.close();
Certificate,
CertificateFactory,
X509Extension,
직렬화 된 형식 | 중첩(Nested) 클래스 개요 |
|---|
| 클래스 java.security.cert. Certificate 로부터 상속된 중첩(Nested) 클래스/인터페이스 |
|---|
Certificate.CertificateRep |
| 생성자 개요 | |
|---|---|
protected |
X509Certificate ()
X. 509 인증서 의 생성자 입니다. |
| 메서드 개요 | |
|---|---|
abstract void |
checkValidity ()
인증서가 현재 유효한지 어떤지를 판정합니다. |
abstract void |
checkValidity (Date date)
지정된 날짜와 시간가 인증서 의 유효기간내일지 어떨지를 판정합니다. |
abstract int |
getBasicConstraints ()
위기인 BasicConstraints 확장 기능 (OID = 2.5. 29.19)로부터 인증서
의 제약의 패스의 길이를 취득합니다. |
List <String > |
getExtendedKeyUsage ()
확장키 사용법의 확장 기능 (OID = 2.5. 29.37)에 있는 ExtKeyUsageSyntax 필드의 객체 식별자를 나타내는 변경 불가능한 String
리스트를 취득합니다. |
Collection <List <? >> |
getIssuerAlternativeNames ()
IssuerAltName 확장 기능 (OID = 2.5. 29.18)으로부터, 발행자의 대체명의 불변인 컬렉션을 취득합니다. |
abstract Principal |
getIssuerDN ()
비추천 getIssuerX500Principal() 로 옮겨놓을 수 있었습니다. |
abstract boolean[] |
getIssuerUniqueID ()
인증서 로부터 issuerUniqueID값을 취득합니다. |
X500Principal |
getIssuerX500Principal ()
인증서 로부터 발행자 (발행자의 식별명)의 값을 X500Principal로
서 리턴합니다. |
abstract boolean[] |
getKeyUsage ()
KeyUsage 확장 기능 (OID = 2.5. 29.15)의 비트를 나타내는 boolean 배열을 취득합니다. |
abstract Date |
getNotAfter ()
인증서 의 유효기간으로부터 notAfter
날짜와 시간를 취득합니다. |
abstract Date |
getNotBefore ()
인증서 의 유효기간으로부터 notBefore
날짜와 시간를 취득합니다. |
abstract BigInteger |
getSerialNumber ()
인증서 로부터 serialNumber값을 취득합니다. |
abstract String |
getSigAlgName ()
인증서 의 서명 알고리즘명을 취득합니다. |
abstract String |
getSigAlgOID ()
인증서 로부터 서명 알고리즘의 OID 캐릭터 라인을 취득합니다. |
abstract byte[] |
getSigAlgParams ()
이 인증서 의 서명 알고리즘으로부터, DER 로 encode 된 서명 알고리즘 파라미터를 취득합니다. |
abstract byte[] |
getSignature ()
인증서 로부터 signature 치 (원시시그니쳐빗트)를 취득합니다. |
Collection <List <? >> |
getSubjectAlternativeNames ()
SubjectAltName 확장 기능 (OID = 2.5. 29.17)으로부터, 피인증자의 대체명의 불변인 컬렉션을 취득합니다. |
abstract Principal |
getSubjectDN ()
비추천 getSubjectX500Principal() 로 옮겨놓을 수 있었습니다. |
abstract boolean[] |
getSubjectUniqueID ()
인증서 로부터 subjectUniqueID값을 취득합니다. |
X500Principal |
getSubjectX500Principal ()
인증서 로부터 피인증자 (피인증자의 식별명)의 값을 X500Principal로
서 리턴합니다. |
abstract byte[] |
getTBSCertificate ()
이 인증서 로부터 DER 로 encode 된 인증 정보 tbsCertificate를 취득합니다. |
abstract int |
getVersion ()
인증서 로부터 version (버전
번호) 치를 취득합니다. |
| 클래스 java.security.cert. Certificate 로부터 상속된 메서드 |
|---|
equals,
getEncoded,
getPublicKey,
getType,
hashCode,
toString,
verify,
verify,
writeReplace |
| 클래스 java.lang. Object 로부터 상속된 메서드 |
|---|
clone,
finalize,
getClass,
notify,
notifyAll,
wait,
wait,
wait |
| 인터페이스 java.security.cert. X509Extension 로부터 상속된 메서드 |
|---|
getCriticalExtensionOIDs,
getExtensionValue,
getNonCriticalExtensionOIDs,
hasUnsupportedCriticalExtension |
| 생성자 상세 |
|---|
protected X509Certificate()
| 메서드의 상세 |
|---|
public abstract void checkValidity()
throws CertificateExpiredException,
CertificateNotYetValidException
유효기간은 인증서가 유효한 최초의 일시와 마지막 일시의 2개의 일시치로부터 됩니다. 이것은 ASN. 1 으로 다음과 같이 정의됩니다.
validity ValidityValidity ::= SEQUENCE { notBefore CertificateValidityDate, notAfter CertificateValidityDate }
CertificateValidityDate ::= CHOICE { utcTime UTCTime, generalTime GeneralizedTime }
CertificateExpiredException - 인증서
의 유효기간이 끊어져 있는 경우
CertificateNotYetValidException - 인증서가 아직 유효하게 되지 않은 경우
public abstract void checkValidity(Date date)
throws CertificateExpiredException,
CertificateNotYetValidException
date - 지정된 일시에 이 인증서가 유효한지 어떤지를 조사하는 Date
CertificateExpiredException - 지정된 date에 인증서가 기한 마감이 되어 있는 경우
CertificateNotYetValidException - 지정된 date에 인증서가 아직 유효하게 되지 않은 경우checkValidity() public abstract int getVersion()
version (버전
번호) 치를 취득합니다. ASN. 1 정의는 다음과 같습니다.
version [0] EXPLICIT Version DEFAULT v1Version ::= INTEGER { v1(0), v2(1), v3(2) }
public abstract BigInteger getSerialNumber()
serialNumber값을 취득합니다. 시리얼 번호는 인증서
발행국에 의해 각 인증서에 할당할 수 있는 정수값
입니다. 시리얼 번호는 지정된 CA에 의해 발행된 각 인증서에 대해서 일의가 아니면 안됩니다. 즉, 발행자명과 시리얼 번호에 의해 일의의 인증서가 식별됩니다. ASN. 1 정의는 다음과 같습니다.
serialNumber CertificateSerialNumberCertificateSerialNumber ::= INTEGER
public abstract Principal getIssuerDN()
issuer를 구현 고유의 Principal 객체로서 리턴합니다. 이식성이 있는 코드가 이러한 객체에
존해야 하지는 않습니다.
인증서
로부터 issuer (발행자 식별명) 치를 취득합니다. 발행자명은 인증서
의 서명과 발행을 행한 엔티티를 식별합니다.
발행자명 필드에는 X. 500 식별명 (DN)이 포함됩니다. ASN. 1 정의는 다음과 같습니다.
issuer NameName ::= CHOICE { RDNSequence } RDNSequence ::= SEQUENCE OF RelativeDistinguishedName RelativeDistinguishedName ::= SET OF AttributeValueAssertion AttributeValueAssertion ::= SEQUENCE { AttributeType, AttributeValue } AttributeType ::= OBJECT IDENTIFIER AttributeValue ::= ANY
Name에는 국명등의 속성과 거기에 대응하는 US 등의 값으로부터 되는 계층적인 이름을 기술합니다. AttributeValue 컴퍼넌트의 형태는 AttributeType에 의해 정해집니다. 일반적으로는 directoryString 입니다. directoryString 은 보통
PrintableString, TeletexString, UniversalString
어떤 것인가입니다.
public X500Principal getIssuerX500Principal()
X500Principal로
서 리턴합니다.
서브 클래스에서 이 메서드를 오버라이드(override) 하는 것을 추천합니다.
X500Principalpublic abstract Principal getSubjectDN()
subject를 구현 고유의 Principal 객체로서 리턴합니다. 이식성이 있는 코드가 이러한 객체에
존해야 하지는 않습니다.
subject (피인증자의 식별명)의 값을 인증서
로부터 취득합니다. subject값이 비어있는 경우, 리턴된
Principal 객체의 getName() 메서드는 비어있는 캐릭터 라인 ("")을 리턴합니다.
ASN. 1 정의는 다음과 같습니다.
subject Name
Name 및 그 외의 관련된 정의에 대해서는 getIssuerDN를
참조하십시오.
public X500Principal getSubjectX500Principal()
X500Principal로
서 리턴합니다. 피인증자의 값이 비어있는 경우, 리턴된
X500Principal 객체의 getName() 메서드는 비어있는 캐릭터 라인 ("")을 리턴합니다.
서브 클래스에서 이 메서드를 오버라이드(override) 하는 것을 추천합니다.
X500Principalpublic abstract Date getNotBefore()
notBefore
날짜와 시간를 취득합니다. 해당하는 ASN. 1 정의는 다음과 같습니다.
validity ValidityValidity ::= SEQUENCE { notBefore CertificateValidityDate, notAfter CertificateValidityDate }
CertificateValidityDate ::= CHOICE { utcTime UTCTime, generalTime GeneralizedTime }
checkValidity() public abstract Date getNotAfter()
notAfter
날짜와 시간를 취득합니다. 해당하는 ASN. 1 정의에 대해서는 getNotBefore를
참조하십시오.
checkValidity()
public abstract byte[] getTBSCertificate()
throws CertificateEncodingException
tbsCertificate를 취득합니다. 이것은 서명을 개별적으로 검증하기 위해서 사용됩니다.
CertificateEncodingException - encode 에러가 발생했을 경우public abstract byte[] getSignature()
signature 치 (원시시그니쳐빗트)를 취득합니다. ASN. 1 정의는 다음과 같습니다.
signature BIT STRING
public abstract String getSigAlgName()
signatureAlgorithm AlgorithmIdentifierAlgorithmIdentifier ::= SEQUENCE { algorithm OBJECT IDENTIFIER, parameters ANY DEFINED BY algorithm OPTIONAL } -- contains a value of the type -- registered for use with the -- algorithm object identifier value
알고리즘명은 algorithm OID 캐릭터 라인으로부터 판정됩니다.
public abstract String getSigAlgOID()
관련된 ASN. 1 정의에 대해서는 getSigAlgName를
참조하십시오.
public abstract byte[] getSigAlgParams()
AlgorithmParameters를
사용해, getSigAlgName 에 의해 리턴된
이름을 사용해 인스턴스를 생성합니다.
관련된 ASN. 1 정의에 대해서는 getSigAlgName를
참조하십시오.
public abstract boolean[] getIssuerUniqueID()
issuerUniqueID값을 취득합니다. 발행자 고유의 식별자는 발행자명이 반복해 재사용될 가능성에 대처하기 위해서
인증서에 정의되고 있습니다. RFC 2459 에서는 이름을 재사용하지 않는 것 및 준거하는 인증서가 일의의 식별자를 사용하지 않는 것을 추천 하고 있습니다. 그 프로파일에 준거하는 어플리케이션은 일의의 식별자를 해석 및 비교할 수 있는 것이 필요합니다.
ASN. 1 정의는 다음과 같습니다.
issuerUniqueID [1] IMPLICIT UniqueIdentifier OPTIONALUniqueIdentifier ::= BIT STRING
public abstract boolean[] getSubjectUniqueID()
subjectUniqueID값을 취득합니다.
ASN. 1 정의는 다음과 같습니다.
subjectUniqueID [2] IMPLICIT UniqueIdentifier OPTIONALUniqueIdentifier ::= BIT STRING
public abstract boolean[] getKeyUsage()
KeyUsage 확장 기능 (OID = 2.5. 29.15)의 비트를 나타내는 boolean 배열을 취득합니다. 키 사용 목적의 확장 기능은 인증서
로 설정되어 있는 키의 사용 목적 (예를 들어
암호용, 서명용, 인증서
서명용)을 정의합니다. ASN. 1 정의는 다음과 같습니다.
KeyUsage ::= BIT STRING {
digitalSignature (0),
nonRepudiation (1),
keyEncipherment (2),
dataEncipherment (3),
keyAgreement (4),
keyCertSign (5),
cRLSign (6),
encipherOnly (7),
decipherOnly (8) }
RFC 2459 에서는 이것을 사용하는 경우는 위기인 확장으로서 마킹 하는 것을 추천 하고 있습니다.
public List <String > getExtendedKeyUsage()
throws CertificateParsingException
ExtKeyUsageSyntax 필드의 객체 식별자를 나타내는 변경 불가능한 String
리스트를 취득합니다. 이것은 키 사용법의 확장 기능 필드에 나타나고 있는 기본적인 목적에 가세해, 혹은 그 기본적인 목적 대신에
공개키가 사용되는 목적 (복수가능)을 나타냅니다.
ExtKeyUsageSyntax ::= SEQUENCE SIZE (1..MAX) OF KeyPurposeId키의 목적은 요구에 맞추어 조직으로 정의합니다. 키의 목적을 특정하는 객체 식별자는 IANA 또는 ITU-T Rec. X. 660, 혹은 ISO/IEC/ITU 9834-1에 따라 할당할 수 없으면 안됩니다.KeyPurposeId ::= OBJECT IDENTIFIER
이 메서드는 Java 2 Platform Standard Edition
버전
1.4 로 추가되었습니다. 기존의 서비스 프로바이더와의 하위 호환성을 유지하기 위해서
abstract에는 하지 못하고, 디폴트의 구현을 제공합니다. 서브 클래스는 올바른 구현으로 이 메서드를 오버라이드(override) 하지 않으면 안됩니다.
CertificateParsingException - 확장 기능이 복호화 할 수 없었던 경우public abstract int getBasicConstraints()
BasicConstraints 확장 기능 (OID = 2.5. 29.19)로부터 인증서
의 제약의 패스의 길이를 취득합니다.
기본 제약 확장 기능은 인증서
의 피인증자가 인증서
발행국 (CA)일지 어떨지 및 그 CA
인증서
패스의 깊이를 식별합니다. pathLenConstraint 필드 (아래와 같이를 참조)는 cA가 TRUE 로 설정되어 있는 경우에만 유효합니다. 이 경우
인증서
패스로 이 인증서
의 후에 계속되는 CA 인증서
의 최대수를 나타냅니다. 값 0 은 엔드엔티티의 인증서
뿐인 것을 나타냅니다.
RFC 2459 에서는 cA가 TRUE (이 인증서는 인증서
발행국의 것이다)의 경우는 이 확장 기능은 항상 위기로서 마킹 됩니다.
ASN. 1 정의는 다음과 같습니다.
BasicConstraints ::= SEQUENCE {
cA BOOLEAN DEFAULT FALSE,
pathLenConstraint INTEGER (0..MAX) OPTIONAL }
pathLenConstraint값, 피인증자가 CA 로 pathLenConstraint이 표시되지 않는 경우는 인증 패스의 길이에 제한이 없는 것이 가리키기 때문에 Integer.MAX_VALUE가 리턴된다
public Collection <List <? >> getSubjectAlternativeNames()
throws CertificateParsingException
SubjectAltName 확장 기능 (OID = 2.5. 29.17)으로부터, 피인증자의 대체명의 불변인 컬렉션을 취득합니다.
SubjectAltName 확장 기능의 ASN. 1 정의는 다음과 같습니다.
SubjectAltName ::= GeneralNames
GeneralNames :: = SEQUENCE SIZE (1..MAX) OF GeneralName
GeneralName ::= CHOICE {
otherName [0] OtherName,
rfc822Name [1] IA5String,
dNSName [2] IA5String,
x400Address [3] ORAddress,
directoryName [4] Name,
ediPartyName [5] EDIPartyName,
uniformResourceIdentifier [6] IA5String,
iPAddress [7] OCTET STRING,
registeredID [8] OBJECT IDENTIFIER}
이 인증서에 SubjectAltName 확장 기능이 포함되지 않는 경우는 null이 리턴됩니다
. 그렇지 않은 경우는 확장 기능에 포함되는 각 GeneralName를 나타내는 엔트리를 포함한 Collection가 리턴됩니다
. 각 엔트리는 List로
이 List
최초의 엔트리는 Integer (이름 타입, 0 ~ 8), 2번째의 엔트리는 String 나 바이트 배열 (각각이 캐릭터 라인 형식 또는 ASN. 1 DER encode 형식의 이름)이 됩니다.
RFC 822, DNS, URI
각 이름은 String로
서 리턴됩니다
. 이 때, RFC 2459에 포함되는 제한에 따라, 각각의 타입으로 명확하게 정의된 캐릭터 라인 형식이 이용됩니다. IPv4 주소명은 닷으로 4 개에 단락지어진 표기법으로 리턴됩니다
. IPv6 주소명은 「a1:a2:...:a8」라고 하는 형식에서 리턴됩니다
. a1 ~ a8는
16 진수 표기로 주소를 16 비트씩으로 8 개로 분할하고 있습니다. OID명은 피리어드로 단락지어진 부가 되지 않는 일련의 정수로 나타내지는 String로
서 리턴됩니다
. 디렉토리명 (식별명)은 RFC 2253 캐릭터 라인 형식으로서 리턴됩니다
. otherName, X. 400 명, EDI 상대명, 그 다른 타입의 이름에는 표준의 캐릭터 라인 형식은 없습니다. 이름의 ASN. 1 DER encode 형식을 포함한 바이트 배열로서 리턴됩니다
.
리턴된
Collection에는 같은 타입으로 1개
이상의 이름이 포함되어 있는 일이 있습니다. 또, 리턴된
Collection는 불변이며, 바이트 배열을 포함한 엔트리는 모두 이후의 변경으로부터 보호하기 위해서 복제되고 있습니다.
이 메서드는 Java 2 Platform Standard Edition
버전
1.4 로 추가되었습니다. 기존의 서비스 프로바이더와의 하위 호환성을 유지하기 위해서
abstract에는 하지 못하고, 디폴트의 구현을 제공합니다. 서브 클래스는 올바른 구현으로 이 메서드를 오버라이드(override) 하지 않으면 안됩니다.
Collection. 또는 null
CertificateParsingException - 확장 기능이 복호화 할 수 없었던 경우
public Collection <List <? >> getIssuerAlternativeNames()
throws CertificateParsingException
IssuerAltName 확장 기능 (OID = 2.5. 29.18)으로부터, 발행자의 대체명의 불변인 컬렉션을 취득합니다.
IssuerAltName 확장 기능의 ASN. 1 정의는 다음과 같습니다.
IssuerAltName ::= GeneralNames
GeneralNames
ASN. 1 정의는 getSubjectAlternativeNames에 있습니다.
이 인증서에 IssuerAltName 확장 기능이 포함되지 않는 경우는 null이 리턴됩니다
. 그렇지 않은 경우는 확장 기능에 포함되는 각 GeneralName를 나타내는 엔트리를 포함한 Collection가 리턴됩니다
. 각 엔트리는 List로
이 List
최초의 엔트리는 Integer (이름 타입, 0 ~ 8), 2번째의 엔트리는 String 나 바이트 배열 (각각이 캐릭터 라인 형식 또는 ASN. 1 DER encode 형식의 이름)이 됩니다. 각각의 이름형으로 사용되는 형식의 상세한 것에 대하여는 getSubjectAlternativeNames 메서드를 참조하십시오.
리턴된
Collection에는 같은 타입으로 1개
이상의 이름이 포함되어 있는 일이 있습니다. 또, 리턴된
Collection는 불변이며, 바이트 배열을 포함한 엔트리는 모두 이후의 변경으로부터 보호하기 위해서 복제되고 있습니다.
이 메서드는 Java 2 Platform Standard Edition
버전
1.4 로 추가되었습니다. 기존의 서비스 프로바이더와의 하위 호환성을 유지하기 위해서
abstract에는 하지 못하고, 디폴트의 구현을 제공합니다. 서브 클래스는 올바른 구현으로 이 메서드를 오버라이드(override) 하지 않으면 안됩니다.
Collection. 또는 null
CertificateParsingException - 확장 기능이 복호화 할 수 없었던 경우
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: 상자 | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.