java.security.cert
클래스 PKIXParameters

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

모든 구현된 인터페이스:

Cloneable, CertPathParameters

알려진 직계 서브 클래스:

PKIXBuilderParameters

public class PKIXParameters
extends Object 
implements CertPathParameters 

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

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

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

PKIXParameters 객체가 작성되면, (예를 들어 setInitialPolicies 또는 setDate를 호출해) 다른 파라미터를 지정해, PKIXParameters가 검사 대상의 CertPath와 함께 CertPathValidator.validate 에게 건네집니다.

설정되어 있지 않은 (또는 null로 설정되어 있다) 파라미터는 각각의 기본값 로 설정됩니다. date 파라미터의 기본값는 null로 패스가 검증되었을 때의 현재 시각을 나타냅니다. 그 다른 파라미터의 기본값는 거의 제약되지 않습니다.

병행 액세스

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

도입된 버전 :

1.4

관련 항목:

CertPathValidator

생성자 개요

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

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

메서드 개요

void	addCertPathChecker (PKIXCertPathChecker checker) PKIXCertPathChecker를 인증서 패스 checker의 리스트에 추가합니다.
void	addCertStore (CertStore store) CertStore를, 인증서와 CRL를 찾아내기 위해서 사용되는 CertStore 리스트의 마지막에 추가합니다.
Object	clone () PKIXParameters 객체의 복제를 작성합니다.
List <PKIXCertPathChecker >	getCertPathCheckers () 인증서 패스 checker의 List를 리턴합니다.
List <CertStore >	getCertStores () 인증서와 CRL를 찾아내기 위해서 사용되는 CertStore 불변인 List를 리턴합니다.
Date	getDate () 인증서 패스의 타당성이 판단될 때의 시간을 리턴합니다.
Set <String >	getInitialPolicies () 어느 초기 정책 도 인증서 패스 처리를 위해서 인증서 사용자에 게 있어 허용 할 수 있는 것 같은 초기 정책 식별자 (OID 캐릭터 라인)의 불변인 Set를 리턴합니다.
boolean	getPolicyQualifiersRejected () PolicyQualifiersRejected 플래그를 취득합니다.
String	getSigProvider () 서명 프로바이더의 이름을 리턴합니다.
CertSelector	getTargetCertConstraints () 타겟 인증서에 요구된 제약을 리턴합니다.
Set <TrustAnchor >	getTrustAnchors () 가장 신뢰할 수 있는 CA 불변인 Set를 리턴합니다.
boolean	isAnyPolicyInhibited () 임의의 정책 OID가 인증서에 포함될 때, 그 정책 OID가 처리되어야할 것인가 어떤가를 체크합니다.
boolean	isExplicitPolicyRequired () 명시적인 정책가 요구되고 있는지를 체크합니다.
boolean	isPolicyMappingInhibited () 정책 매핑이 억제되고 있는지를 체크합니다.
boolean	isRevocationEnabled () RevocationEnabled 플래그를 체크합니다.
void	setAnyPolicyInhibited (boolean val) 임의의 정책 OID가 인증서에 포함될 때, 그 정책 OID가 처리되지 않으면 안 되는지 어떤지를 판단하는 상태를 설정합니다.
void	setCertPathCheckers (List <PKIXCertPathChecker > checkers) 추가의 인증서 패스 checker의 List를 설정합니다.
void	setCertStores (List <CertStore > stores) 인증서와 CRL를 찾아내기 위해서 사용되는 CertStore 리스트를 설정합니다.
void	setDate (Date date) 인증서 패스의 타당성이 판단될 때의 시간을 설정합니다.
void	setExplicitPolicyRequired (boolean val) ExplicitPolicyRequired 플래그를 설정합니다.
void	setInitialPolicies (Set <String > initialPolicies) 어느 초기 정책 도 인증서 패스 처리를 위해서 인증서 사용자에 게 있어 허용 할 수 있는 그러한 초기 정책 식별자 (OID 캐릭터 라인)의 불변인 Set를 설정합니다.
void	setPolicyMappingInhibited (boolean val) PolicyMappingInhibited 플래그를 설정합니다.
void	setPolicyQualifiersRejected (boolean qualifiersRejected) PolicyQualifiersRejected 플래그를 설정합니다.
void	setRevocationEnabled (boolean val) RevocationEnabled 플래그를 설정합니다.
void	setSigProvider (String sigProvider) 서명 프로바이더의 이름을 설정합니다.
void	setTargetCertConstraints (CertSelector selector) 타겟 인증서에 요구된 제약을 설정합니다.
void	setTrustAnchors (Set <TrustAnchor > trustAnchors) 가장 신뢰할 수 있는 CA Set를 설정합니다.
String	toString () 파라미터를 설명하는 서식 첨부 캐릭터 라인을 리턴합니다.

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

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

