クラスCertPathValidator

java.lang.Object

java.security.cert.CertPathValidator

public class CertPathValidator extends Object

証明書パス(証明書チェーンとも呼ばれる)の妥当性を検査するためのクラスです。

このクラスは、プロバイダ・ベースのアーキテクチャを使用します。 CertPathValidatorを作成するには、static getInstanceメソッドのうちの1つを呼び出して、作成するCertPathValidatorのアルゴリズ� 名とプロバイダ名(オプション)を渡します。

CertPathValidatorオブジェクトが作成されると、validateメソッドを呼び出して、検証対象のCertPathとアルゴリズ� 固有のパラメータ・セットを渡すことで、証明書パスが検査されます。 証明書パスの検査に成功すると、CertPathValidatorResultインタフェースを実装するオブジェクトにその結果が返されます。

アプリケーションはgetRevocationChecker()メソッドを使用して、CertPathValidatorが証明書の失効ステータスをチェックするときに使用する追� のアルゴリズ� 固有のパラメータおよびオプションを指定できます。 次の例は、PKIXアルゴリズ� での使用方法を示しています。

 CertPathValidator cpv = CertPathValidator.getInstance("PKIX");
 PKIXRevocationChecker rc = (PKIXRevocationChecker)cpv.getRevocationChecker();
 rc.setOptions(EnumSet.of(Option.SOFT_FAIL));
 params.addCertPathChecker(rc);
 CertPathValidatorResult cpvr = cpv.validate(path, params);
 

Javaプラットフォー� の実装は、すべて次の標準のCertPathValidatorアルゴリズ� をサポートする必要があります。

• PKIX

このアルゴリズ� は、Javaセキュリティ標準アルゴリズ� 名仕様の「CertPathValidatorセクション」で説明されています。 サポートされているその他のアルゴリズ� については、実装のリリース・ドキュメントを参照してく� さい。

並行アクセス

このクラスのstaticメソッドは、スレッド・セーフであることが保証されています。 このクラスで定義されているstaticメソッドは、悪影響を与えることなく、複数スレッドが並行して呼び出すことができます。

しかしこのことは、このクラスで定義されている非staticメソッドには当てはまりません。 特定のプロバイダで特に説明がないかぎり、単一のCertPathValidatorインスタンスに並行してアクセスする必要のある複数スレッドは、スレッド間で同期を取り、必要に応じてロックしなければいけません。 異なるCertPathValidatorインスタンスを操作する複数スレッドは、同期化される必要はありません。

導入されたバージョン:

1.4

関連� �目:

• CertPath

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタ	説明
protected	CertPathValidator(CertPathValidatorSpi validatorSpi, Provider provider, String algorithm)	指定されたアルゴリズ� のCertPathValidatorオブジェクトを作成し、指定されたプロバイダの実装(SPIオブジェクト)をそこにカプセル化します。

メソッドのサマリー

修飾子と型	メソッド	説明
final String	getAlgorithm()	このCertPathValidatorのアルゴリズ� 名を返します。
static final String	getDefaultType()	certpathvalidator.typeセキュリティ・プロパティに指定されたデフォルトのCertPathValidatorタイプを返します。該当するプロパティが存在しない� �合は文字列「PKIX」を返します。
static CertPathValidator	getInstance(String algorithm)	指定されたアルゴリズ� を実装するCertPathValidatorオブジェクトを返します。
static CertPathValidator	getInstance(String algorithm, String provider)	指定されたアルゴリズ� を実装するCertPathValidatorオブジェクトを返します。
static CertPathValidator	getInstance(String algorithm, Provider provider)	指定されたアルゴリズ� を実装するCertPathValidatorオブジェクトを返します。
final Provider	getProvider()	このCertPathValidatorのProviderを返します。
final CertPathChecker	getRevocationChecker()	カプセル化されたCertPathValidatorSpi実装が証明書の失効ステータスをチェックするために使用するCertPathCheckerを返します。
final 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オブジェクトを返します。

このメソッドは、最優先のProviderから� �に、登録済みのセキュリティProviderのリストをトラバースします。 指定されたアルゴリズ� をサポートする最初のProviderのCertPathValidatorSpi実装をカプセル化する新しいCertPathValidatorオブジェクトが返されます。

登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。

実装上のノート:

JDKリファレンス実装では、さらにjdk.security.provider.preferred Securityプロパティを使用して、指定したアルゴリズ� の優先プロバイダ� �序を決定します。 これは、Security.getProviders()によって返されるプロバイダの� �序とは異なる� �合があります。

