OFTP Connector
Properties Configuration Settings
The OFTP Component adds OFTP send and receive capabilities to your MuleSoft.
Remarks
The OFTP, or Odette File Transfer Protocol, Connector adds a complete OFTP client to your Mule Project that enables it with file download and upload capability.
OFTP Receive Connector
The OFTP Receive Connector requires certain server properties be set. You must set the OFTPServer property to the remote location of the desired OFTP server. You may also set an OFTPPort if the server is not set to the default protocol port. For client authorization, you must set the ClientSSIDCode, ClientSFIDCode, and ClientPassword properties. And, for server authentication, you must set the ServerSSIDCode, ServerSFIDCode, and ServerPassword properties.
If you want to use secure authentication with encryption to and from the server, set SecureAuthentication to True, set the Certificate property to a certificate containing your private key, and set the RecipientCert property to the server's public certificate.
The connector will connect to the OFTP server and download all files in the server's outgoing queue, and submit these to the Mule Project as individual messages.
Download Files Example
Drag and drop the OFTP Receive Connector into the source position of a flow. If you want to download from a server using OFTP version 1.2 without encryption, most of the settings can be left at their defaults.
To configure the connection, set the ClientSSIDCode, ClientSFIDCode, and ClientPassword properties to your own information, and set the ServerSSIDCode, ServerSFIDCode, and ServerPassword properties to the server's information. Then set the OFTPServer and OFTPPort properties to the server's address.
When the connector is scheduled to run, it will connect to the server, download any available files, and submit each one to the flow as a message.
OFTP Send Connector
The OFTP Send Connector also requires certain server properties be set. You must set the OFTPServer property to the remote location of the desired OFTP server. You may also set an OFTPPort if the server is not set to the default protocol port. For client authorization, you must set the ClientSSIDCode, ClientSFIDCode, and ClientPassword properties. And, for server authentication, you must set the ServerSSIDCode, ServerSFIDCode, and ServerPassword properties.
If you want to use secure authentication with encryption to and from the server, set SecureAuthentication to True, set the Certificate property to a certificate containing your private key, and set the RecipientCert property to the server's public certificate.
The connector will connect to the OFTP server whenever it has a message to send and attempt to upload the file to the server. It uses the name specified by VirtualFileName when sending to the server. If set to a value containing an empty string, a temporary filename will be used.
Upload Files Example
Drag and drop the OFTP Send Connector into the flow. If you want to upload to a server using OFTP version 1.2 without encryption, most of the settings can be left at their defaults.
To configure the connection, set the ClientSSIDCode, ClientSFIDCode, and ClientPassword properties to your own information, and set the ServerSSIDCode, ServerSFIDCode, and ServerPassword properties to the server's information. Then set the OFTPServer and OFTPPort properties to the server's address.
Set VirtualFileName and VirtualFileDate to set the propertys of the uploaded file. By default, the VirtualFileName will be set to "#[attributes.filename], which would contain the local name of a file passed to the connector by a File connector
Receiver Property List
The following is the full list of the properties of the receiver connector with short descriptions. Click on the links for further details.
Certificate | The private key certificate. |
ClientPassword | The client's password. |
ClientSFIDCode | Client's SFID code. |
ClientSSIDCode | The client's SSID code. |
Firewall | A set of properties related to firewall access. |
LogFile | The file to write logging information to at runtime. |
LogMode | What information gets logged during component execution. |
LogType | How information gets logged during component execution. |
OFTPPort | The port for the OFTP service (default is 3305). |
OFTPServer | The domain name or IP address of the OFTP server. |
Other | Defines a set of configuration settings to be used by the component. |
ReceivedFileDate | The date of the remote file received by the OFTP component. |
ReceivedFileName | The name of the remote file received by the OFTP component. |
ReceivedFileSize | The size of the remote file received by the OFTP component. |
RecipientCert | The recipient certificate of the message. |
RuntimeLicense | Specifies the component runtime license key. |
SecureAuthentication | Whether or not the component should perform secure odette authentication. |
ServerPassword | The server's password. |
ServerSFIDCode | Server's SFID code. |
ServerSSIDCode | The server's SSID code. |
SSLAcceptServerCert | Instructs the component to unconditionally accept the server certificate that matches the supplied certificate. |
SSLCert | The certificate to use for client authentication during the SSL handshake. |
TempPath | A temporary directory where data can be stored before the component processes it. |
Timeout | A timeout for the component. |
UseSSL | Use SSL to access the OFTPServer . |
Version | Which version of the OFTP protocol the component is using. |
Sender Property List
The following is the full list of the properties of the sender connector with short descriptions. Click on the links for further details.
Certificate | The private key certificate. |
ClientPassword | The client's password. |
ClientSFIDCode | Client's SFID code. |
ClientSSIDCode | The client's SSID code. |
Compress | Whether or not to compress the outgoing file. |
EncryptionAlgorithm | The encryption algorithm. |
Firewall | A set of properties related to firewall access. |
LogFile | The file to write logging information to at runtime. |
LogMode | What information gets logged during component execution. |
LogType | How information gets logged during component execution. |
MaxRecordSize | The maximum length of a given record. |
OFTPPort | The port for the OFTP service (default is 3305). |
OFTPServer | The domain name or IP address of the OFTP server. |
Other | Defines a set of configuration settings to be used by the component. |
RecipientCert | The recipient certificate of the message. |
RuntimeLicense | Specifies the component runtime license key. |
SecureAuthentication | Whether or not the component should perform secure odette authentication. |
ServerPassword | The server's password. |
ServerSFIDCode | Server's SFID code. |
ServerSSIDCode | The server's SSID code. |
SignedReceipt | Whether or not to require signed receipts. |
SSLAcceptServerCert | Instructs the component to unconditionally accept the server certificate that matches the supplied certificate. |
SSLCert | The certificate to use for client authentication during the SSL handshake. |
TempPath | A temporary directory where data can be stored before the component processes it. |
Timeout | A timeout for the component. |
UseSSL | Use SSL to access the OFTPServer . |
Version | Which version of the OFTP protocol the component is using. |
VirtualFileDate | The date/time stamp for the virtual file. |
VirtualFileFormat | The structure of the outgoing file. |
VirtualFileName | The virtual file name. |
VirtualFileSecurityLevel | The level of security for the outgoing file. |
Configuration Settings
The following is a list of configuration settings for the connector with short descriptions. Click on the links for further details.
OverwriteTempFiles | Whether to overwrite files in the directory specified by TempPath. |
ReceivedFileNameFormat | The name format of received files. |
ReuseSSLSession | Determines if the SSL session is reused. |
SSLCipherStrength | The minimum cipher strength used for bulk encryption. |
SSLEnabledCipherSuites | The cipher suite to be used in an SSL negotiation. |
SSLEnabledProtocols | Used to enable/disable the supported security protocols. |
SSLIncludeCertChain | Whether the entire certificate chain is included in the SSLServerAuthentication event. |
SSLSecurityFlags | Flags that control certificate verification. |
TLS12SignatureAlgorithms | Defines the allowed TLS 1.2 signature algorithms when UseInternalSecurityAPI is True. |
TLS12SupportedGroups | The supported groups for ECC. |
TLS13KeyShareGroups | The groups for which to pregenerate key shares. |
TLS13SignatureAlgorithms | The allowed certificate signature algorithms. |
TLS13SupportedGroups | The supported groups for (EC)DHE key exchange. |
AbsoluteTimeout | Determines whether timeouts are inactivity timeouts or absolute timeouts. |
LocalHost | The name of the local host or user-assigned IP interface through which connections are initiated or accepted. |
TcpNoDelay | Whether or not to delay when sending packets. |
UseInternalSecurityAPI | Tells the component whether or not to use the system security libraries or an internal implementation. |