java.security.cert
클래스 PKIXBuilderParameters

java.lang.Object 
  java.security.cert.PKIXParameters 
      java.security.cert.PKIXBuilderParameters

모든 구현된 인터페이스:

Cloneable, CertPathParameters

public class PKIXBuilderParameters
extends PKIXParameters 

PKIX CertPathBuilder 알고리즘의 입력으로 사용되는 파라미터입니다.

PKIX CertPathBuilder에 서는 이러한 파라미터를 사용해, PKIX 인증서 패스 검사 알고리즘에 따라 검사된 CertPath를 build 합니다.

PKIXBuilderParameters 객체를 인스턴스화하려면, 어플리케이션으로 PKIX 인증서 패스 검사 알고리즘으로 정의되는 「가장 신뢰할 수 있는 CA」를 1개 이상 지정하지 않으면 안됩니다. 무엇보다 신뢰할 수 있는 CA는 2개의 생성자 어느 쪽인지를 사용해 지정됩니다. PKIXBuilderParameters(Set, CertSelector)를 호출하는 경우는 TrustAnchor 객체의 Set를 지정합니다. 각각의 TrustAnchor 객체에서는 가장 신뢰할 수 있는 CA를 특정합니다. 대신에 PKIXBuilderParameters(KeyStore, CertSelector)를 호출하는 경우는 신뢰할 수 있는 인증서 엔트리가 포함되는 KeyStore인스턴스를 지정합니다. 각각의 인증서 엔트리를 가장 신뢰할 수 있는 CA가 됩니다.

또한 어플리케이션에서는 CertPathBuilder가 패스를 구축하려고 하는 타겟 인증서 의 제약을 지정할 필요가 있습니다. 제약은 CertSelector 객체로서 지정됩니다. 이러한 제약에의해 타겟 인증서를 찾아내기 위한 충분한 검색 기준이 CertPathBuilder에 게 줄 수 있습니다. 보통, X509Certificate 최소 기준에는 피인증자의 이름이나 1개 이상의 피인증자의 대체명이 포함되어 있습니다. 충분한 기준이 지정되지 않는 경우, CertPathBuilder는 CertPathBuilderException을 Throw 합니다.

병행 액세스

특별히 거절하지 않는 한, 이 클래스에서 정의되고 있는 메서드는 thread에 대해서 안전하지는 않습니다. 단일의 객체에 병행 액세스 할 필요가 있는 복수 thread는 thread간에 동기를 잡아, 필요에 따라서 잠그지 않으면 안됩니다. 다른 객체를 조작하는 복수 thread에서는 동기를 잡을 필요는 없습니다.

도입된 버전 :

1.4

관련 항목:

CertPathBuilder

생성자 개요

PKIXBuilderParameters (KeyStore keystore, CertSelector targetConstraints)
가장 신뢰할 수 있는 CA 세트를, 지정한 KeyStore에 포함되는 신뢰할 수 있는 인증서 엔트리로부터 생성하는 PKIXBuilderParameters 인스턴스를 작성합니다.

PKIXBuilderParameters (Set <TrustAnchor > trustAnchors, CertSelector targetConstraints)
가장 신뢰할 수 있는 CA 로부터 되는 지정한 Set로 PKIXBuilderParameters 인스턴스를 작성합니다.

메서드 개요

int	getMaxPathLength () 인증서 패스에 존재하는 자기 발행이 아닌 중간 인증서 의 최대수를 리턴합니다.
void	setMaxPathLength (int maxPathLength) 인증서 패스에 존재하는 자기 발행이 아닌 중간 인증서 의 최대수를 설정합니다.
String	toString () 파라미터를 설명하는 서식 첨부 캐릭터 라인을 리턴합니다.

클래스 java.security.cert. PKIXParameters 로부터 상속된 메서드

addCertPathChecker, addCertStore, clone, getCertPathCheckers, getCertStores, getDate, getInitialPolicies, getPolicyQualifiersRejected, getSigProvider, getTargetCertConstraints, getTrustAnchors, isAnyPolicyInhibited, isExplicitPolicyRequired, isPolicyMappingInhibited, isRevocationEnabled, setAnyPolicyInhibited, setCertPathCheckers, setCertStores, setDate, setExplicitPolicyRequired, setInitialPolicies, setPolicyMappingInhibited, setPolicyQualifiersRejected, setRevocationEnabled, setSigProvider, setTargetCertConstraints, setTrustAnchors