パラメータ:

algorithm - 要求するCertPathValidatorアルゴリズ� の名前。 標準アルゴリズ� 名の詳細は、「Javaセキュリティ標準アルゴリズ� 名仕様」のCertPathValidatorの� �を参照してく� さい。

戻り値:

指定されたアルゴリズ� を実装するCertPathValidatorオブジェクト

スロー:

NoSuchAlgorithmException - Providerが、指定されたアルゴリズ� のCertPathValidatorSpi実装をサポートしていない� �合

NullPointerException - algorithmがnullである� �合

関連� �目:

• Provider

getInstance

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

指定されたアルゴリズ� を実装するCertPathValidatorオブジェクトを返します。

指定されたプロバイダのCertPathValidatorSpi実装をカプセル化する新しいCertPathValidatorオブジェクトが返されます。 指定したプロバイダは、セキュリティ・プロバイダ・リストに登録する必要があります。

登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。

パラメータ:

algorithm - 要求するCertPathValidatorアルゴリズ� の名前。 標準アルゴリズ� 名の詳細は、「Javaセキュリティ標準アルゴリズ� 名仕様」のCertPathValidatorの� �を参照してく� さい。

provider - プロバイダ名。

戻り値:

指定されたアルゴリズ� を実装するCertPathValidatorオブジェクト

スロー:

IllegalArgumentException - providerがnullまたは空の� �合

NoSuchAlgorithmException - 指定されたアルゴリズ� のCertPathValidatorSpi実装が、指定されたプロバイダから利用可能でない� �合

NoSuchProviderException - 指定されたプロバイダがセキュリティ・プロバイダ・リストに登録されていない� �合

NullPointerException - algorithmがnullである� �合

関連� �目:

• Provider

getInstance

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

指定されたアルゴリズ� を実装するCertPathValidatorオブジェクトを返します。

指定されたProviderオブジェクトのCertPathValidatorSpi実装をカプセル化する新しいCertPathValidatorオブジェクトが返されます。 指定されたProviderオブジェクトは、プロバイダ・リストに登録する必要はありません。

パラメータ:

algorithm - 要求するCertPathValidatorアルゴリズ� の名前。 標準アルゴリズ� 名の詳細は、「Javaセキュリティ標準アルゴリズ� 名仕様」のCertPathValidatorの� �を参照してく� さい。

provider - プロバイダ

戻り値:

指定されたアルゴリズ� を実装するCertPathValidatorオブジェクト

スロー:

IllegalArgumentException - providerがnullの� �合

NoSuchAlgorithmException - 指定されたProviderオブジェクトから指定されたアルゴリズ� のCertPathValidatorSpi実装を使用できない� �合

NullPointerException - algorithmがnullである� �合

関連� �目:

• Provider

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()

certpathvalidator.typeセキュリティ・プロパティに指定されたデフォルトのCertPathValidatorタイプを返します。該当するプロパティが存在しない� �合は文字列「PKIX」を返します。

デフォルトのCertPathValidatorタイプを使用するのは、アプリケーションでgetInstanceメソッドを呼び出すときにハードコードされたタイプを使用しない� �合、およびユーザーが独自のタイプを指定しないときにデフォルトのタイプを提供する� �合です。

デフォルトのCertPathValidatorタイプは、certpathvalidator.typeセキュリティ・プロパティの値を目的のタイプに設定することで変更できます。

戻り値:

certpathvalidator.typeセキュリティ・プロパティに指定されているデフォルトのCertPathValidatorタイプ、該当するプロパティが存在しない� �合は文字列「PKIX」。

関連� �目:

• セキュリティ・プロパティ

getRevocationChecker

public final CertPathChecker getRevocationChecker()

カプセル化されたCertPathValidatorSpi実装が証明書の失効ステータスをチェックするために使用するCertPathCheckerを返します。 PKIX実装は、PKIXRevocationChecker型のオブジェクトを返します。 このメソッドを呼び出すたびに、CertPathCheckerの新しいインスタンスが返されます。

このメソッドの主な目的は、呼出し側が失効チェックに固有の追� の入力パラメータおよびオプションを指定できるようにすることです。 具体例については、クラスの説明を参照してく� さい。

戻り値:

CertPathChecker

スロー:

UnsupportedOperationException - サービス・プロバイダがこのメソッドをサポートしない� �合

導入されたバージョン:

1.8