javax.net.ssl
インタフェース X509KeyManager

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

KeyManager

public interface X509KeyManager

extends KeyManager

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

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

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

導入されたバージョン:

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

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

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

パラメータ:

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

issuers - 受け入れることができる CA 発行者の被認証者名。任意の発行者を受け入れることができる場合は null

戻り値:

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

chooseClientAlias

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

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

パラメータ:

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

issuers - 受け入れることができる CA 発行者の被認証者名。任意の発行者を受け入れることができる場合は null

socket - この接続で使用するソケット。このパラメータを null にした場合は、もっとも汎用的な別名が返される

戻り値:

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

getServerAliases

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

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

パラメータ:

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

issuers - 受け入れることができる CA 発行者の被認証者名。任意の発行者を受け入れることができる場合は null

戻り値:

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

chooseServerAlias

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

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

パラメータ:

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

issuers - 受け入れることができる CA 発行者の被認証者名。任意の発行者を受け入れることができる場合は null

socket - この接続で使用するソケット。このパラメータを null にした場合は、もっとも汎用的な別名が返される

戻り値:

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

getCertificateChain

public X509Certificate[] getCertificateChain(String alias)

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

パラメータ:

alias - 別名

戻り値:

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

getPrivateKey

public PrivateKey getPrivateKey(String alias)

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

パラメータ:

alias - 別名

戻り値:

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