SFTPServer Bean
Properties Methods Events Configuration Settings Errors
The SFTPServer component is used to create a SFTP Server.
Syntax
IPWorksSSH.Sftpserver
Remarks
The SFTPServer bean provides a simple way to create a SFTP server. Any SFTP client will be able to connect and transfer files to and from the server.
To begin, first provide a valid certificate with private key in the SSHCert property.
Set the RootDirectory property to a valid local path. When clients connect they will see this as their initial directory.
To start the server set Listening to true.
When clients connect the SSHUserAuthRequest event is fired. This provides an opportunity to validate the client's credentials. Please see the help for SSHUserAuthRequest for more details.
This is all that is required to start the SFTP server and begin serving files.
During operation other events fire to provide further information and also to provide you an opportunity to override the default behavior and return errors if desired.
Property List
The following is the full list of the properties of the bean with short descriptions. Click on the links for further details.
| ConnectionBacklog | The maximum number of pending connections maintained by the TCP/IP subsystem. |
| Connections | A collection of currently connected SFTP clients. |
| DefaultAuthMethods | Specifies the supported authentication methods. |
| DefaultTimeout | An initial timeout value to be used by incoming connections. |
| KeyboardInteractiveMessage | The instructions to send to the client during keyboard-interactive authentication. |
| KeyboardInteractivePrompts | A collection of prompts to present to the user for keyboard-interactive authentication. |
| Listening | If True, the component accepts incoming connections on LocalPort. |
| LocalHost | The name of the local host or user-assigned IP interface through which connections are initiated or accepted. |
| LocalPort | The TCP port in the local host where the component listens. |
| RootDirectory | The root directory for the entire SFTP server. |
| SSHCert | A certificate to be used during SSH negotiation. |
| SSHCompressionAlgorithms | A comma-separated list containing all allowable compression algorithms. |
| SSHEncryptionAlgorithms | A comma-separated list containing all allowable compression algorithms. |
Method List
The following is the full list of the methods of the bean with short descriptions. Click on the links for further details.
| config | Sets or retrieves a configuration setting . |
| disconnect | Disconnect the specified client. |
| doEvents | Processes events from the internal message queue. |
| exchangeKeys | Causes the component to exchange a new set of session keys on the specified connection. |
| setFileList | Sets the file list for a connection during a directory listing request. |
| shutdown | Shuts down the server. |
Event List
The following is the full list of the events fired by the bean with short descriptions. Click on the links for further details.
| Connected | Fired immediately after a connection completes (or fails). |
| ConnectionRequest | Fired when a request for connection comes from a remote host. |
| DirCreate | Fires when a client wants to create a new directory. |
| DirList | Fires when a client attempts to open a directory for listing. |
| DirRemove | Fires when a client wants to delete a directory. |
| Disconnected | Fired when a connection is closed. |
| Error | Information about errors during data delivery. |
| FileClose | Fires when a client attempts to close an open file or directory handle. |
| FileOpen | Fires when a client wants to open or create a file. |
| FileRead | Fires when a client wants to read from an open file. |
| FileRemove | Fires when a client wants to delete a file. |
| FileRename | Fires when a client wants to rename a file. |
| FileWrite | Fires when a client wants to write to an open file. |
| GetAttributes | Fires when a client needs to get file information. |
| ResolvePath | Fires when a client attempts to canonicalize a path. |
| SetAttributes | Fires when a client attempts to set file or directory attributes. |
| SSHStatus | Shows the progress of the secure connection. |
| SSHUserAuthRequest | Fires when a client attempts to authenticate a connection. |
Configuration Settings
The following is a list of configuration settings for the bean with short descriptions. Click on the links for further details.
| DirListBufferSize[ConnectionId] | The number of entries to be returned in one response to a request for a directory listing. |
| ProtocolVersion | The highest allowable SFTP version to use. |
| RestrictUserToHomeDir[ConnectionId] | Whether to restrict the user to their HomeDir. |
| ServerEOL | Specifies the line endings used in files on the server. |
| SFTPErrorMessage[ConnectionId] | Specifies the error message to be returned to the client. |
| MaxAuthAttempts | The maximum authentication attempts allowed before forcing a disconnect. |
| ServerSSHVersionString | The SSH version string sent to connecting clients. |
| UserAuthBanner[ConnectionId] | A custom user authentication banner. |
| KeyRenegotiationThreshold | Sets the threshold for the SSH Key Renegotiation. |
| SSHKeyExchangeAlgorithms | Specifies the supported key exchange algorithms. |
| SSHMacAlgorithms | Specifies the supported Mac algorithms. |
| BindExclusively | Whether or not the component considers a local port reserved for exclusive use. |
| InBufferSize | The size in bytes of the incoming queue of the socket. |
| MaxConnections | The maximum number of connections available. |
| OutBufferSize | The size in bytes of the outgoing queue of the socket. |
| KeepAliveTime | The inactivity time in milliseconds before a TCP keep-alive packet is sent. |
| KeepAliveInterval | The retry interval, in milliseconds, to be used when a TCP keep-alive packet is sent and no response is received. |
| RecordLength[ConnectionId] | The length of received data records. |
| TcpNoDelay | Whether or not to delay when sending packets. |
| CodePage | The system code page used for Unicode to Multibyte translations. |