Class Socks5ProxyHandler

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.channel.ChannelDuplexHandler

io.netty.handler.proxy.ProxyHandler

io.netty.handler.proxy.Socks5ProxyHandler

All Implemented Interfaces:

ChannelHandler, ChannelInboundHandler, ChannelOutboundHandler

public final class Socks5ProxyHandler
extends ProxyHandler

Handler that establishes a blind forwarding proxy tunnel using SOCKS Protocol Version 5.

Nested Class Summary

Nested classes/interfaces inherited from interface ChannelHandler

ChannelHandler.Sharable

Field Summary

Fields

Modifier and Type	Field	Description
private static final java.lang.String	AUTH_PASSWORD
private static final java.lang.String	AUTH_PRIVATE
private final Socks5ClientEncoder	clientEncoder
private java.lang.String	decoderName
private java.lang.String	encoderName
private static final Socks5InitialRequest	INIT_REQUEST_NO_AUTH
private static final Socks5InitialRequest	INIT_REQUEST_PASSWORD
private static final byte	NO_PRIVATE_AUTH_METHOD
private final java.lang.String	password
private final byte	privateAuthMethod
private final byte[]	privateToken
private static final java.lang.String	PROTOCOL
private final java.lang.String	username

Fields inherited from class ProxyHandler

AUTH_NONE

Constructor Summary

Constructors

Constructor	Description
Socks5ProxyHandler(java.net.SocketAddress proxyAddress)
Socks5ProxyHandler(java.net.SocketAddress proxyAddress, byte privateAuthMethod, byte[] privateToken, Socks5ClientEncoder customEncoder)	Creates a new SOCKS5 proxy handler with a custom private authentication method.
Socks5ProxyHandler(java.net.SocketAddress proxyAddress, java.lang.String username, java.lang.String password)

Method Summary

Modifier and Type	Method	Description
protected void	addCodec(ChannelHandlerContext ctx)	Adds the codec handlers required to communicate with the proxy server.
java.lang.String	authScheme()	Returns the name of the authentication scheme in use.
protected boolean	handleResponse(ChannelHandlerContext ctx, java.lang.Object response)	Handles the message received from the proxy server.
protected java.lang.Object	newInitialMessage(ChannelHandlerContext ctx)	Returns a new message that is sent at first time when the connection to the proxy server has been established.
java.lang.String	password()
java.lang.String	protocol()	Returns the name of the proxy protocol in use.
protected void	removeDecoder(ChannelHandlerContext ctx)	Removes the decoders added in ProxyHandler.addCodec(ChannelHandlerContext).
protected void	removeEncoder(ChannelHandlerContext ctx)	Removes the encoders added in ProxyHandler.addCodec(ChannelHandlerContext).
private void	sendConnectCommand(ChannelHandlerContext ctx)
private Socks5AuthMethod	socksAuthMethod()
java.lang.String	username()

Methods inherited from class ProxyHandler

channelActive, channelInactive, channelRead, channelReadComplete, connect, connectFuture, connectTimeoutMillis, destinationAddress, exceptionCaught, exceptionMessage, flush, handlerAdded, handlerRemoved, isConnected, proxyAddress, sendToProxyServer, setConnectTimeoutMillis, write

Methods inherited from class ChannelDuplexHandler

bind, close, deregister, disconnect, read

Methods inherited from class ChannelInboundHandlerAdapter

channelRegistered, channelUnregistered, channelWritabilityChanged, userEventTriggered

Methods inherited from class ChannelHandlerAdapter

ensureNotSharable, isSharable

Methods inherited from class java.lang.Object

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

Field Details

PROTOCOL

private static final java.lang.String PROTOCOL

See Also:

• Constant Field Values

AUTH_PASSWORD

private static final java.lang.String AUTH_PASSWORD

See Also:

• Constant Field Values

AUTH_PRIVATE

private static final java.lang.String AUTH_PRIVATE

See Also:

• Constant Field Values

NO_PRIVATE_AUTH_METHOD

