java.security.cert
클래스 CertPathValidator

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

public class CertPathValidator

extends Object

증명서 패스 (증명서 최인이라고도 불린다)의 타당성을 검사하기 위한 클래스입니다.

이 클래스에서는 「Java 암호화 아키텍쳐」로 설명되고 있는 것 같은 프로바이더 베이스의 아키텍쳐를 사용합니다. CertPathValidator 를 작성하려면 , static getInstance 메소드 가운데 1 개를 호출해, 작성하는 CertPathValidator 의 알고리즘명과 프로바이더명 (생략 가능)을 건네줍니다.

CertPathValidator 오브젝트가 작성되면(자),validate 메소드를 호출해, 검증 대상의 CertPath 와 알고리즘에 특정의 파라미터 세트를 건네주는 것으로, 증명서 패스가 검사됩니다. 증명서 패스의 검사에 성공하면(자),CertPathValidatorResult 인터페이스를 구현하는 오브젝트에 그 결과가 돌려주어집니다.

병행 액세스

이 클래스의 static 메소드는 thread 세이프인 것이 프로텍션되고 있습니다. 이 클래스에서 정의되고 있는 static 메소드는 악영향을 주는 일 없이, 복수 thread가 병행해 호출할 수가 있습니다.

그러나 이것은 이 클래스에서 정의되고 있는 비 static 메소드에는 들어맞지 않습니다. 특정의 프로바이더로 특히 설명이 없는 한, 단일 CertPathValidator 인스턴스에 병행해 액세스 할 필요가 있는 복수 thread는 thread간에 동기를 잡아, 필요에 따라서 잠그지 않으면 안됩니다. 다른 CertPathValidator 인스턴스를 조작하는 복수 thread간으로는 동기를 잡을 필요는 없습니다.

도입된 버젼:

1.4

관련 항목:

CertPath

생성자의 개요

protected

CertPathValidator (CertPathValidatorSpi validatorSpi, Provider provider, String algorithm) 지정된 알고리즘의 CertPathValidator 오브젝트를 작성해, 지정된 프로바이더의 구현 (SPI 오브젝트)을 거기에 캡슐화합니다.

메소드의 개요

String	getAlgorithm () 이 CertPathValidator 의 알고리즘명을 돌려줍니다.
static String	getDefaultType () Java 시큐러티 프로퍼티 파일로 지정되고 있는 디폴트의 CertPathValidator 타입을 돌려줍니다.
static CertPathValidator	getInstance (String algorithm) 지정한 알고리즘을 구현하는 CertPathValidator 오브젝트를 돌려줍니다.
static CertPathValidator	getInstance (String algorithm, Provider provider) 지정한 프로바이더가 제공하는 지정한 알고리즘을 구현하는 CertPathValidator 오브젝트를 돌려줍니다.
static CertPathValidator	getInstance (String algorithm, String provider) 지정한 프로바이더가 제공하는 지정한 알고리즘을 구현하는 CertPathValidator 오브젝트를 돌려줍니다.
Provider	getProvider () 이 CertPathValidator 의 Provider 를 돌려줍니다.
CertPathValidatorResult	validate (CertPath certPath, CertPathParameters params) 지정한 알고리즘의 파라미터 세트를 사용해, 지정한 증명서 패스를 검사합니다.

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

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

생성자의 상세

CertPathValidator

protected CertPathValidator(CertPathValidatorSpi  validatorSpi,
                            Provider  provider,
                            String  algorithm)

지정된 알고리즘의 CertPathValidator 오브젝트를 작성해, 지정된 프로바이더의 구현 (SPI 오브젝트)을 거기에 캡슐화합니다.

파라미터:

validatorSpi - 프로바이더의 구현

provider - 프로바이더

algorithm - 알고리즘명

메소드의 상세

getInstance

public static CertPathValidator  getInstance(String  algorithm)
                                     throws NoSuchAlgorithmException 

지정한 알고리즘을 구현하는 CertPathValidator 오브젝트를 돌려줍니다.

지정한 CertPathValidator 알고리즘의 구현을 디폴트의 프로바이더 패키지가 제공하고 있는 경우는 그 구현을 포함한 CertPathValidator 의 인스턴스가 돌려주어집니다. 디폴트 패키지로 목적의 알고리즘이 제공되어 있지 않은 경우에는 다른 패키지가 검색됩니다.

파라미터:

algorithm - 요구한 CertPathValidator 알고리즘의 이름

반환값:

지정한 알고리즘을 구현하는 CertPathValidator 오브젝트

