FTP/FTPS with TLS

FTP/FTPS with TLS support
Join our community

Actions5

Overview

This node provides FTP/FTPS with TLS and SFTP file management capabilities. It allows users to perform common file operations on remote servers securely, including listing files, downloading, uploading, deleting, and renaming files or folders.

The Rename operation specifically enables renaming a file or folder on the remote server by specifying the current path and the new desired path.

Common scenarios:

  • Renaming files or directories on an FTP/SFTP server as part of automated workflows.
  • Organizing files remotely after upload or processing.
  • Correcting file names or moving files within the same server without re-uploading.

Example:
You have uploaded a file named temp_report.txt and want to rename it to final_report.txt on the FTP server. Using this node's Rename operation, you specify the original path /uploads/temp_report.txt and the new path /uploads/final_report.txt to rename the file directly on the server.

Properties

Name Meaning
Path The remote path to operate on. This is the current location of the file or folder.
New Path The new path for the file or folder after renaming.

Output

The output JSON contains a success confirmation and a message describing the result of the rename operation.

Example output structure:

{
  "success": true,
  "message": "Renamed /old/path to /new/path"
}
  • success: Boolean indicating if the rename was successful.
  • message: A descriptive string confirming the rename action.

No binary data is output for the Rename operation.

Dependencies

  • Requires connection credentials to an FTP/FTPS (with TLS) or SFTP server.
  • Uses the basic-ftp library for FTP/FTPS operations.
  • Uses the ssh2-sftp-client library for SFTP operations.
  • Node requires proper configuration of credentials including host, port, username, password/private key, and TLS settings if applicable.

Troubleshooting

  • Common issues:

    • Incorrect paths: Ensure both the current (Path) and new (New Path) paths are valid and accessible on the remote server.
    • Permission errors: The user must have permission to rename files/folders on the server.
    • Connection failures: Verify credentials and network connectivity to the FTP/SFTP server.
    • TLS version mismatches or certificate issues when using FTPS.

  • Error messages:

    • "FTP operation failed: <error message>" or "SFTP operation failed: <error message>": Indicates failure during the rename process. Check the error message for details such as permission denied, file not found, or connection issues.
    • "Unknown operation: rename": Should not occur if the operation is correctly set; indicates internal misconfiguration.

  • Resolution tips:

    • Double-check the input paths for typos.
    • Confirm user permissions on the remote server.
    • Test connectivity separately with an FTP/SFTP client.
    • For FTPS, verify TLS settings and certificates.

Links and References

Discussion