private static final byte NO_PRIVATE_AUTH_METHOD

INIT_REQUEST_NO_AUTH

private static final Socks5InitialRequest INIT_REQUEST_NO_AUTH

INIT_REQUEST_PASSWORD

private static final Socks5InitialRequest INIT_REQUEST_PASSWORD

username

private final java.lang.String username

password

private final java.lang.String password

privateAuthMethod

private final byte privateAuthMethod

privateToken

private final byte[] privateToken

clientEncoder

private final Socks5ClientEncoder clientEncoder

decoderName

private java.lang.String decoderName

encoderName

private java.lang.String encoderName

Constructor Details

Socks5ProxyHandler

public Socks5ProxyHandler(java.net.SocketAddress proxyAddress)

Socks5ProxyHandler

public Socks5ProxyHandler(java.net.SocketAddress proxyAddress,
 java.lang.String username,
 java.lang.String password)

Socks5ProxyHandler

public Socks5ProxyHandler(java.net.SocketAddress proxyAddress,
 byte privateAuthMethod,
 byte[] privateToken,
 Socks5ClientEncoder customEncoder)

Creates a new SOCKS5 proxy handler with a custom private authentication method.

Parameters:

proxyAddress - The address of the SOCKS5 proxy server

privateAuthMethod - The private authentication method code (must be in range 0x80-0xFE)

privateToken - The token to use for private authentication

customEncoder - The custom encoder to use for encoding SOCKS5 messages, if null the Socks5ClientEncoder.DEFAULT will be used

Throws:

java.lang.IllegalArgumentException - If privateAuthMethod is not in the valid range

Method Details

protocol

public java.lang.String protocol()

Description copied from class: ProxyHandler

Returns the name of the proxy protocol in use.

Specified by:

protocol in class ProxyHandler

authScheme

public java.lang.String authScheme()

Description copied from class: ProxyHandler

Returns the name of the authentication scheme in use.

Specified by:

authScheme in class ProxyHandler

username

public java.lang.String username()

password

public java.lang.String password()

addCodec

protected void addCodec(ChannelHandlerContext ctx)
                 throws java.lang.Exception

Description copied from class: ProxyHandler

Adds the codec handlers required to communicate with the proxy server.

Specified by:

addCodec in class ProxyHandler

Throws:

java.lang.Exception

removeEncoder

protected void removeEncoder(ChannelHandlerContext ctx)
                      throws java.lang.Exception

Description copied from class: ProxyHandler

Removes the encoders added in ProxyHandler.addCodec(ChannelHandlerContext).

Specified by:

removeEncoder in class ProxyHandler

Throws:

java.lang.Exception

removeDecoder

protected void removeDecoder(ChannelHandlerContext ctx)
                      throws java.lang.Exception

Description copied from class: ProxyHandler

Removes the decoders added in ProxyHandler.addCodec(ChannelHandlerContext).

Specified by:

removeDecoder in class ProxyHandler

Throws:

java.lang.Exception

newInitialMessage

protected java.lang.Object newInitialMessage(ChannelHandlerContext ctx)
                                      throws java.lang.Exception

Description copied from class: ProxyHandler

Returns a new message that is sent at first time when the connection to the proxy server has been established.

Specified by:

newInitialMessage in class ProxyHandler

Returns:

the initial message, or null if the proxy server is expected to send the first message instead

Throws:

java.lang.Exception

handleResponse

protected boolean handleResponse(ChannelHandlerContext ctx,
 java.lang.Object response)
                          throws java.lang.Exception

Description copied from class: ProxyHandler

Handles the message received from the proxy server.

Specified by:

handleResponse in class ProxyHandler

Returns:

true if the connection to the destination has been established, false if the connection to the destination has not been established and more messages are expected from the proxy server

Throws:

java.lang.Exception

socksAuthMethod

private Socks5AuthMethod socksAuthMethod()

sendConnectCommand

private void sendConnectCommand(ChannelHandlerContext ctx)
                         throws java.lang.Exception

Throws:

java.lang.Exception