HTTP(S) transfer sites

SecureTransport Server provides support for guaranteed delivery and restart for transfers using the HTTP protocol when the remote server is a SecureTransport Server.

The following table describes the HTTP(S) protocol options for a transfer site.

Field Description
Server Settings
Host

Select Specify partner using hostname (IP address) and port number to enable this field.

Enter either the host name or IP address of the remote host to connect to for file transfers. You cannot enter spaces-only values in this field. For more information, see Spaces in required fields.

Port

Select Specify partner using hostname (IP address) and port number to enable this field.

Enter the port number on the remote host to be used for file transfers. You cannot enter spaces-only values in this field. For more information, see Spaces in required fields.;

Alternative addresses

This set of options allow you to add, delete and set a priority order of alternative endpoints. These endpoints act as backup alternatives to the configured Server-Port Site Settings and are particularly useful in cases of transfer failures. Specifying alternative endpoints as backup servers provides a way to temporarily reroute pending transfers and minimize the risk of transfer failure. As with the Server-Port site settings, the connection to each alternative endpoint is defined by its host name (or IP address) and port number.

  • To add an alternative server endpoint, click New Address. The Alternative Addresses table expands with a new row, that allows you to enter a hostname (or IP address), a port number and save these changes.
  • To delete an alternative server endpoint, select the corresponding check-box on the same row and click Delete.
  • To reorder the list of alternative endpoints, click Reorder. A new option (upward and downward arrow) appears next to each entry. You must hover with the mouse pointer over this newly appeared option and the mouse pointer will assume the "move" shape: a four-directional arrow pointer. This indicates which alternative endpoint is on focus. You can now drag & drop it up and down to the order number you want it at. Perform this action with other alternative endpoints until the list is ordered according to your needs. When you are done, click Save Order to keep the newly changed order.
Note Visibility of this option is controlled with the value set for the TransferSite.AlternativeAddresses.retryPolicy configuration option. It allows you to set a "retry policy" with a list of alternative endpoints (presented in IP address: Port number pairs or hostname) you define on this screen. But before you are able to do so, you must go to Operations > Server Configuration and set the policy type using either of the following values:
  • AllHostsOnEachRetry – with this policy SecureTransport iterates through each endpoint, one by one, starting with the first in the list. If connection not successful, SecureTransport will continue trying each endpoint one after another until the maximum number of retries is reached. You can set the maximum retry value by editing the EventQueue.maxRetryCount configuration option.
  • OneHostOnEachRetry – with this policy SecureTransport tries to connect to the first endpoint in the list. If connection not successful, SecureTransport will continue trying that endpoint until the maximum number of retries is reached; and then will move to the next one in the list. Following that same pattern, SecureTransport will try each endpoint until success; or until end of list. You can set the maximum retry value by editing the EventQueue.maxRetryCount configuration option.
  • Disabled (default) – this is the default value that keeps the table with endpoints entirely hidden from view.
Address

Select Specify partner using URL to enable this field. Note that with this selection, the Alternative addresses grid moves under this option on the screen.

Enter a URL that specifies the partner host. It can also include the port and a path (directory).

Network Zone

The network zone that defines the proxies to use for transfers through this site.

  • Select none to connect directly to the remote HTTP server.
  • Select any to allow SecureTransport to select the proxy connection using a network zone that enables an HTTP proxy.
  • Select Default to use the default network zone proxy configuration. If no default is network zone is defined, transfers from this transfer site fail.
  • Select a specific network zone to use the proxy configuration defined for that zone.

For more information, see Specify TM Server communication ports and IP address for protocol servers on SecureTransport Edge.

Transfer Settings
Download Folder

The folder on the remote server from which the file are transferred.

If Advanced Expression is selected for Download Folder, the download folder is evaluated using expression language.

To use the expression language to append dates:

The download folder will be evaluated using the current date when the transfer site is being executed. For example folder_20150130.

Example:

folder_${date("yyyyMMdd")}

Download Pattern

The pattern used to match file names to determine whether a file is downloaded. Asterisk (*) matches zero or more characters and question mark (?) matches one character.

If Advanced Expression is selected for Download Pattern, the download pattern is evaluated using expression language.

To evaluate the download pattern using dates:

The download pattern will be evaluated using the current date when the transfer site is being executed. For example *_20150130.txt. This will match all files ending with _20150130.txt.

Example:

*_${date("yyyyMMdd")}.txt

Allow Overwrite

Taken into account when the site is used by Send To Partner step. If checked the value of "Upload folder" will be overwritten with the value of "Overwrite upload folder". For more details see Advanced Routing.

Upload Folder The folder on the remote server to which files are transferred.
Transfer Mode

