compact3

javax.security.sasl

Interface SaslClientFactory

public interface SaslClientFactory

创建实例 SaslClient接口。实现此接口的类必须是线程安全的，同时处理多个并发请求。它也必须有一个不接受任何参数的公共构造函数。

此接口通常不是由客户端直接访问，这将使用Sasl静态方法代替。然而，一个特定的环境中可以提供和安装一个新的或不同的SaslClientFactory。

从以下版本开始：

一点五

另请参见：

SaslClient， Sasl

方法摘要

Modifier and Type	Method and Description
SaslClient	createSaslClient(String[] mechanisms, String authorizationId, String protocol, String serverName, Map<String,?> props, CallbackHandler cbh) 使用提供的参数创建一个saslclient。
String[]	getMechanismNames(Map<String,?> props) 返回一个机制名称数组，该数组与指定的机制选择策略相匹配的机制。

方法详细信息

createSaslClient

SaslClient createSaslClient(String[] mechanisms,
                            String authorizationId,
                            String protocol,
                            String serverName,
                            Map<String,?> props,
                            CallbackHandler cbh)
                     throws SaslException

使用提供的参数创建一个saslclient。

参数

mechanisms -非空表机构名称的尝试。每个IANA注册名SASL机制。（例如“GSSAPI”、“CRAM-MD5”）。

authorizationId -可能的空协议相关的识别可用于授权。如果为空或空，服务器从客户端的身份验证凭据中派生一个授权标识。当SASL认证成功完成，指定的实体被授予访问。

protocol -非空字符串名称的协议的认证正在进行中（例如，“LDAP”）。

serverName -非空的完全限定主机名的服务器进行身份验证。

props -用于选择机制和配置的选择机制的认证交换性能可能是空集。看到一个标准的性能 Sasl类。其他，可能是特定的机制，属性可以包括。未被忽略的属性与所选机制无关，包括非字符串键的任何Map项。

cbh -可能的空回调函数通过SASL机制用于从应用程序/库得到进一步的信息来完成身份认证。例如，一个机制可能需要验证身份，从对方的密码和境界。认证ID是用 NameCallback要求。密码是用 PasswordCallback要求。境界是要求用 RealmChoiceCallback如果有一列领域的选择，以及如果领域必须输入一个 RealmCallback。

结果

使用提供的参数创建一个可能的空 SaslClient。如果为空，本厂不能产生 SaslClient使用提供的参数。

异常

SaslException如果不能创造一个 SaslClient因为错误。

getMechanismNames

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

返回一个机制名称数组，该数组与指定的机制选择策略相匹配的机制。

参数

props -用于指定SASL机制安全策略属性可能的空套。例如，如果 props包含 Sasl.POLICY_NOPLAINTEXT财产价值 "true"，那时工厂不能返回，很容易简单被动攻击任何SASL机制。看到一个完整的政策属性列表的 Sasl类。非政策相关的属性，如果存在 props，被忽视，包括任何非字符串键映射条目。

结果

一种含有IANA注册机制名非空数组。