생성자 상세

PKIXParameters

public PKIXParameters(Set <TrustAnchor > trustAnchors)
               throws InvalidAlgorithmParameterException 

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

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

파라미터:

trustAnchors - TrustAnchor Set

예외:

InvalidAlgorithmParameterException - 지정한 Set이 비어있는 (trustAnchors.isEmpty() == true)인 경우

NullPointerException - 지정한 Set이 null인 경우

ClassCastException - Set 요소가 어느 것도 java.security.cert.TrustAnchor 타입이 아닌 경우

PKIXParameters

public PKIXParameters(KeyStore  keystore)
               throws KeyStoreException,

                      InvalidAlgorithmParameterException 

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

파라미터:

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

예외:

KeyStoreException - 키스토어가 초기화되어 있지 않은 경우

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

NullPointerException - 키스토어가 null인 경우

메서드의 상세

getTrustAnchors

public Set <TrustAnchor > getTrustAnchors()

무엇보다 신뢰할 수 있는 CA 불변인 Set를 리턴합니다.

반환값:

TrustAnchor 불변인 Set. null은 되지 않는

관련 항목:

setTrustAnchors(java.util.Set)

setTrustAnchors

public void setTrustAnchors(Set <TrustAnchor > trustAnchors)
                     throws InvalidAlgorithmParameterException 

무엇보다 신뢰할 수 있는 CA Set를 설정합니다.

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

파라미터:

trustAnchors - TrustAnchor Set

예외:

InvalidAlgorithmParameterException - 지정한 Set이 비어있는 (trustAnchors.isEmpty() == true)인 경우

NullPointerException - 지정한 Set이 null인 경우

ClassCastException - 세트의 요소가 어느 것도 java.security.cert.TrustAnchor 타입이 아닌 경우

관련 항목:

getTrustAnchors()

getInitialPolicies

public Set <String > getInitialPolicies()

어느 초기 정책 도 인증서 패스 처리를 위해서 인증서 사용자에 게 있어 허용 할 수 있는 것 같은 초기 정책 식별자 (OID 캐릭터 라인)의 불변인 Set를 리턴합니다. 디폴트의 반환값은 비어있는 Set로 어느 정책 도 허용 가능으로서 해석됩니다.

반환값:

String 형식의 초기 정책 OID 불변인 Set, 혹은 비어있는 Set (어느 정책 도 허용 할 수 있다고 하는 것). null을 돌려줄 것은 없는

관련 항목:

setInitialPolicies(java.util.Set)

setInitialPolicies

public void setInitialPolicies(Set <String > initialPolicies)

어느 초기 정책 도 인증서 패스 처리를 위해서 인증서 사용자에 게 있어 허용 할 수 있는 그러한 초기 정책 식별자 (OID 캐릭터 라인)의 불변인 Set를 설정합니다. 디폴트에서는 어느 정책 도 (즉 모든 정책를) 허용 할 수 있기 때문에 어느 정책 도 허용 할 수 있도록 하고 싶은 사용자는 이 메서드를 호출할 필요는 없습니다. 또는 비어있는 Set (또는 null)로 호출할 수 있습니다 .

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

파라미터:

initialPolicies - String 형식의 초기 정책 OID Set (또는 null)

예외:

ClassCastException - 세트의 요소가 어느 것도 String 타입이 아닌 경우

관련 항목:

getInitialPolicies()

setCertStores

public void setCertStores(List <CertStore > stores)

인증서와 CRL를 찾아내기 위해서 사용되는 CertStore 리스트를 설정합니다. 사용되는 CertStore가 없는 경우에는 null이 됩니다. 리스트의 최초의 CertStore가 리스트의 뒤의 CertStore 보다 추천 됩니다.

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

파라미터:

stores - CertStore List, 또는 null

예외:

ClassCastException - 리스트의 요소가 어느 것도 java.security.cert.CertStore 타입이 아닌 경우

관련 항목:

getCertStores()

addCertStore

public void addCertStore(CertStore  store)

CertStore를, 인증서와 CRL를 찾아내기 위해서 사용되는 CertStore 리스트의 마지막에 추가합니다.

파라미터:

store - 추가되는 CertStore. null인 경우, 스토어는 무시된다 (리스트에 추가되지 않는다)

getCertStores

public List <CertStore > getCertStores()

인증서와 CRL를 찾아내기 위해서 사용되는 CertStore 불변인 List를 리턴합니다.

반환값:

CertStore 불변인 List (빈 리스트는 되지만, null은 되지 않는다)

관련 항목:

setCertStores(java.util.List)

setRevocationEnabled

public void setRevocationEnabled(boolean val)

RevocationEnabled 플래그를 설정합니다. 이 플래그가 true인 경우, 기본이 되는 PKIX 서비스 프로바이더의 디폴트의 취소 체크 도구가 사용됩니다. false인 경우, 디폴트의 취소 체크 도구는 무효로 됩니다 (사용되지 않는다).

PKIXParameters 객체가 작성되면, 이 플래그는 true 로 설정됩니다. 각 서비스 프로바이더에서는 PKIX에 준거하기 위해서 취소해 체크를 지원 할 필요가 있으므로 이 설정은 취소를 체크하는 가장 일반적인 방법을 반영하고 있습니다. PKIX 서비스 프로바이더의 디폴트의 취소 체크 도구를 사용하는 것이 실제적이지 않을 때나, 대체의 취소 체크 도구가 대신을 할 때는 (addCertPathChecker 또는 setCertPathCheckers 메서드를 호출하는 것에 해도), 고도의 어플리케이션으로 이 플래그를 false 로 설정할 필요가 있습니다.

파라미터:

val - RevocationEnabled 플래그의 새로운 값

isRevocationEnabled

public boolean isRevocationEnabled()

RevocationEnabled 플래그를 체크합니다. 이 플래그가 true인 경우, 기본이 되는 PKIX 서비스 프로바이더의 디폴트의 취소 체크 도구가 사용됩니다. false인 경우, 디폴트의 취소 체크 도구는 무효로 됩니다 (사용되지 않는다). 이 플래그의 값을 설정하는 상세한 것에 대하여는 setRevocationEnabled 메서드를 참조하십시오.

반환값:

RevocationEnabled 플래그의 현재의 값

setExplicitPolicyRequired

public void setExplicitPolicyRequired(boolean val)

ExplicitPolicyRequired 플래그를 설정합니다. 이 플래그가 true인 경우, 허용 할 수 있는 정책가 각각의 인증서 로 명시적으로 특정되고 있을 필요가 있습니다. 디폴트로 ExplicitPolicyRequired 플래그는 false 입니다.

파라미터:

val - 명시적인 정책가 요구되고 있는 경우는 true, 그렇지 않은 경우는 false

isExplicitPolicyRequired

public boolean isExplicitPolicyRequired()

명시적인 정책가 요구되고 있는지를 체크합니다. 이 플래그가 true인 경우, 허용 할 수 있는 정책가 각각의 인증서 로 명시적으로 특정되고 있을 필요가 있습니다. 디폴트로 ExplicitPolicyRequired 플래그는 false 입니다.

반환값:

명시적인 정책가 요구되고 있는 경우는 true, 그렇지 않은 경우는 false

setPolicyMappingInhibited

public void setPolicyMappingInhibited(boolean val)

PolicyMappingInhibited 플래그를 설정합니다. 이 플래그가 true인 경우, 정책 매핑은 억제됩니다. 디폴트로 정책 매핑은 억제되지 않습니다 (플래그는 false).

파라미터:

val - 정책 매핑이 억제되는 경우는 true, 그렇지 않은 경우는 false

isPolicyMappingInhibited

public boolean isPolicyMappingInhibited()

정책 매핑이 억제되고 있는지를 체크합니다. 이 플래그가 true인 경우, 정책 매핑은 억제되고 있습니다. 디폴트로 정책 매핑은 억제되지 않습니다 (플래그는 false).

반환값:

정책 매핑이 억제되고 있는 경우는 true, 그렇지 않은 경우는 false

setAnyPolicyInhibited

