java.security.cert
클래스 PKIXCertPathChecker

java.lang.Object 
  |
  +--java.security.cert.PKIXCertPathChecker

모든 구현 인터페이스:

Cloneable

public abstract class PKIXCertPathChecker

extends Object

implements Cloneable

X509Certificate 의 체크를 1 회 이상 실시하는 abstract 클래스입니다.

PKIXCertPathChecker 클래스의 고정 구현은 PKIX 증명서 패스 검사 알고리즘을 확장하기 위해서 작성됩니다. 예를 들어, 증명서 패스의 각 증명서에 전용의 위기인 확장 기능을 체크해 처리할 수가 있습니다.

PKIXCertPathChecker 의 인스턴스는 PKIXParameters 및 PKIXBuilderParameters 클래스의 setCertPathCheckers 메소드나 addCertPathChecker 메소드를 사용해, 파라미터로서 건네받습니다. PKIXCertPathChecker 의 check 메소드는 PKIX CertPathValidator 또는 CertPathBuilder 구현으로 처리되는 각 증명서에 대해서 차례로 불려 갑니다.

PKIXCertPathChecker 는 증명서 패스가 연속하는 증명서에 대해서, 여러 차례 불려 갑니다. 구상 서브 클래스에서는 연속하는 증명서를 체크할 필요가 있다고 하는 내부 상태를 유지하도록(듯이) 요구됩니다. 새로운 증명서 패스가 체크되기 위해서(때문에),init 메소드가 체크측의 내부 상태를 초기화하기 위해서 사용됩니다. PKIX CertPathBuilder 에 의해 효율적으로 백 트럭 해, 다른 패스로 시도할 수가 있게, 필요에 따라서 의미가 있는 구현으로 clone 메소드를 오버라이드(override)하지 않으면 안됩니다. 그러한 경우,CertPathBuilder 로 복제된 PKIXCertPathChecker 를 되돌리는 것으로, 지금까지의 패스 검사 상태에 되돌릴 수가 있습니다.

증명서가 PKIXCertPathChecker 에게 건네지는 차례는 순서 방향 (타겟으로부터 가장 신뢰할 수 있는 CA 에)이나 역방향 (가장 신뢰할 수 있는 CA 로부터 타겟에)의 어디라도 가능합니다. PKIXCertPathChecker 의 구현에서는 역방향의 체크 (증명서가 역방향에게 건네질 때 체크 가능)를 서포트하지 않으면 안되어, 순서 방향의 체크 (순서 방향으로 증명서가 건네받을 때 체크 가능)는 서포트하는 일이 있습니다. isForwardCheckingSupported 메소드에서는 순서 방향의 체크가 서포트되고 있는지 어떤지를 나타냅니다.

체크를 실시하기 위해서(때문에) 필요한 추가의 입력 파라미터가, 이 클래스의 고정 구현의 constructor를 통해서 지정되는 일이 있습니다.

병행 액세스

특별히 거절하지 않는 이상 이 클래스에서 정의되고 있는 메소드는 thread 세이프가 아닙니다. 단일의 오브젝트에 병행 액세스 할 필요가 있는 복수 thread는 thread간에 동기를 잡아, 필요에 따라서 잠그지 않으면 안됩니다. 다른 오브젝트를 조작하는 복수 thread에서는 동기를 취할 필요는 없습니다.

도입된 버젼:

1.4

관련 항목:

PKIXParameters , PKIXBuilderParameters

생성자의 개요

protected

PKIXCertPathChecker () 디폴트의 constructor 입니다.

메소드의 개요

abstract void	check (Certificate cert, Collection unresolvedCritExts) 지정한 증명서를 그 내부 상태로 체크해, 증명서가 처리하는 기능확장으로 위기인 것이 있으면, 해석 처리할 수 없는 기능확장을 나타내는 OID 캐릭터 라인의 지정한 콜렉션으로부터, 그 기능확장을 삭제합니다.
Object	clone () 이 오브젝트의 복제를 돌려줍니다.
abstract Set	getSupportedExtensions () 이 PKIXCertPathChecker 가 서포트 (즉, 「인식한다」 「처리할 수 있다」) X. 509 증명서 기능확장의 불변인 Set 를 돌려줍니다.
abstract void	init (boolean forward) 이 PKIXCertPathChecker 의 내부 상태를 초기화합니다.
abstract boolean	isForwardCheckingSupported () 순서 방향의 체크가 서포트되고 있는지 어떤지를 나타냅니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

