|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.security.cert.CertPathValidator
証明書パス (証明書チェインとも呼ばれる) の妥当性を検査するためのクラスです。
このクラスでは、「Java 暗号化アーキテクチャ」で説明されているような、プロバイダベースのアーキテクチャを使用します。CertPathValidator
を作成するには、static getInstance
メソッドのうちの 1 つを呼び出して、作成する CertPathValidator
のアルゴリズム名とプロバイダ名 (省略可能) を渡します。
CertPathValidator
オブジェクトが作成されると、validate
メソッドを呼び出して、検証対象の CertPath
とアルゴリズムに特定のパラメータセットを渡すことで、証明書パスが検査されます。証明書パスの検査に成功すると、CertPathValidatorResult
インタフェースを実装するオブジェクトにその結果が返されます。
並行アクセス
このクラスの static メソッドは、スレッドセーフであることが保証されています。このクラスで定義されている static メソッドは、悪影響を与えることなく、複数スレッドが並行して呼び出すことができます。
しかしこのことは、このクラスで定義されている非 static メソッドには当てはまりません。特定のプロバイダで特に説明がない限り、単一 CertPathValidator
インスタンスに並行してアクセスする必要のある複数スレッドは、スレッド間で同期をとり、必要に応じてロックしなければなりません。異なる CertPathValidator
インスタンスを操作する複数スレッド間では、同期をとる必要はありません。
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 |
コンストラクタの詳細 |
protected CertPathValidator(CertPathValidatorSpi validatorSpi, Provider provider, String algorithm)
CertPathValidator
オブジェクトを作成し、指定されたプロバイダの実装 (SPI オブジェクト) をそこにカプセル化します。
validatorSpi
- プロバイダの実装provider
- プロバイダalgorithm
- アルゴリズム名メソッドの詳細 |
public static CertPathValidator getInstance(String algorithm) throws NoSuchAlgorithmException
CertPathValidator
オブジェクトを返します。
指定した CertPathValidator
アルゴリズムの実装をデフォルトのプロバイダパッケージが提供している場合は、その実装を含む CertPathValidator
のインスタンスが返されます。デフォルトパッケージで目的のアルゴリズムが提供されていない場合には、ほかのパッケージが検索されます。
algorithm
- 要求した CertPathValidator
アルゴリズムの名前
CertPathValidator
オブジェクト
NoSuchAlgorithmException
- 要求されるアルゴリズムが、デフォルトのプロバイダパッケージにも、検索したほかのプロバイダパッケージにもない場合public static CertPathValidator getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException
CertPathValidator
オブジェクトを返します。
algorithm
- 要求した CertPathValidator
アルゴリズムの名前provider
- プロバイダ名
CertPathValidator
オブジェクト
NoSuchAlgorithmException
- 指定されたプロバイダに要求したアルゴリズムがない場合
NoSuchProviderException
- プロバイダが設定されていない場合
IllegalArgumentException
- provider
が null の場合public static CertPathValidator getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException
CertPathValidator
オブジェクトを返します。注: provider
は登録されている必要はありません。
algorithm
- 要求した CertPathValidator
アルゴリズムの名前provider
- プロバイダ
CertPathValidator
オブジェクト
NoSuchAlgorithmException
- 指定されたプロバイダに要求したアルゴリズムがない場合
IllegalArgumentException
- provider
が null の場合public final Provider getProvider()
CertPathValidator
の Provider
を返します。
CertPathValidator
の Provider
public final String getAlgorithm()
CertPathValidator
のアルゴリズム名を返します。
CertPathValidator
のアルゴリズム名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
で不適切である場合public static final String getDefaultType()
CertPathValidator
タイプを返します。デフォルトの CertPathValidator
タイプを示すプロパティがない場合は、文字列「PKIX」を返します。Java セキュリティプロパティファイルは、<JAVA_HOME>/lib/security/java.security というファイルにあります。<JAVA_HOME> は、SDK がインストールされているディレクトリです。
デフォルトの CertPathValidator
タイプを使用するのは、アプリケーションで getInstance
メソッドを呼び出すときにハードコードされたタイプを使用しない場合、およびユーザが独自のタイプを指定しないときにデフォルトのタイプを提供する場合です。
デフォルトの CertPathValidator
タイプを変更するには、Java セキュリティプロパティファイルの certpathvalidator.type セキュリティプロパティの値を目的のタイプに設定します。
CertPathValidator
タイプ。プロパティが存在しない場合は、文字列「PKIX」
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.