public void setAnyPolicyInhibited(boolean val)

임의의 정책 OID가 인증서에 포함될 때, 그 정책 OID가 처리되지 않으면 안 되는지 어떤지를 판단하는 상태를 설정합니다. 디폴트에서는 정책 OID는 억제되지 않습니다 (isAnyPolicyInhibited() 는 false를 돌려준다).

파라미터:

val - 임의의 정책 OID가 억제되는 경우는 true, 그렇지 않은 경우는 false

isAnyPolicyInhibited

public boolean isAnyPolicyInhibited()

임의의 정책 OID가 인증서에 포함될 때, 그 정책 OID가 처리되어야할 것인가 어떤가를 체크합니다.

반환값:

임의의 정책 OID가 억제되고 있는 경우는 true, 그렇지 않은 경우는 false

setPolicyQualifiersRejected

public void setPolicyQualifiersRejected(boolean qualifiersRejected)

PolicyQualifiersRejected 플래그를 설정합니다. 이 플래그가 true인 경우, 위기에 마크 되고 있는 인증서 정책 기능확장에 정책 수식자를 포함한 인증서는 거부됩니다. 플래그가 false인 경우, 이 이유에서는 거부되지 않습니다.

PKIXParameters 객체가 작성되면, 이 플래그는 true 로 설정됩니다. 이 설정은 정책 수식자를 처리하는 가장 일반적이어도와 도 단순한 방법을 반영하고 있습니다. 보다 고도의 정책를 사용하는 어플리케이션에서는 이 플래그를 false 로 설정하지 않으면 안됩니다.

PKIX 인증서 패스 검사 알고리즘에서는 위기에 마크 된 인증서 정책 확장 기능의 정책 수식자가 처리되어 평가되지 않으면 안 되게 지정합니다. 그렇지 않은 경우는 그 인증서 패스가 거부됩니다. policyQualifiersRejected 플래그가 false 로 설정되어 있는 경우, PKIX 호환을 위해서 이 방법으로 모든 정책 수식자를 검사할지 어떨지는 어플리케이션에 따라서 다릅니다.

파라미터:

qualifiersRejected - PolicyQualifiersRejected 플래그의 새로운 값

관련 항목:

getPolicyQualifiersRejected(), PolicyQualifierInfo

getPolicyQualifiersRejected

public boolean getPolicyQualifiersRejected()

PolicyQualifiersRejected 플래그를 취득합니다. 이 플래그가 true인 경우, 위기에 마크 되고 있는 인증서 정책 기능확장에 정책 수식자를 포함한 인증서는 거부됩니다. 플래그가 false인 경우, 이 이유에서는 거부되지 않습니다.

PKIXParameters 객체가 작성되면, 이 플래그는 true 로 설정됩니다. 이 설정은 정책 수식자를 처리하는 가장 일반적이어도와 도 단순한 방법을 반영하고 있습니다. 보다 고도의 정책를 사용하는 어플리케이션에서는 이 플래그를 false 로 설정하지 않으면 안됩니다.

반환값:

PolicyQualifiersRejected 플래그의 현재의 값

관련 항목:

setPolicyQualifiersRejected(boolean)

getDate

public Date  getDate()

인증서 패스의 타당성이 판단될 때의 시간을 리턴합니다. null인 경우, 현재 시각이 사용됩니다.

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

반환값:

Date. 설정되어 있지 않은 경우는 null

관련 항목:

setDate(java.util.Date)

setDate

public void setDate(Date  date)

인증서 패스의 타당성이 판단될 때의 시간을 설정합니다. null인 경우, 현재 시각이 사용됩니다.

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

파라미터:

date - Date. 현재 시각의 경우는 null

관련 항목:

getDate()

setCertPathCheckers

public void setCertPathCheckers(List <PKIXCertPathChecker > checkers)

추가의 인증서 패스 checker의 List를 설정합니다. 지정한 List에 PKIXCertPathChecker가 아닌 객체가 포함되는 경우는 무시됩니다.

지정한 각 PKIXCertPathChecker에 서는 인증서 의 추가 체크를 구현하고 있습니다. 보통, 인증서에 포함되어 있는 전용의 기능확장을 처리 및 검사하고 있을지 어떨지를 체크합니다. 각각의 PKIXCertPathChecker는 체크를 실시하기 위해서 필요한 초기화 파라미터로 인스턴스화 되지 않으면 안됩니다.

