oracle.ifs.protocols.ftp.server

Class FtpsServerChannel

java.lang.Object

java.lang.Thread

oracle.ifs.protocols.ftp.server.FtpServerChannel

oracle.ifs.protocols.ftp.server.FtpsServerChannel

All Implemented Interfaces:

Runnable, FtpConstants

public class FtpsServerChannel
extends FtpServerChannel
implements FtpConstants

FtpsServerChannel extends FtpServerChannel to support the FTPS protocol. It overrides:

1. how data sockets are created by overriding the createFtpSocketFactory. This returns an SocketFactory, which creates Secure Sockets.
2. It overrides the policy check function which is called before every comand is executed. It enforces the policy as defined in FtpsServer.
3. The Channel has 2 new state variables, that indicate if the COntrol and Data Channel have been secured.

Version:

1.0

Author:

Harish Butani

(Unpublished)

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class oracle.ifs.protocols.ftp.server.FtpServerChannel

m_ClientHost, m_CommandLineInput, m_ControlIn, m_ControlOut, m_ControlSocket, m_ControlSocketTimeout, m_ControlWriter, m_FtpSocketFactory, m_ReachedMaximumConnections, m_ReplyToken, m_Username

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Fields inherited from interface oracle.ifs.protocols.ftp.resources.FtpConstants

ACCEPT_QUEUE_SIZE, ACCESS_DENIED, ADMIN_COMMAND, ADMIN_OFF, ADMIN_ON, ANONYMOUS_ALLOWED, ANONYMOUS_USER_NOT_ALLOWED, ANONYMOUS_USERNAME, AUTH_COMMAND, BANNER_TEXT, CCC_COMMAND, CDUP_COMMAND, COMMAND_CHARACTER_SET_IS_USER_CHARACTER_SET, CWD_COMMAND, DATA_SOCKET_ERR, DEFAULT_COMMAND_CHARACTER_SET, DEFAULT_PORT, DELE_COMMAND, ERR_SETTING_SOCKET_ACTIVE, ERR_SETTING_SOCKET_PASV, ERR_SSL_SOCKETS, FILE_NOT_FOUND, FILE_RETR_FAIL, FILE_STOR_FAIL, FOLDER_FOUND, FOLDER_HAS_ITEMS, FOLDER_NOT_FOUND, FOLDERLINKS_EXIST, FTP_DESCRIPTIVE_NAME, FTP_NAME, FTP_STATUS, FTPS_NAME, HOST_ADDRESS, HOST_NAME, IMPLICIT_SECURITY, INVALID_ARGUMENT, LAST, LATIN_1, LIBRARY_VERSION, LINK_IS_BROKEN, LIST_COMMAND, LIST_FAIL, LN_COMMAND, LOCALE_COUNTRY, LOCALE_LANGUAGE, LOCALHOST, LOCALHOST_DEFAULT, LOGIN_FAILED, MAXIMUM_CONNECTIONS, MKD_COMMAND, NLST_COMMAND, NO_ERR, NOOP_COMMAND, NORMALIZE_PATH_ERR, NOT_DOCUMENT_TYPE, NOT_FOLDER_TYPE, NOT_LOGGED_IN, PASS_COMMAND, PASV_COMMAND, PBSZ_COMMAND, PORT, PORT_COMMAND, PROT_COMMAND, PWD_COMMAND, QUIT_COMMAND, REQ_DENIED_BY_POLICY, RETR_COMMAND, RMD_COMMAND, RNFR_COMMAND, RNTO_COMMAND, ROOT_FOLDER, SESSION_TIMEOUT_PERIOD, SETCHARACTERSET_COMMAND, SETCOMMANDCHARACTERSET_COMMAND, SETLANGUAGE_COMMAND, SHOWCHARACTERSET_COMMAND, SHOWLANGUAGE_COMMAND, STATS_COMMAND, STOR_COMMAND, SYST_COMMAND, SYSTEM_USERNAME, TOO_MANY_ARGUMENTS, TYPE_COMMAND, UNKNOWN_FLAG, USER_COMMAND, WALLET_LOCATION, XMKD_COMMAND, XPWD_COMMAND, XRMD_COMMAND

Constructor Summary

Constructors

Constructor and Description
FtpsServerChannel(FtpServer server, Socket controlSocket, int key, String threadName, boolean reachedMaximumConnections, boolean isImplicit)

Method Summary

Modifier and Type	Method and Description
protected FtpSocketFactory	createFtpSocketFactory(InetAddress localhost, int localControlPort, InetAddress clientHost, int clientControlPort) Creates a socket factory with the InetAddresses as given and the ports minus 1.
boolean	hasImplicitSecurity()
boolean	isControlChannelSecure()
boolean	isDataChannelSecure()
protected boolean	satisfiesPolicy(String cmd, String args) Validates channel protection, before executing a command.
void	secureControlChannel()
void	secureDataChannel()

Methods inherited from class oracle.ifs.protocols.ftp.server.FtpServerChannel

closeConnection, disconnect, getChannelKey, getCommandLine, getControlSocket, getControlSocketTimeout, getFdkSession, getFtpServer, getFtpSession, getFtpSocketFactory, getReplyToken, getUsername, handleCommandThrowable, handleFtpException, handleInterruptedIOException, handleThrowable, isSameClientHost, logUser, run, sendAnswer, setControlSocketTimeout, setFtpSession, setReplyToken, setShouldContinue, setupIO, setUsername

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

FtpsServerChannel

public FtpsServerChannel(FtpServer server,
                         Socket controlSocket,
                         int key,
                         String threadName,
                         boolean reachedMaximumConnections,
                         boolean isImplicit)
                  throws Exception

Throws:

Exception

Method Detail

createFtpSocketFactory

protected FtpSocketFactory createFtpSocketFactory(InetAddress localhost,
                                                  int localControlPort,
                                                  InetAddress clientHost,
                                                  int clientControlPort)

Description copied from class: FtpServerChannel

Creates a socket factory with the InetAddresses as given and the ports minus 1.

Overrides:

createFtpSocketFactory in class FtpServerChannel

satisfiesPolicy

protected boolean satisfiesPolicy(String cmd,
                                  String args)

Validates channel protection, before executing a command.

1. USER, PASS, PROT, PBSZ are only allowed when Control Channel is secure.
2. STOR, RETR, NLST, LIST, STOU, APPE are only allowd when Data Channel is secure

Overrides:

satisfiesPolicy in class FtpServerChannel

isControlChannelSecure

public boolean isControlChannelSecure()

isDataChannelSecure

public boolean isDataChannelSecure()

hasImplicitSecurity

public boolean hasImplicitSecurity()

secureControlChannel

public void secureControlChannel()
                          throws IOException,
                                 Exception

Throws:

IOException

Exception

secureDataChannel

public void secureDataChannel()