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 以外

props - SASL 機構の選択と、選択された SASL 機構の認証交換の設定を行うプロパティのセット。null の可能性もある。標準プロパティのリストについては、Sasl クラスの説明を参照。機構固有のプロパティなど、標準以外のプロパティも含めることができる。選択された機構と関連性のないプロパティは無視される

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

戻り値:

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

例外:

SaslException

getMechanismNames

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

指定された機構選択ポリシーに一致する機構名の配列を返します。

パラメータ:

props - SASL 機構のセキュリティポリシーの指定に使用されるプロパティのセット。null の可能性もある。たとえば、props に含まれる Sasl.POLICY_NOPLAINTEXT プロパティの値が「true」の場合、ファクトリは、単純な受動的攻撃を受けやすい SASL 機構を返してはならない。ポリシープロパティの完全なリストについては、Sasl クラスの説明を参照。props に含まれるプロパティがポリシーとは関係がない場合、これらのプロパティは無視される

戻り値:

IANA に登録済みの SASL 機構名を含む null 以外の配列