Specify whether data is transferred as ASCII or binary. You can also choose to have SecureTransport automatically determine the correct transfer mode.

For more information about automatically determining transfer mode, see Transfer mode for server-initiated transfers.

Use HTTPS Deselect this check box to use HTTP instead of HTTPS.
Verify certificate for the Site Select to verify that the remote system is trusted. This field is displayed when Use HTTPS is selected.
Enable FIPS Transfer Mode

Restrict HTTPS to use only FIPS 140-2 Level 1 certified cryptographic libraries. This field is displayed when Use HTTPS is selected.

When you enable FIPS transfer mode, the panel expands with an additional field that lets you specify the desired set of cipher suites to be used in FIPS mode for server-initiated transfers through this site. By default, this set is populated with the cipher suites as defined in the Https.FIPS.SIT.Ciphers configuration option.

You can add or remove cipher suites. The supported FIPS cipher suites from which you can select when adding a new one are listed in FIPS transfer mode. Note that both the sender and the recipient must use supported FIPS ciphers suites. Otherwise, the transfer will fail.

Site Login Credentials
User Name Username used to log in to the HTTP server. You cannot enter spaces-only values in this field. For more information, see Spaces in required fields.
Use Password Select to use a password to log in to the HTTP server.
Password Password used to log in to the HTTP server.
Certificate A private certificate for SecureTransport to use to log in to the remote system. You can select a certificate or import a certificate. This field is displayed when Use HTTPS is selected.
Post-transmission Settings – Send Options
Send File As Select the check box to specify a file name. You can use the expression language to specify the criteria you want to match. The expression uses the criteria provided to create a new file name from the original file name.
On Temporary Failure A temporary failure can occur when the transfer is incomplete and a retry occurs. Select one of the three choices: No Action, Delete Destination File, or Move File To. Selecting No Action causes the file to stay in the new location with the file name you specified. If another file with the same name is transferred to this location, the original file is overwritten. Selecting Delete Destination File removes the file from the new location. Selecting Move File To requires you to specify a directory in the location where you are transferring the files to and to provide an expression used to rename the file.
On Failure A failure occurs when the transfer is incomplete and all retry attempts were unsuccessful. Select one of the three choices: No Action, Delete Destination File, or Move File To. Selecting No Action causes the file to stay in the new location with the file name you specified. If another file with the same name is transferred to this location, the original file is overwritten. Selecting Delete Destination File removes the file from the new location. Selecting Move File To requires you to specify a directory in the location where you are transferring the files to and to provide an expression used to rename the file.
Post-transmission Settings – Receive Options
Receive File As Select the check box to specify a file name. You can use the expression language to specify the criteria you want to match. The expression uses the criteria provided to create a new file name from the original file name when the transfer is received. You can use the SecureTransport-specific variable ${stenv.site_target} which takes the value from the remote file path. See Expression Language for information on SecureTransport-specific variables.
On Failure A failure occurs when the transfer is incomplete and all retry attempts were unsuccessful. Select one of the three choices: No Action, Delete Source File, or Move File To. Selecting No Action causes the file to stay in the original location. If another file with the same name is transferred to this location, the original file is overwritten. Selecting Delete Source File removes the file from the original location. Selecting Move File To requires you to specify a directory in the location where you are transferring the files from and to provide an expression used to rename the file.
On Success Select one of the three choices: No Action, Delete Source File, or Move File To. Selecting No Action causes the file to stay in the original location. If another file with the same name is transferred to this location, the original file is overwritten. Selecting Delete Source File removes the file from the original location. Selecting Move File To requires you to specify a directory in the location where you are transferring the files from and to provide an expression used to rename the file.
Show Advanced SSL Settings
Cipher suites

The set of cipher suites available with the current HTTPS transfer site for secure SIT connection. By default this set is populated with the cipher suites as defined in the Https.SIT.Ciphers configuration option.

To reset to default values, click the button next to the tooltip.

Enabled SSL protocols

The available SSL protocols for secure SIT connection with the current HTTPS transfer site. By default this option uses the SSL protocols as defined in the Https.SIT.EnabledProtocols configuration option.

To reset to default values, click the button next to the tooltip.

Note To preserve the original file name when using the Move File To option, use the ${stenv.target} or ${stenv['target']} expressions.
Note When Single Sign-On (SSO) for end-users is enabled, you can not transfer files over HTTP(S).
Note SecureTransport will not be able perform server initiated file pushes or pulls over HTTP to and from another SecureTransport instance if the second requires SSO authentication for the users as the HTTP transfer site cannot handle the SSO authentication.

Related topics:

Related Links