PKIXCertPathChecker

protected PKIXCertPathChecker()

디폴트의 constructor 입니다.

메소드의 상세

init

public abstract void init(boolean forward)
                   throws CertPathValidatorException 

이 PKIXCertPathChecker 의 내부 상태를 초기화합니다.

forward 플래그에서는 증명서가 check 메소드에게 건네지는 순서 (순서 방향이나 역방향)를 지정합니다. PKIXCertPathChecker 에서는 역방향의 체크를 서포트하지 않으면 안되어, 순서 방향의 체크는 서포트하는 일이 있습니다.

파라미터:

forward - 증명서가 check 메소드에게 건네지는 순서. true 의 경우는 타겟으로부터 가장 신뢰할 수 있는 CA 의 순서 (순서 방향)에 증명서가 건네받아false 의 경우는 가장 신뢰할 수 있는 CA 로부터 타겟의 순서 (역방향)에게 건네진다

예외:

CertPathValidatorException - 지정된 순서로 이 PKIXCertPathChecker 가 증명서를 체크할 수 없는 경우. 역방향의 체크는 반드시 서포트되고 있으므로, forward 플래그가 false 의 경우는 슬로우 되지 않는다

isForwardCheckingSupported

public abstract boolean isForwardCheckingSupported()

순서 방향의 체크가 서포트되고 있는지 어떤지를 나타냅니다. 순서 방향의 체크란, 증명서가 순서 방향 (타겟으로부터 가장 신뢰할 수 있는 CA 에)으로 check 메소드에 건네받을 때 체크 가능한 PKIXCertPathChecker 의 기능입니다.

반환값:

순서 방향의 체크가 서포트되고 있는 경우는 true, 그렇지 않은 경우는 false

getSupportedExtensions

public abstract Set  getSupportedExtensions()

이 PKIXCertPathChecker 가 서포트 (즉, 「인식한다」 「처리할 수 있다」) X. 509 증명서 기능확장의 불변인 Set 를 돌려줍니다.

세트의 각 요소는 서포트되는 X. 509 기능확장의 오브젝트 식별자 (OID)를 나타내는 String 입니다. OID 는 피리어드로 단락지어진 0 이상의 정수의 조로 나타내집니다.

PKIXCertPathChecker 를 처리할 수 있는 모든 X. 509 기능확장은 세트에 포함되지 않으면 안됩니다.

반환값:

이 PKIXCertPathChecker 로 서포트되는 X. 509 기능확장 OID 로부터 되는 불변인 Set. 서포트되는 기능확장이 없는 경우는 null

check

public abstract void check(Certificate  cert,
                           Collection  unresolvedCritExts)
                    throws CertPathValidatorException 

지정한 증명서를 그 내부 상태로 체크해, 증명서가 처리하는 기능확장으로 위기인 것이 있으면, 해석 처리할 수 없는 기능확장을 나타내는 OID 캐릭터 라인의 지정한 콜렉션으로부터, 그 기능확장을 삭제합니다. 증명서는 init 메소드로 지정된 순서로 나타납니다.

파라미터:

cert - 체크 대상의 Certificate

unresolvedCritExts - 해석 처리할 수 없는 위기인 기능확장의 현재세트를 나타내는 OID 캐릭터 라인의 Collection

예외:

CertPathValidatorException - 지정한 증명서가 체크를 통하지 않는 경우

clone

public Object  clone()

이 오브젝트의 복제를 돌려줍니다. Object.clone() 를 호출합니다. 상태를 유지하는 모든 서브 클래스에서는 이 메소드를 서포트하지 않으면 안되어, 필요에 따라서 오버라이드(override) 합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 PKIXCertPathChecker 의 복제

관련 항목:

Cloneable