Creates a
SaslServer using the parameters supplied.
It returns null
if no
SaslServer can be created using the parameters supplied.
Throws
SaslException if it cannot create a
SaslServer because of an error.
Returns:
A possibly null
SaslServer created using the parameters
supplied. If null, this factory cannot produce a
SaslServer
using the parameters supplied.
Parameters:
-
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,
including any map entries with non-String keys.
-
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.
Throws:
-
SaslException - If cannot create a
SaslServer because
of an error.