org.jivesoftware.smack.packet

Class Authentication

java.lang.Object

org.xmpp.packet.Packet

org.xmpp.packet.IQ

org.jivesoftware.smack.packet.Authentication

public class Authentication
extends org.xmpp.packet.IQ

Authentication packet, which can be used to login to a XMPP server as well as discover login information from the server.

Nested Class Summary

Nested classes/interfaces inherited from class org.xmpp.packet.IQ

org.xmpp.packet.IQ.Type

Field Summary

Fields inherited from class org.xmpp.packet.Packet

docFactory, element, fromJID, toJID

Constructor Summary

Constructors

Constructor and Description
Authentication() Create a new authentication packet.
Authentication(org.dom4j.Element el)

Method Summary

Methods

Modifier and Type	Method and Description
String	getDigest() Returns the password digest or null if the digest hasn't been set.
String	getPassword() Returns the plain text password or null if the password hasn't been set.
String	getResource() Returns the resource or null if the resource hasn't been set.
String	getUsername() Returns the username, or null if the username hasn't been sent.
void	setDigest(String digest) Sets the digest value directly.
void	setDigest(String connectionID, String password) Sets the digest value using a connection ID and password.
void	setPassword(String password) Sets the plain text password.
void	setResource(String resource) Sets the resource.
void	setUsername(String username) Sets the username.

Methods inherited from class org.xmpp.packet.IQ

addExtension, createCopy, createResultIQ, deleteExtension, getChildElement, getExtension, getType, isRequest, isResponse, setChildElement, setChildElement, setType

Methods inherited from class org.xmpp.packet.Packet

getElement, getError, getFrom, getID, getTo, setError, setError, setFrom, setFrom, setID, setTo, setTo, toString, toXML

Methods inherited from class java.lang.Object

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

Constructor Detail

Authentication

public Authentication()

Create a new authentication packet. By default, the packet will be in "set" mode in order to perform an actual authentication with the server. In order to send a "get" request to get the available authentication modes back from the server, change the type of the IQ packet to "get":

setType(IQ.Type.GET);

Authentication

public Authentication(org.dom4j.Element el)

Method Detail

getUsername

public String getUsername()

Returns the username, or null if the username hasn't been sent.

Returns:

the username.

setUsername

public void setUsername(String username)

Sets the username.

Parameters:

username - the username.

getPassword

public String getPassword()

Returns the plain text password or null if the password hasn't been set.

Returns:

the password.

setPassword

public void setPassword(String password)

Sets the plain text password.

Parameters:

password - the password.

getDigest

public String getDigest()

Returns the password digest or null if the digest hasn't been set. Password digests offer a more secure alternative for authentication compared to plain text. The digest is the hex-encoded SHA-1 hash of the connection ID plus the user's password. If the digest and password are set, digest authentication will be used. If only one value is set, the respective authentication mode will be used.

Returns:

the digest of the user's password.

setDigest

public void setDigest(String connectionID,
             String password)

Sets the digest value using a connection ID and password. Password digests offer a more secure alternative for authentication compared to plain text. The digest is the hex-encoded SHA-1 hash of the connection ID plus the user's password. If the digest and password are set, digest authentication will be used. If only one value is set, the respective authentication mode will be used.

Parameters:

connectionID - the connection ID.

password - the password.

See Also:

Connection.getConnectionID()

setDigest

public void setDigest(String digest)

Sets the digest value directly. Password digests offer a more secure alternative for authentication compared to plain text. The digest is the hex-encoded SHA-1 hash of the connection ID plus the user's password. If the digest and password are set, digest authentication will be used. If only one value is set, the respective authentication mode will be used.

Parameters:

digest - the digest, which is the SHA-1 hash of the connection ID the user's password, encoded as hex.

See Also:

Connection.getConnectionID()

getResource

public String getResource()

Returns the resource or null if the resource hasn't been set.

Returns:

the resource.

setResource

public void setResource(String resource)

Sets the resource.

Parameters:

resource - the resource.