equal
deleted
inserted
replaced
276 /** |
276 /** |
277 * Creates a <tt>SaslClient</tt> using the parameters supplied. |
277 * Creates a <tt>SaslClient</tt> using the parameters supplied. |
278 * |
278 * |
279 * This method uses the |
279 * This method uses the |
280 <a href="{@docRoot}/../technotes/guides/security/crypto/CryptoSpec.html#Provider">JCA Security Provider Framework</a>, described in the |
280 <a href="{@docRoot}/../technotes/guides/security/crypto/CryptoSpec.html#Provider">JCA Security Provider Framework</a>, described in the |
281 * "Java Cryptography Architecture API Specification & Reference", for |
281 * "Java Cryptography Architecture API Specification & Reference", for |
282 * locating and selecting a <tt>SaslClient</tt> implementation. |
282 * locating and selecting a <tt>SaslClient</tt> implementation. |
283 * |
283 * |
284 * First, it |
284 * First, it |
285 * obtains an ordered list of <tt>SaslClientFactory</tt> instances from |
285 * obtains an ordered list of <tt>SaslClientFactory</tt> instances from |
286 * the registered security providers for the "SaslClientFactory" service |
286 * the registered security providers for the "SaslClientFactory" service |
301 * <tt>com.wiz.sasl.digest.ClientFactory</tt>, that supports the |
301 * <tt>com.wiz.sasl.digest.ClientFactory</tt>, that supports the |
302 * "DIGEST-MD5" mechanism would register the following entry with the JCA: |
302 * "DIGEST-MD5" mechanism would register the following entry with the JCA: |
303 * <tt>SaslClientFactory.DIGEST-MD5 com.wiz.sasl.digest.ClientFactory</tt> |
303 * <tt>SaslClientFactory.DIGEST-MD5 com.wiz.sasl.digest.ClientFactory</tt> |
304 *<p> |
304 *<p> |
305 * See the |
305 * See the |
306 * "Java Cryptography Architecture API Specification & Reference" |
306 * "Java Cryptography Architecture API Specification & Reference" |
307 * for information about how to install and configure security service |
307 * for information about how to install and configure security service |
308 * providers. |
308 * providers. |
309 * |
309 * |
310 * @param mechanisms The non-null list of mechanism names to try. Each is the |
310 * @param mechanisms The non-null list of mechanism names to try. Each is the |
311 * IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5"). |
311 * IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5"). |
426 * Creates a <tt>SaslServer</tt> for the specified mechanism. |
426 * Creates a <tt>SaslServer</tt> for the specified mechanism. |
427 * |
427 * |
428 * This method uses the |
428 * This method uses the |
429 <a href="{@docRoot}/../technotes/guides/security/crypto/CryptoSpec.html#Provider">JCA Security Provider Framework</a>, |
429 <a href="{@docRoot}/../technotes/guides/security/crypto/CryptoSpec.html#Provider">JCA Security Provider Framework</a>, |
430 * described in the |
430 * described in the |
431 * "Java Cryptography Architecture API Specification & Reference", for |
431 * "Java Cryptography Architecture API Specification & Reference", for |
432 * locating and selecting a <tt>SaslServer</tt> implementation. |
432 * locating and selecting a <tt>SaslServer</tt> implementation. |
433 * |
433 * |
434 * First, it |
434 * First, it |
435 * obtains an ordered list of <tt>SaslServerFactory</tt> instances from |
435 * obtains an ordered list of <tt>SaslServerFactory</tt> instances from |
436 * the registered security providers for the "SaslServerFactory" service |
436 * the registered security providers for the "SaslServerFactory" service |
451 * <tt>com.wiz.sasl.digest.ServerFactory</tt>, that supports the |
451 * <tt>com.wiz.sasl.digest.ServerFactory</tt>, that supports the |
452 * "DIGEST-MD5" mechanism would register the following entry with the JCA: |
452 * "DIGEST-MD5" mechanism would register the following entry with the JCA: |
453 * <tt>SaslServerFactory.DIGEST-MD5 com.wiz.sasl.digest.ServerFactory</tt> |
453 * <tt>SaslServerFactory.DIGEST-MD5 com.wiz.sasl.digest.ServerFactory</tt> |
454 *<p> |
454 *<p> |
455 * See the |
455 * See the |
456 * "Java Cryptography Architecture API Specification & Reference" |
456 * "Java Cryptography Architecture API Specification & Reference" |
457 * for information about how to install and configure security |
457 * for information about how to install and configure security |
458 * service providers. |
458 * service providers. |
459 * |
459 * |
460 * @param mechanism The non-null mechanism name. It must be an |
460 * @param mechanism The non-null mechanism name. It must be an |
461 * IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5"). |
461 * IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5"). |