Class ClientStanzaHandler

java.lang.Object
org.jivesoftware.openfire.net.StanzaHandler
org.jivesoftware.openfire.net.ClientStanzaHandler
Direct Known Subclasses:
WebSocketClientStanzaHandler

public class ClientStanzaHandler extends StanzaHandler
Handler of XML stanzas sent by clients connected directly to the server. Received packet will have their FROM attribute overridden to avoid spoofing.

By default, the hostname specified in the stream header sent by clients will not be validated. When validated the TO attribute of the stream header, if present, has to match the XMPP domain of the server, in any case (subdomains are not accepted). If the value of the 'to' attribute is not valid then a host-unknown error will be returned. To enable the validation set the system property xmpp.client.validate.host to true. Both the initial stream header and the one that is sent after TLS is negotiated are validated.

Author:
Gaston Dombiak
  • Field Details

    • VALIDATE_HOST

      public static final SystemProperty<Boolean> VALIDATE_HOST
      Controls if the 'to' attribute of stream headers sent by clients is validated. When enabled, a stream that names a domain other than the XMPP domain of the local XMPP service is refused with a host-unknown stream error.
      See Also:
  • Constructor Details

  • Method Details

    • processUnknowPacket

      protected boolean processUnknowPacket(org.dom4j.Element doc)
    • getNamespace

      protected org.dom4j.Namespace getNamespace()
    • validateHost

      protected boolean validateHost()
    • tlsNegotiated

      protected void tlsNegotiated(org.xmlpull.v1.XmlPullParser xpp) throws org.xmlpull.v1.XmlPullParserException, IOException
      Description copied from class: StanzaHandler
      TLS negotiation was successful so open a new stream and offer the new stream features. The new stream features will include available SASL mechanisms and specific features depending on the session type such as auth for Non-SASL authentication and register for in-band registration.
      Overrides:
      tlsNegotiated in class StanzaHandler
      Throws:
      org.xmlpull.v1.XmlPullParserException
      IOException
    • validateJIDs

      protected boolean validateJIDs()
    • createSession

      protected void createSession(String serverName, org.xmlpull.v1.XmlPullParser xpp, Connection connection) throws org.xmlpull.v1.XmlPullParserException
      Throws:
      org.xmlpull.v1.XmlPullParserException
    • processIQ

      protected void processIQ(org.xmpp.packet.IQ packet) throws UnauthorizedException
      Description copied from class: StanzaHandler
      Process the received IQ packet. Registered PacketInterceptor will be invoked before and after the packet was routed.

      Subclasses may redefine this method for different reasons such as modifying the sender of the packet to avoid spoofing, rejecting the packet or even process the packet in another thread.

      Overrides:
      processIQ in class StanzaHandler
      Parameters:
      packet - the received packet.
      Throws:
      UnauthorizedException - if service is not available to sender.
    • processPresence

      protected void processPresence(org.xmpp.packet.Presence packet) throws UnauthorizedException
      Description copied from class: StanzaHandler
      Process the received Presence packet. Registered PacketInterceptor will be invoked before and after the packet was routed.

      Subclasses may redefine this method for different reasons such as modifying the sender of the packet to avoid spoofing, rejecting the packet or even process the packet in another thread.

      Overrides:
      processPresence in class StanzaHandler
      Parameters:
      packet - the received packet.
      Throws:
      UnauthorizedException - if service is not available to sender.
    • processMessage

      protected void processMessage(org.xmpp.packet.Message packet) throws UnauthorizedException
      Description copied from class: StanzaHandler
      Process the received Message packet. Registered PacketInterceptor will be invoked before and after the packet was routed.

      Subclasses may redefine this method for different reasons such as modifying the sender of the packet to avoid spoofing, rejecting the packet or even process the packet in another thread.

      Overrides:
      processMessage in class StanzaHandler
      Parameters:
      packet - the received packet.
      Throws:
      UnauthorizedException - if service is not available to sender.
    • startTLS

      protected void startTLS() throws Exception
      Throws:
      Exception