compact3

javax.security.sasl

インタフェースSaslServerFactory

public interface SaslServerFactory

SaslServerのインスタンスを作成するためのインタフェースです。このインタフェースは、スレッド・セーフで、複数の要求を同時に処理できるクラスによって実装されます。このクラスは、引数をとらないpublicコンストラクタを持っている必要があります。

サーバーはSasl staticメソッドを使用するため、通常、このインタフェースに直接アクセスすることはありません。ただし、新しい、または異なるSaslServerFactoryが提供およびインストールされる環境もあります。

導入されたバージョン:

1.5

関連項目:

SaslServer、Sasl

メソッドのサマリー

修飾子と型	メソッドと説明
SaslServer	createSaslServer(String mechanism, String protocol, String serverName, Map<String,?> props, CallbackHandler cbh) 指定されたパラメータを使用してSaslServerを作成します。
String[]	getMechanismNames(Map<String,?> props) 指定されたメカニズム選択ポリシーに一致するメカニズム名の配列を返します。

メソッドの詳細

createSaslServer

SaslServer createSaslServer(String mechanism,
                            String protocol,
                            String serverName,
                            Map<String,?> props,
                            CallbackHandler cbh)
                     throws SaslException

指定されたパラメータを使用してSaslServerを作成します。指定のパラメータでSaslServerを作成できない場合はnullを返します。エラーのためSaslServerを作成できない場合はSaslExceptionをスローします。

パラメータ:

mechanism - IANAに登録済みのSASLメカニズム名。null以外。GSSAPIやCRAM-MD5などがある。

protocol - 認証対象のプロトコルの文字列名。null以外。ldapなどがある。

serverName - 認証先となるサーバーの完全修飾ホスト名またはnull(サーバーが特定のホスト名にバインドされていない場合)。バインドされていないサーバーをメカニズムが許可しない場合はSaslExceptionがスローされる。

props - SASLメカニズムの選択と、選択されたSASLメカニズムの認証交換の構成を行うためのプロパティのセット。nullの場合もある。標準プロパティのリストについては、Saslクラスの説明を参照。メカニズム固有のプロパティなど、標準以外のプロパティも含めることができる。選択されたメカニズムと関連性のないプロパティ(String形式でない鍵を持つマップ・エントリを含む)は無視される。

cbh - SASLメカニズムが、認証を完了するためにアプリケーションやライブラリからさらに詳しい情報を取得するときに使用するコールバック・ハンドラ。nullの場合もある。たとえば、呼出し側の認証ID、パスワードおよびレルムを要求するようなSASLメカニズムがある。認証IDの要求には、NameCallbackが使用される。パスワードの要求には、PasswordCallbackが使用される。レルムの要求には、選択可能なレルムのリストが存在する場合はRealmChoiceCallback、レルムを指定する必要がある場合はRealmCallbackが使用される。

戻り値:

指定されたパラメータを使用して作成されたSaslServer。nullの場合もある。nullの場合、このファクトリは、指定されたパラメータを使用してSaslServerを作成できない。

例外:

SaslException - エラーのためにSaslServerを作成できない場合。

getMechanismNames

String[] getMechanismNames(Map<String,?> props)

指定されたメカニズム選択ポリシーに一致するメカニズム名の配列を返します。

パラメータ:

props - SASLメカニズムのセキュリティ・ポリシーの指定に使用されるプロパティのセット。nullの可能性もある。たとえば、propsに含まれるSasl.POLICY_NOPLAINTEXTプロパティの値がtrueの場合、ファクトリは、単純な受動的攻撃を受けやすいSASLメカニズムを返してはいけない。ポリシー・プロパティの完全なリストについては、Saslクラスの説明を参照。props内にポリシーと関連性のないプロパティ(String以外のキーを持つマップ・エントリを含む)が存在する場合、無視される。

戻り値:

IANAに登録済みのSASLメカニズム名を含むnull以外の配列。