javax.net.ssl

インタフェース X509KeyManager

すべてのスーパーインタフェース:

KeyManager

既知のすべての実装クラス:

X509ExtendedKeyManager

public interface X509KeyManager
extends KeyManager

このインタフェースのインスタンスは、ローカル側のセキュアソケットを認証するときに使用する、X509 証明書ベースの鍵ペアを管理します。

実装は、セキュアソケットのネゴシエーション中に、次の目的でこのインタフェースのメソッドを呼び出します。

• 指定された条件に基づいて、ネゴシエーションに使用できる別名のセットを特定する。
• 指定された条件に基づいて、最適な別名を選択する。
• 指定された別名に対応する鍵データを取得する。

注:このクラスでは、X509ExtendedKeyManager の使用を優先することをお勧めします。

導入されたバージョン:

1.4

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
String	chooseClientAlias(String[] keyType, Principal[] issuers, Socket socket) 公開鍵のタイプおよびピアによって認識される証明書発行局のリストに基づいて、クライアント側のセキュアソケットを認証するときの別名を選択します。
String	chooseServerAlias(String keyType, Principal[] issuers, Socket socket) 公開鍵のタイプおよびピアによって認識される証明書発行局のリストに基づいて、サーバー側のセキュアソケットを認証するときの別名を選択します。
X509Certificate[]	getCertificateChain(String alias) 指定された別名に関連付けられている証明書チェーンを返します。
String[]	getClientAliases(String keyType, Principal[] issuers) 公開鍵のタイプおよびピアによって認識される証明書発行局のリストに基づいて、クライアント側のセキュアソケットを認証するときの別名を取得します。
PrivateKey	getPrivateKey(String alias) 指定された別名に関連付けられている鍵を返します。
String[]	getServerAliases(String keyType, Principal[] issuers) 公開鍵のタイプおよびピアによって認識される証明書発行局のリストに基づいて、サーバー側のセキュアソケットを認証するときの別名を取得します。

メソッドの詳細

getClientAliases

String[] getClientAliases(String keyType,
                        Principal[] issuers)

公開鍵のタイプおよびピアによって認識される証明書発行局のリストに基づいて、クライアント側のセキュアソケットを認証するときの別名を取得します。

パラメータ:

keyType - 鍵アルゴリズムのタイプ名

issuers - 受け入れ可能な CA 発行者のサブジェクト名のリスト。任意の発行者を受け入れることができる場合は null。

戻り値:

条件に一致する別名の配列。一致する別名がない場合は null。

chooseClientAlias

String chooseClientAlias(String[] keyType,
                       Principal[] issuers,
                       Socket socket)

公開鍵のタイプおよびピアによって認識される証明書発行局のリストに基づいて、クライアント側のセキュアソケットを認証するときの別名を選択します。

パラメータ:

keyType - 鍵アルゴリズムのタイプ名。優先順位の高い鍵タイプから順に指定する。

issuers - 受け入れ可能な CA 発行者のサブジェクト名のリスト。任意の発行者を受け入れることができる場合は null。

socket - この接続に使用するソケット。このパラメータは null も可。null の場合は、このインタフェースの実装が、任意のソケットに適用可能な別名を自由に選択できることを示す。

戻り値:

指定された鍵の別名。対応する別名がない場合は null。

getServerAliases

String[] getServerAliases(String keyType,
                        Principal[] issuers)

公開鍵のタイプおよびピアによって認識される証明書発行局のリストに基づいて、サーバー側のセキュアソケットを認証するときの別名を取得します。

パラメータ:

keyType - 鍵アルゴリズムのタイプ名

issuers - 受け入れ可能な CA 発行者のサブジェクト名のリスト。任意の発行者を受け入れることができる場合は null。

戻り値:

条件に一致する別名の配列。一致する別名がない場合は null。

chooseServerAlias

String chooseServerAlias(String keyType,
                       Principal[] issuers,
                       Socket socket)

公開鍵のタイプおよびピアによって認識される証明書発行局のリストに基づいて、サーバー側のセキュアソケットを認証するときの別名を選択します。

パラメータ:

keyType - 鍵アルゴリズムのタイプ名。

issuers - 受け入れ可能な CA 発行者のサブジェクト名のリスト。任意の発行者を受け入れることができる場合は null。

socket - この接続に使用するソケット。このパラメータは null も可。null の場合は、このインタフェースの実装が、任意のソケットに適用可能な別名を自由に選択できることを示す。

戻り値:

指定された鍵の別名。対応する別名がない場合は null。

getCertificateChain

X509Certificate[] getCertificateChain(String alias)

指定された別名に関連付けられている証明書チェーンを返します。

パラメータ:

alias - 別名

戻り値:

証明書チェーン。ユーザーの証明書が最初に配置され、ルート証明書発行局が最後に配置されている。別名が見つからない場合は null。

getPrivateKey

PrivateKey getPrivateKey(String alias)

指定された別名に関連付けられている鍵を返します。

パラメータ:

alias - 別名

戻り値:

要求された鍵。別名が見つからない場合は null。