Adding an FTP client policy

How to add an FTP client policy to a user agent.

About this task

A user agent can associate a set of FTP URLs with a specified policy. This policy controls the default values of many FTP client options for outgoing FTP connections.

These settings can be further overridden by query parameters in the URL that initiates the file transfer.

Procedure

  1. In the search field, enter user agent.
  2. From the search results, click User Agent.
  3. Click the name of a user agent configuration.
  4. Click the FTP Client Policies tab.
  5. Add a policy.
    1. Click Add or New.
    2. In the URL Matching Expression field, enter a shell-style expression to be the matching pattern for the URL set.
    3. From the Passive Mode list, select how the use of FTP passive mode to control the direction in which FTP data connections are made.
    4. From the Encrypt Command Connection list, select how to control the use of TLS to secure the FTP connection.
    5. From the Stop Command Encryption After Authentication list, select how to control the cessation of FTP command channel encryption after user authentication. Encryption must be stopped for compatibility with NAT (Network Address Translation) and other firewall applications. Although this behavior might be a security risk, this behavior is the only option when a NAT is in use.
    6. From the Encrypt File Transfers list, select how to control the encryption of file transfers. All settings are compatible with NAT.
    7. From the Data Type list, select the default data type of file transfers. In most cases, the default value of binary is appropriate.
    8. From the Write Unique Filename if Trailing Slash list, select whether the FTP server creates unique file names. Some FTP servers provide the STOU command, where the FTP server chooses the unique file name in the current directory to which to write. When enabled and the URL end in a slash, the STOU command, not the STOR command, chooses the unique file name. Before you enable, ensure that the FTP server supports the STOU command.
    9. From the Quoted Commands list, select the FTP quoted commands to send to the FTP server before each STOU, STOR, or RETR command.
    10. From the Size Check list, select whether to check the file size after a transfer.
    11. Click Apply.
  6. Optional: Repeat the previous step to add another policy.
  7. Click Apply to save the changes to the running configuration.
  8. Click Save Configuration or Save changes to save the changes to the persisted configuration.