고도의 어플리케이션에서는 이 메서드에 의해 PKIX CertPathValidator 나 CertPathBuilder를 확장할 수 있습니다. 처리된, 또는 검사된 인증서에 대해, 지정한 PKIXCertPathChecker가 PKIX CertPathValidator 나 CertPathBuilder에 의해 각각 차례로 호출합니다.

이러한 추가 PKIXCertPathChecker가 설정되어 있는지 어떤지에 관계없이, PKIX CertPathValidator 나 CertPathBuilder에 서는 요구된 각 인증서 의 PKIX 체크를 모두 실행할 필요가 있습니다. 이 룰의 예외의 1개에 RevocationEnabled 플래그가 false 로 설정되었을 경우가 있습니다 (setRevocationEnabled 메서드 참조).

이후의 변경으로부터 보호하기 위해서 여기서 제공되는 List와 리스트내의 각 PKIXCertPathChecker는 복제되고 있습니다.

파라미터:

checkers - PKIXCertPathChecker List. 추가의 checker가 사용되지 않는 경우는 null

예외:

ClassCastException - 리스트의 요소가 어느 것도 java.security.cert.PKIXCertPathChecker 타입이 아닌 경우

관련 항목:

getCertPathCheckers()

getCertPathCheckers

public List <PKIXCertPathChecker > getCertPathCheckers()

인증서 패스 checker의 List를 리턴합니다. 리턴된 List는 불변이며, List 내의 각 PKIXCertPathChecker는 이후의 변경으로부터 보호하기 위해서 복제되고 있습니다.

반환값:

PKIXCertPathChecker 불변인 List (비어있는 리스트는 되지만, null은 되지 않는다)

관련 항목:

setCertPathCheckers(java.util.List)

addCertPathChecker

public void addCertPathChecker(PKIXCertPathChecker  checker)

PKIXCertPathChecker를 인증서 패스 checker의 리스트에 추가합니다. 상세한 것에 대하여는 setCertPathCheckers를 참조하십시오.

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

파라미터:

checker - 체크의 리스트에 추가되는 PKIXCertPathChecker. null인 경우, checker는 무시된다 (리스트에 추가되지 않는다)

getSigProvider

public String  getSigProvider()

서명 프로바이더의 이름을 리턴합니다. 설정되어 있지 않은 경우는 null을 리턴합니다.

반환값:

서명 프로바이더의 이름, 또는 null

관련 항목:

setSigProvider(java.lang.String)

setSigProvider

public void setSigProvider(String  sigProvider)

서명 프로바이더의 이름을 설정합니다. Signature 객체를 작성할 경우에는 지정한 프로바이더가 추천 됩니다. null, 또는 설정되어 있지 않은 경우는 알고리즘을 지원 한다, 최초로 발견된 프로바이더가 사용됩니다.

파라미터:

sigProvider - 서명 프로바이더의 이름, 또는 null

관련 항목:

getSigProvider()

getTargetCertConstraints

public CertSelector  getTargetCertConstraints()

타겟 인증서에 요구된 제약을 리턴합니다. 제약은 CertSelector 인스턴스로서 리턴됩니다 . null인 경우는 제약이 정의되지 않습니다.

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

반환값:

타겟 인증서 의 제약을 지정하는 CertSelector, 또는 null

관련 항목:

setTargetCertConstraints(java.security.cert.CertSelector)

setTargetCertConstraints

public void setTargetCertConstraints(CertSelector  selector)

타겟 인증서에 요구된 제약을 설정합니다. 제약은 CertSelector 인스턴스로서 지정됩니다. null인 경우는 제약이 정의되지 않습니다.

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

파라미터:

selector - 타겟 인증서 의 제약을 지정하는 CertSelector, 또는 null

관련 항목:

getTargetCertConstraints()

clone

public Object  clone()

PKIXParameters 객체의 복제를 작성합니다. 복제에의 변경은 원의 PKIXParameters 객체에 영향을 주지 않습니다. 또 역도 같습니다.

정의:

인터페이스 CertPathParameters 내의 clone

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 PKIXParameters 객체의 복제

관련 항목:

Cloneable

toString

public String  toString()

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

오버라이드(override):

클래스 Object 내의 toString

반환값:

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