클래스 java.lang. Object 로부터 상속된 메서드

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

생성자 상세

PKIXBuilderParameters

public PKIXBuilderParameters(Set <TrustAnchor > trustAnchors,
                             CertSelector  targetConstraints)
                      throws InvalidAlgorithmParameterException 

무엇보다 신뢰할 수 있는 CA 로부터 되는 지정한 Set로 PKIXBuilderParameters 인스턴스를 작성합니다. 세트의 각 요소는 TrustAnchor 입니다.

이후의 변경으로부터 보호하기 위해서 Set는 복제되고 있습니다.

파라미터:

trustAnchors - TrustAnchor Set

targetConstraints - 타겟 인증서 의 제약을 지정하는 CertSelector

예외:

InvalidAlgorithmParameterException - trustAnchors가 비어있는 (trustAnchors.isEmpty() == true) 경우

NullPointerException - trustAnchors가 null인 경우

ClassCastException - trustAnchors 요소가 어느 것도 java.security.cert.TrustAnchor 형이 아닌 경우

PKIXBuilderParameters

public PKIXBuilderParameters(KeyStore  keystore,
                             CertSelector  targetConstraints)
                      throws KeyStoreException,

                             InvalidAlgorithmParameterException 

무엇보다 신뢰할 수 있는 CA 세트를, 지정한 KeyStore에 포함되는 신뢰할 수 있는 인증서 엔트리로부터 생성하는 PKIXBuilderParameters 인스턴스를 작성합니다. 신뢰할 수 있는 X509Certificate를 포함한 키스토어 엔트리만이 대상이 되어, 그 이외의 인증서 타입은 모두 무시됩니다.

파라미터:

keystore - 가장 신뢰할 수 있는 CA 세트가 생성되는 KeyStore

targetConstraints - 타겟 인증서 의 제약을 지정하는 CertSelector

예외:

KeyStoreException - keystore가 초기화되어 있지 않은 경우

InvalidAlgorithmParameterException - keystore에 신뢰할 수 있는 인증서 엔트리가 1개 도 포함되지 않는 경우

NullPointerException - keystore가 null인 경우

메서드의 상세

setMaxPathLength

public void setMaxPathLength(int maxPathLength)

인증서 패스에 존재하는 자기 발행이 아닌 중간 인증서 의 최대수를 설정합니다. 피인증자 필드와 발행자 필드의 DN를 각각 특정할 수 있어 비어있지 않은 경우, 인증서는 자기 발행되고 있습니다. 인증서 패스의 마지막 인증서는 중간 인증서는 아니기 때문에 이 상한치에는 포함되지 않습니다. 보통, 마지막 인증서는 엔드엔티티 인증서 입니다만, CA 인증서가 되는 경우도 있습니다. PKIX CertPathBuilder인스턴스에 의해 구축되는 패스는 여기서 지정한 길이보다 길어져서는 안됩니다.

값이 0인 경우, 패스에는 인증서가 1개 만 포함되어 있는 것을 나타냅니다. -1인 경우는 패스장에 제약이 없습니다 (즉 최대값이 없다). 지정하지 않는 경우의 디폴트의 최대 패스장은 5 입니다. -1 보다 작은 값을 설정하면, 예외가 발생 됩니다.

모든 CA 인증서에 BasicConstraintsExtension가 포함되어 있는 경우, 기능확장의 pathLenConstraint 필드의 값은 결과의 인증서 패스장이 짧을 때는 항상, 최대 패스장의 파라미터로 오버라이드(override) 됩니다.

파라미터:

maxPathLength - 인증서 패스에 존재하는 자기 발행이 아닌 중간 인증서 의 최대수

예외:

InvalidParameterException - maxPathLength값이 -1 보다 작은 경우

관련 항목:

getMaxPathLength()

getMaxPathLength

public int getMaxPathLength()

인증서 패스에 존재하는 자기 발행이 아닌 중간 인증서 의 최대수를 리턴합니다. 상세한 것에 대하여는 setMaxPathLength(int) 메서드를 참조하십시오.

반환값:

인증서 패스에 존재하는 자기 발행이 아닌 중간 인증서 의 최대수. 상한이 없는 경우는 -1

관련 항목:

setMaxPathLength(int)

toString

public String  toString()

파라미터를 설명하는 서식 첨부 캐릭터 라인을 리턴합니다.

오버라이드(override):

클래스 PKIXParameters 내의 toString

반환값:

파라미터를 설명하는 서식 첨부 캐릭터 라인