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 메서드에서는 순서 방향의 체크가 지원 되고 있는지를 나타냅니다.

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

병행 액세스

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

도입된 버전 :

1.4

관련 항목:

PKIXParameters, PKIXBuilderParameters

생성자 개요

protected

PKIXCertPathChecker () 디폴트의 생성자 입니다.

메서드 개요

abstract void	check (Certificate cert, Collection <String > unresolvedCritExts) 지정한 인증서를 그 내부 상태로 체크해, 인증서가 처리하는 기능확장으로 위기인 것이 있으면, 해석 처리할 수 없는 기능확장을 나타내는 OID 캐릭터 라인의 지정한 컬렉션으로부터, 그 기능확장을 삭제합니다.
Object	clone () 이 객체의 복제를 리턴합니다.
abstract Set <String >	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()

디폴트의 생성자 입니다.

메서드의 상세

init

public abstract void init(boolean forward)
                   throws CertPathValidatorException 

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

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

파라미터:

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

예외:

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

isForwardCheckingSupported

public abstract boolean isForwardCheckingSupported()

순서 방향의 체크가 지원 되고 있는지를 나타냅니다. 순서 방향의 체크란 인증서가 check 메서드에 순서 방향 (타겟으로부터도와 도 신뢰할 수 있는 CA 에)에게 건네질 때 체크가 가능한 PKIXCertPathChecker 기능입니다.

반환값:

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

getSupportedExtensions

public abstract Set <String > 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 <String > unresolvedCritExts)
                    throws CertPathValidatorException 

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

파라미터:

cert - 체크 대상의 Certificate

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

예외:

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

clone

public Object  clone()

이 객체의 복제를 리턴합니다. Object.clone()를 호출합니다. 상태를 유지하는 모든 서브 클래스에서는 이 메서드를 지원 하지 않으면 안되어, 필요에 따라서 오버라이드(override) 합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 PKIXCertPathChecker 복제

관련 항목:

Cloneable