org.jivesoftware.openfire.session

Class LocalOutgoingServerSession

java.lang.Object

org.jivesoftware.openfire.session.LocalSession

org.jivesoftware.openfire.session.LocalServerSession

org.jivesoftware.openfire.session.LocalOutgoingServerSession

All Implemented Interfaces:

ChannelHandler<org.xmpp.packet.Packet>, RoutableChannelHandler, OutgoingServerSession, ServerSession, Session

public class LocalOutgoingServerSession
extends LocalServerSession
implements OutgoingServerSession

Server-to-server communication is done using two TCP connections between the servers. One connection is used for sending packets while the other connection is used for receiving packets. The OutgoingServerSession represents the connection to a remote server that will only be used for sending packets.

Currently only the Server Dialback method is being used for authenticating with the remote server. Use authenticateDomain(String, String) to create a new connection to a remote server that will be used for sending packets to the remote server from the specified domain. Only the authenticated domains with the remote server will be able to effectively send packets to the remote server. The remote server will reject and close the connection if a non-authenticated domain tries to send a packet through this connection.

Once the connection has been established with the remote server and at least a domain has been authenticated then a new route will be added to the routing table for this connection. For optimization reasons the same outgoing connection will be used even if the remote server has several hostnames. However, different routes will be created in the routing table for each hostname of the remote server.

Author:

Gaston Dombiak

Field Summary

Fields inherited from class org.jivesoftware.openfire.session.LocalServerSession

inboundAllowed, outboundAllowed, usingServerDialback

Fields inherited from class org.jivesoftware.openfire.session.LocalSession

CHARSET, conn, sessionManager, status, streamManager

Fields inherited from interface org.jivesoftware.openfire.session.Session

MAJOR_VERSION, MINOR_VERSION, STATUS_AUTHENTICATED, STATUS_CLOSED, STATUS_CONNECTED

Constructor Summary

Constructors

Constructor and Description
LocalOutgoingServerSession(String localDomain, Connection connection, OutgoingServerSocketReader socketReader, StreamID streamID)

Method Summary

Modifier and Type	Method and Description
void	addAuthenticatedDomain(String domain) Adds a new authenticated domain, subdomain or virtual host to the list of authenticated domains for the remote server.
void	addHostname(String hostname) Adds a new hostname to the list of known hostnames of the remote server.
static boolean	authenticateDomain(String localDomain, String remoteDomain) Authenticates the local domain to the remote domain.
boolean	authenticateSubdomain(String localDomain, String remoteDomain) Authenticates a subdomain of this server with the specified remote server over an exsiting outgoing connection.
Collection<String>	getAuthenticatedDomains() Returns a collection with all the domains, subdomains and virtual hosts that where authenticated.
String	getAvailableStreamFeatures() Returns a text with the available stream features.
Collection<String>	getHostnames() Returns the list of hostnames related to the remote server.

Methods inherited from class org.jivesoftware.openfire.session.LocalServerSession

isUsingServerDialback

Methods inherited from class org.jivesoftware.openfire.session.LocalSession

close, decodeVersion, deliverRawText, getAddress, getCipherSuiteName, getConnection, getCreationDate, getHostAddress, getHostName, getLanguage, getLastActiveDate, getNumClientPackets, getNumServerPackets, getPeerCertificates, getServerName, getSessionData, getStatus, getStreamID, getStreamManager, incrementClientPacketCount, incrementServerPacketCount, isClosed, isSecure, isUsingSelfSignedCertificate, process, removeSessionData, setAddress, setSessionData, setStatus, toString, validate

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jivesoftware.openfire.session.ServerSession

isUsingServerDialback

Methods inherited from interface org.jivesoftware.openfire.session.Session

close, deliverRawText, getAddress, getCipherSuiteName, getCreationDate, getHostAddress, getHostName, getLanguage, getLastActiveDate, getNumClientPackets, getNumServerPackets, getPeerCertificates, getServerName, getStatus, getStreamID, isClosed, isSecure, process, validate

Constructor Detail

LocalOutgoingServerSession

public LocalOutgoingServerSession(String localDomain,
                                  Connection connection,
                                  OutgoingServerSocketReader socketReader,
                                  StreamID streamID)

Method Detail

authenticateDomain

public static boolean authenticateDomain(String localDomain,
                                         String remoteDomain)

Authenticates the local domain to the remote domain. Once authenticated the remote domain can be expected to start accepting data from the local domain. This implementation will attempt to re-use an existing connection. An connection is deemed re-usable when it is either:

• authenticated to the remote domain itself, or:
• authenticated to a sub- or superdomain of the remote domain AND offers dialback.

When no re-usable connection exists, a new connection will be created. DNS will be used to find hosts for the remote domain. When DNS records do not specify a port, port 5269 will be used unless this default is overridden by the xmpp.server.socket.remotePort property.

Parameters:

localDomain - the local domain to authenticate with the remote server.

remoteDomain - the remote server, to which the local domain intends to send data.

Returns:

True if the domain was authenticated by the remote server.

authenticateSubdomain

public boolean authenticateSubdomain(String localDomain,
                                     String remoteDomain)

Description copied from interface: OutgoingServerSession

Authenticates a subdomain of this server with the specified remote server over an exsiting outgoing connection. If the existing session was using server dialback then a new db:result is going to be sent to the remote server. But if the existing session was TLS+SASL based then just assume that the subdomain was authenticated by the remote server.

Specified by:

authenticateSubdomain in interface OutgoingServerSession

Parameters:

localDomain - the local subdomain to authenticate with the remote server.

remoteDomain - the hostname of the remote server.

Returns:

True if the subdomain was authenticated by the remote server.

getAuthenticatedDomains

public Collection<String> getAuthenticatedDomains()

Description copied from interface: OutgoingServerSession

Returns a collection with all the domains, subdomains and virtual hosts that where authenticated. The remote server will accept packets sent from any of these domains, subdomains and virtual hosts.

Specified by:

getAuthenticatedDomains in interface OutgoingServerSession

Returns:

domains, subdomains and virtual hosts that where validated.

addAuthenticatedDomain

public void addAuthenticatedDomain(String domain)

Description copied from interface: OutgoingServerSession

Adds a new authenticated domain, subdomain or virtual host to the list of authenticated domains for the remote server. The remote server will accept packets sent from this new authenticated domain.

Specified by:

addAuthenticatedDomain in interface OutgoingServerSession

Parameters:

domain - the new authenticated domain, subdomain or virtual host to add.

getHostnames

public Collection<String> getHostnames()

Description copied from interface: OutgoingServerSession

Returns the list of hostnames related to the remote server. This tracking is useful for reusing the same session for the same remote server even if the server has many names.

Specified by:

getHostnames in interface OutgoingServerSession

Returns:

the list of hostnames related to the remote server.

addHostname

public void addHostname(String hostname)

Description copied from interface: OutgoingServerSession

Adds a new hostname to the list of known hostnames of the remote server. This tracking is useful for reusing the same session for the same remote server even if the server has many names.

Specified by:

addHostname in interface OutgoingServerSession

Parameters:

hostname - the new known name of the remote server

getAvailableStreamFeatures

public String getAvailableStreamFeatures()

Description copied from class: LocalSession

Returns a text with the available stream features. Each subclass may return different values depending whether the session has been authenticated or not.

Overrides:

getAvailableStreamFeatures in class LocalServerSession

Returns:

a text with the available stream features or null to add nothing.