Package org.apache.sshd.contrib.server.session.proxyprotocolv2

Class ProxyProtocolV2Acceptor

java.lang.Object

org.apache.sshd.common.util.logging.AbstractLoggingBean

org.apache.sshd.contrib.server.session.proxyprotocol.ProxyProtocolAcceptor

org.apache.sshd.contrib.server.session.proxyprotocolv2.ProxyProtocolV2Acceptor

All Implemented Interfaces:

ServerProxyAcceptor

public class ProxyProtocolV2Acceptor
extends ProxyProtocolAcceptor

A working prototype to support PROXY protocol v2 as described in HAProxy Documentation.

This ServerProxyAcceptor can process PROXY protocol v1 and v2.

Field Summary

Fields

Modifier and Type	Field	Description
private static char	FIELD_SEPARATOR
private static byte[]	PROXY_V2_HEADER

Fields inherited from class org.apache.sshd.contrib.server.session.proxyprotocol.ProxyProtocolAcceptor

MAX_PROXY_HEADER_LENGTH, PROX_PROTOCOL_PREFIX

Fields inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

log

Constructor Summary

Constructors

Constructor	Description
ProxyProtocolV2Acceptor()

Method Summary

Modifier and Type	Method	Description
boolean	acceptServerProxyMetadata(ServerSession session, Buffer buffer)	Invoked before any attempt is made to retrieve the SSH client identification data of the standard SSH protocol.
protected boolean	parseProxyHeader(ServerSession session, java.lang.String proxyHeader, int markPosition, Buffer buffer)
protected boolean	readProxyV2Header(ServerSession session, int markPosition, Buffer buffer)

Methods inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

debug, debug, debug, debug, debug, error, error, error, error, error, getSimplifiedLogger, info, info, warn, warn, warn, warn, warn, warn, warn, warn

Methods inherited from class java.lang.Object

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

Field Detail

PROXY_V2_HEADER

private static final byte[] PROXY_V2_HEADER

FIELD_SEPARATOR

private static final char FIELD_SEPARATOR

See Also:

Constant Field Values

Constructor Detail

ProxyProtocolV2Acceptor

public ProxyProtocolV2Acceptor()

Method Detail

acceptServerProxyMetadata

public boolean acceptServerProxyMetadata(ServerSession session,
                                         Buffer buffer)
                                  throws java.lang.Exception

Description copied from interface: ServerProxyAcceptor

Invoked before any attempt is made to retrieve the SSH client identification data of the standard SSH protocol. The implementor should extract whatever data it needs from the data buffer. Note: the method may be called several times for the same session even though the original proxy data was successfully extracted. This happens in case the client identification line following it is incomplete and thus requires waiting for more incoming packets.

Specified by:

acceptServerProxyMetadata in interface ServerProxyAcceptor

Overrides:

acceptServerProxyMetadata in class ProxyProtocolAcceptor

Parameters:

session - The ServerSession instance

buffer - The received data Buffer - if not the 1st time this method is called because data was lacking on last invocation, then the buffer is guaranteed to contain the data from all the previous incomplete invocations plus any new received data. If not enough information is available, the buffer's read position should be restored to its original value when the method was invoked.

Returns:

true if successfully extracted the remote client peer meta-data, false if more data is required. Upon successful return the buffer read position is assumed to indicate the first character of the SSH identification line

Throws:

java.lang.Exception - If failed to correctly extract and parse the meta-data, in which case the session will be closed

readProxyV2Header

protected boolean readProxyV2Header(ServerSession session,
                                    int markPosition,
                                    Buffer buffer)
                             throws java.lang.Exception

Throws:

java.lang.Exception

parseProxyHeader

protected boolean parseProxyHeader(ServerSession session,
                                   java.lang.String proxyHeader,
                                   int markPosition,
                                   Buffer buffer)
                            throws java.lang.Exception

Overrides:

parseProxyHeader in class ProxyProtocolAcceptor

Throws:

java.lang.Exception