Javaプラットフォームのすべての実装は、次の標準のTrustManagerFactory
アルゴリズムをサポートする必要があります:
PKIX
- 導入されたバージョン:
- 1.4
- 関連項目:
-
コンストラクタのサマリー
修飾子コンストラクタ説明protected
TrustManagerFactory
(TrustManagerFactorySpi factorySpi, Provider provider, String algorithm) TrustManagerFactoryオブジェクトを生成します。 -
メソッドのサマリー
修飾子と型メソッド説明final String
このTrustManagerFactory
オブジェクトのアルゴリズム名を返します。static final String
デフォルトのTrustManagerFactoryアルゴリズム名を取得します。static final TrustManagerFactory
getInstance
(String algorithm) キー・マネージャのファクトリとして機能するTrustManagerFactory
オブジェクトを返します。static final TrustManagerFactory
getInstance
(String algorithm, String provider) キー・マネージャのファクトリとして機能するTrustManagerFactory
オブジェクトを返します。static final TrustManagerFactory
getInstance
(String algorithm, Provider provider) キー・マネージャのファクトリとして機能するTrustManagerFactory
オブジェクトを返します。final Provider
このTrustManagerFactory
オブジェクトのプロバイダを返します。final TrustManager[]
信頼データの種類ごとに1つの信頼マネージャを返します。final void
証明書発行局と関連する信頼データのソースを使用して、このファクトリを初期化します。final void
init
(ManagerFactoryParameters spec) プロバイダ固有の信頼データのソースを使用して、このファクトリを初期化します。
-
コンストラクタの詳細
-
TrustManagerFactory
protected TrustManagerFactory(TrustManagerFactorySpi factorySpi, Provider provider, String algorithm) TrustManagerFactoryオブジェクトを生成します。- パラメータ:
factorySpi
- 委譲先provider
- プロバイダalgorithm
- アルゴリズム
-
-
メソッドの詳細
-
getDefaultAlgorithm
public static final String getDefaultAlgorithm()デフォルトのTrustManagerFactoryアルゴリズム名を取得します。実行時にデフォルトのTrustManagerを変更するには、
ssl.TrustManagerFactory.algorithm
セキュリティ・プロパティの値を目的のアルゴリズム名に設定します。- 戻り値:
ssl.TrustManagerFactory.algorithm
セキュリティ・プロパティにより指定されているデフォルトのアルゴリズム名。そのようなプロパティが存在しない場合は実装固有のデフォルト。- 関連項目:
-
getAlgorithm
public final String getAlgorithm()このTrustManagerFactory
オブジェクトのアルゴリズム名を返します。これは、この
TrustManagerFactory
オブジェクトを作成したgetInstance
呼出しのいずれかに指定された名前と同じです。- 戻り値:
- この
TrustManagerFactory
オブジェクトのアルゴリズム名
-
getInstance
public static final TrustManagerFactory getInstance(String algorithm) throws NoSuchAlgorithmException キー・マネージャのファクトリとして機能するTrustManagerFactory
オブジェクトを返します。このメソッドは、最優先のProviderから順に、登録済みのセキュリティProviderのリストをトラバースします。 指定されたアルゴリズムをサポートする最初のプロバイダからのTrustManagerFactorySpiの実装をカプセル化する新しいTrustManagerFactoryオブジェクトが返されます。
登録済みプロバイダのリストは、
Security.getProviders()
メソッド経由で取得できます。- 実装上のノート:
- JDKリファレンス実装では、
jdk.security.provider.preferred
Security
プロパティを使用して、指定されたアルゴリズムの優先プロバイダの順序を決定します。 これは、Security.getProviders()
によって返されるプロバイダの順序とは異なる場合があります。 - パラメータ:
algorithm
- 要求された信頼管理アルゴリズムの標準名。 標準のアルゴリズム名の詳細は、Java Security Standard Algorithm Names Specificationの「TrustManagerFactoryセクション」を参照してください。- 戻り値:
- 新しい
TrustManagerFactory
オブジェクト - 例外:
NoSuchAlgorithmException
-Provider
が、指定されたアルゴリズムのTrustManagerFactorySpi
実装をサポートしていない場合NullPointerException
-algorithm
がnull
である場合- 関連項目:
-
getInstance
public static final TrustManagerFactory getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException キー・マネージャのファクトリとして機能するTrustManagerFactory
オブジェクトを返します。指定されたプロバイダからのKeyManagerFactorySpiの実装をカプセル化する新しいKeyManagerFactoryオブジェクトが返されます。 指定したプロバイダは、セキュリティ・プロバイダ・リストに登録する必要があります。
登録済みプロバイダのリストは、
Security.getProviders()
メソッド経由で取得できます。- パラメータ:
algorithm
- 要求された信頼管理アルゴリズムの標準名。 標準のアルゴリズム名の詳細は、Java Security Standard Algorithm Names Specificationの「TrustManagerFactoryセクション」を参照してください。provider
- プロバイダ名。- 戻り値:
- 新しい
TrustManagerFactory
オブジェクト - 例外:
IllegalArgumentException
- プロバイダ名がnull
または空の場合NoSuchAlgorithmException
- 指定されたアルゴリズムのTrustManagerFactorySpi
実装が、指定されたプロバイダから利用可能でない場合NoSuchProviderException
- 指定されたプロバイダがセキュリティ・プロバイダ・リストに登録されていない場合NullPointerException
-algorithm
がnull
である場合- 関連項目:
-
getInstance
public static final TrustManagerFactory getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException キー・マネージャのファクトリとして機能するTrustManagerFactory
オブジェクトを返します。指定されたProviderオブジェクトからのTrustManagerFactorySpiの実装をカプセル化する新しいTrustManagerFactoryオブジェクトが返されます。 指定されたProviderオブジェクトは、プロバイダ・リストに登録する必要はありません。
- パラメータ:
algorithm
- 要求された信頼管理アルゴリズムの標準名。 標準のアルゴリズム名の詳細は、Java Security Standard Algorithm Names Specificationの「TrustManagerFactoryセクション」を参照してください。provider
- プロバイダのインスタンス。- 戻り値:
- 新しい
TrustManagerFactory
オブジェクト - 例外:
IllegalArgumentException
- プロバイダがnull
の場合NoSuchAlgorithmException
- 指定されたアルゴリズムのTrustManagerFactorySpi
実装が、指定されたProvider
オブジェクトから使用できない場合NullPointerException
-algorithm
がnull
である場合- 関連項目:
-
getProvider
public final Provider getProvider()このTrustManagerFactory
オブジェクトのプロバイダを返します。- 戻り値:
- この
TrustManagerFactory
オブジェクトのプロバイダ
-
init
public final void init(KeyStore ks) throws KeyStoreException 証明書発行局と関連する信頼データのソースを使用して、このファクトリを初期化します。プロバイダは通常、キーストアを使用して、信頼を判断します。
より柔軟に初期化を行うには、
init(ManagerFactoryParameters)
を参照してください。- パラメータ:
ks
- キーストアまたはnull- 例外:
KeyStoreException
- この操作が失敗した場合
-
init
public final void init(ManagerFactoryParameters spec) throws InvalidAlgorithmParameterException プロバイダ固有の信頼データのソースを使用して、このファクトリを初期化します。一部のプロバイダでは、キーストア以外に、初期化パラメータを必要とすることがあります。 特定のプロバイダの利用者は、プロバイダによる定義に従って、適切な
ManagerFactoryParameters
の実装を渡す必要があります。 そのあと、プロバイダはManagerFactoryParameters
実装の特定のメソッドを呼び出し、必要な情報を取得できます。- パラメータ:
spec
- プロバイダ固有のパラメータ仕様の実装- 例外:
InvalidAlgorithmParameterException
- エラーが検出された場合
-
getTrustManagers
public final TrustManager[] getTrustManagers()信頼データの種類ごとに1つの信頼マネージャを返します。- 戻り値:
- 信頼マネージャ
- 例外:
IllegalStateException
- ファクトリが初期化されていない場合。
-