58 * |
58 * |
59 * @param mechanism The non-null |
59 * @param mechanism The non-null |
60 * IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5"). |
60 * IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5"). |
61 * @param protocol The non-null string name of the protocol for which |
61 * @param protocol The non-null string name of the protocol for which |
62 * the authentication is being performed (e.g., "ldap"). |
62 * the authentication is being performed (e.g., "ldap"). |
63 * @param serverName The non-null fully qualified host name of the server |
63 * @param serverName The fully qualified host name of the server to |
64 * to authenticate to. |
64 * authenticate to, or null if the server is not bound to any specific host |
|
65 * name. If the mechanism does not allow an unbound server, a |
|
66 * <code>SaslException</code> will be thrown. |
65 * @param props The possibly null set of properties used to select the SASL |
67 * @param props The possibly null set of properties used to select the SASL |
66 * mechanism and to configure the authentication exchange of the selected |
68 * mechanism and to configure the authentication exchange of the selected |
67 * mechanism. See the <tt>Sasl</tt> class for a list of standard properties. |
69 * mechanism. See the <tt>Sasl</tt> class for a list of standard properties. |
68 * Other, possibly mechanism-specific, properties can be included. |
70 * Other, possibly mechanism-specific, properties can be included. |
69 * Properties not relevant to the selected mechanism are ignored, |
71 * Properties not relevant to the selected mechanism are ignored, |