|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface SaslServerFactory
An interface for creating instances of SaslServer. A class that
implements this interface must be thread-safe and handle multiple
simultaneous requests. It must also have a public constructor that accepts
no arguments.
This interface is not normally accessed directly by a server, which will
use the Sasl static methods to create a SaslServer instance
instead. However, a particular environment may provide and install a new or
different SaslServerFactory.
SaslServer,
Sasl| Method Summary | |
|---|---|
SaslServer |
createSaslServer(String mechanism,
String protocol,
String serverName,
Map<String,?> props,
CallbackHandler cbh)
Creates a SaslServer instance using the parameters supplied. |
String[] |
getMechanismNames(Map<String,?> props)
Returns an array of names of mechanisms that match the specified mechanism selection policies. |
| Method Detail |
|---|
SaslServer createSaslServer(String mechanism,
String protocol,
String serverName,
Map<String,?> props,
CallbackHandler cbh)
throws SaslException
SaslServer instance using the parameters supplied. It
returns null if no SaslServer instance can be created
using the parameters supplied. Throws SaslException if it cannot
create a SaslServer because of an error.
mechanism - the non-null IANA-registered name of a SASL mechanism
(e.g. "GSSAPI", "CRAM-MD5").protocol - the non-null string name of the protocol for which the
authentication is being performed (e.g. "ldap").serverName - the non-null fully qualified host name of the server to
authenticate to.props - the possibly null set of properties used to select the SASL
mechanism and to configure the authentication exchange of the selected
mechanism. See the Sasl class for a list of standard properties.
Other, possibly mechanism-specific, properties can be included. Properties
not relevant to the selected mechanism are ignored.cbh - the possibly null callback handler to used by the SASL
mechanisms to get further information from the application/library to
complete the authentication. For example, a SASL mechanism might require
the authentication ID, password and realm from the caller. The
authentication ID is requested by using a
NameCallback. The password is
requested by using a PasswordCallback.
The realm is requested by using a RealmChoiceCallback if there is
a list of realms to choose from, and by using a RealmCallback if
the realm must be entered.
SaslServer created using the parameters
supplied. If null is returned, it means that this factory
cannot produce a SaslServer using the parameters supplied.
SaslException - if a SaslServer instance cannot be created because
of an error.String[] getMechanismNames(Map<String,?> props)
props - the possibly null set of properties used to
specify the security policy of the SASL mechanisms. For example, if props
contains the Sasl.POLICY_NOPLAINTEXT property with the value
"true", then the factory must not return any SASL mechanisms
that are susceptible to simple plain passive attacks. See the Sasl
class for a complete list of policy properties. Non-policy related
properties, if present in props, are ignored.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||