예외:

NoSuchAlgorithmException - 요구되는 알고리즘이, 디폴트의 프로바이더 패키지에도, 검색한 것 외의 프로바이더 패키지에도 없는 경우

getInstance

public static CertPathValidator  getInstance(String  algorithm,
                                            String  provider)
                                     throws NoSuchAlgorithmException ,
                                            NoSuchProviderException 

지정한 프로바이더가 제공하는 지정한 알고리즘을 구현하는 CertPathValidator 오브젝트를 돌려줍니다.

파라미터:

algorithm - 요구한 CertPathValidator 알고리즘의 이름

provider - 프로바이더명

반환값:

지정한 프로바이더가 제공하는 지정한 알고리즘을 구현하는 CertPathValidator 오브젝트

예외:

NoSuchAlgorithmException - 지정된 프로바이더에 요구한 알고리즘이 없는 경우

NoSuchProviderException - 프로바이더가 설정되어 있지 않은 경우

IllegalArgumentException - provider 가 null 의 경우

getInstance

public static CertPathValidator  getInstance(String  algorithm,
                                            Provider  provider)
                                     throws NoSuchAlgorithmException 

지정한 프로바이더가 제공하는 지정한 알고리즘을 구현하는 CertPathValidator 오브젝트를 돌려줍니다. 주: provider 는 등록되어 있을 필요는 없습니다.

파라미터:

algorithm - 요구한 CertPathValidator 알고리즘의 이름

provider - 프로바이더

반환값:

지정한 프로바이더가 제공하는 지정한 알고리즘을 구현하는 CertPathValidator 오브젝트

예외:

NoSuchAlgorithmException - 지정된 프로바이더에 요구한 알고리즘이 없는 경우

IllegalArgumentException - provider 가 null 의 경우

getProvider

public final Provider  getProvider()

이 CertPathValidator 의 Provider 를 돌려줍니다.

반환값:

이 CertPathValidator 의 Provider

getAlgorithm

public final String  getAlgorithm()

이 CertPathValidator 의 알고리즘명을 돌려줍니다.

반환값:

이 CertPathValidator 의 알고리즘명

validate

public final CertPathValidatorResult  validate(CertPath  certPath,
                                              CertPathParameters  params)
                                       throws CertPathValidatorException ,
                                              InvalidAlgorithmParameterException 

지정한 알고리즘의 파라미터 세트를 사용해, 지정한 증명서 패스를 검사합니다.

지정한 CertPath 는 검사 알고리즘으로 서포트되고 있는 타입이 아니면 안됩니다. 그렇지 않은 경우는 InvalidAlgorithmParameterException 가 슬로우 됩니다. 예를 들어, PKIX 알고리즘을 구현하는 CertPathValidator 에서는 타입 X. 509 의 CertPath 오브젝트를 검사합니다.

파라미터:

certPath - 검사하는 CertPath

params - 알고리즘의 파라미터

반환값:

검사 알고리즘의 결과

예외:

CertPathValidatorException - CertPath 가 유효하지 않은 경우

InvalidAlgorithmParameterException - 지정한 파라미터인가, 지정한 CertPath 의 타입이, 이 CertPathValidator 로 부적절한 경우

getDefaultType

public static final String  getDefaultType()

Java 시큐러티 프로퍼티 파일로 지정되고 있는 디폴트의 CertPathValidator 타입을 돌려줍니다. 디폴트의 CertPathValidator 타입을 나타내는 프로퍼티가 없는 경우는 캐릭터 라인 「PKIX」를 돌려줍니다. Java 시큐러티 프로퍼티 파일은 <JAVA_HOME>/lib/security/java.security 라고 하는 파일에 있습니다. <JAVA_HOME> 는 SDK 가 인스톨 되고 있는 디렉토리입니다.

디폴트의 CertPathValidator 타입을 사용하는 것은 어플리케이션으로 getInstance 메소드를 호출할 때 하드 코드 된 타입을 사용하지 않는 경우, 및 유저가 독자적인 타입을 지정하지 않을 때에 디폴트의 타입을 제공하는 경우입니다.

디폴트의 CertPathValidator 타입을 변경하려면 , Java 시큐러티 프로퍼티 파일의 certpathvalidator.type 시큐러티 프로퍼티의 값을 목적의 타입으로 설정합니다.

반환값:

Java 시큐러티 프로퍼티 파일로 지정된 디폴트의 CertPathValidator 타입. 프로퍼티가 존재하지 않는 경우는 캐릭터 라인 「PKIX」