Package org.jivesoftware.smack.sasl.javax

Class SASLExternalMechanism

java.lang.Object

org.jivesoftware.smack.sasl.SASLMechanism

org.jivesoftware.smack.sasl.javax.SASLJavaXMechanism

org.jivesoftware.smack.sasl.javax.SASLExternalMechanism

All Implemented Interfaces:

Comparable<org.jivesoftware.smack.sasl.SASLMechanism>

public class SASLExternalMechanism
extends SASLJavaXMechanism

Implementation of the SASL EXTERNAL mechanism. To effectively use this mechanism, Java must be configured to properly supply a client SSL certificate (of some sort) to the server. It is up to the implementer to determine how to do this. Here is one method: Create a java keystore with your SSL certificate in it: keytool -genkey -alias username -dname "cn=username,ou=organizationalUnit,o=organizationalName,l=locality,s=state,c=country" Next, set the System Properties:

• javax.net.ssl.keyStore to the location of the keyStore
• javax.net.ssl.keyStorePassword to the password of the keyStore
• javax.net.ssl.trustStore to the location of the trustStore
• javax.net.ssl.trustStorePassword to the password of the trustStore

Then, when the server requests or requires the client certificate, java will simply provide the one in the keyStore. Also worth noting is the EXTERNAL mechanism in Smack is not enabled by default. To enable it, the implementer will need to call SASLAuthentication.supportSASLMechanism("EXTERNAL");

Field Summary

Fields

Modifier and Type	Field	Description
static final String	NAME

Fields inherited from class org.jivesoftware.smack.sasl.javax.SASLJavaXMechanism

sc

Fields inherited from class org.jivesoftware.smack.sasl.SASLMechanism

authenticationId, authorizationId, connection, connectionConfiguration, CRAMMD5, DIGESTMD5, EXTERNAL, GSSAPI, host, password, PLAIN, serviceName, sslSession

Constructor Summary

Constructors

Constructor	Description
SASLExternalMechanism()

Method Summary

Modifier and Type	Method	Description
boolean	authzidSupported()
String	getName()
int	getPriority()
SASLExternalMechanism	newInstance()
boolean	requiresPassword()

Methods inherited from class org.jivesoftware.smack.sasl.javax.SASLJavaXMechanism

authenticateInternal, authenticateInternal, checkIfSuccessfulOrThrow, evaluateChallenge, getAuthenticationText, getSaslProps, getServerName

Methods inherited from class org.jivesoftware.smack.sasl.SASLMechanism

afterFinalSaslChallenge, authenticate, authenticate, challengeReceived, compareTo, instanceForAuthentication, isAuthenticationSuccessful, isFinished, saslPrep, setException, throwExceptionIfRequired, toBytes, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

NAME

public static final String NAME

See Also:

• Constant Field Values

Constructor Details

SASLExternalMechanism

public SASLExternalMechanism()

Method Details

authzidSupported

public boolean authzidSupported()

Overrides:

authzidSupported in class org.jivesoftware.smack.sasl.SASLMechanism

getName

public String getName()

Specified by:

getName in class SASLJavaXMechanism

getPriority

public int getPriority()

Specified by:

getPriority in class org.jivesoftware.smack.sasl.SASLMechanism

newInstance

public SASLExternalMechanism newInstance()

Specified by:

newInstance in class org.jivesoftware.smack.sasl.SASLMechanism

requiresPassword

public boolean requiresPassword()

Overrides:

requiresPassword in class org.jivesoftware.smack.sasl.SASLMechanism