Learn how to put your digital team to work with MuleSoft for Agentforce.
Register now
Contact Us 1-800-596-4880
  1. Homepage
  2. Release Notes

  3. SFTP Connector Release Notes - Mule 4

SFTP Connector Release Notes - Mule 4

Support Category: SelectLeaving the Site

Anypoint Connector for SFTP (SFTP Connector) provides access to files and folders on an SFTP server. SFTP connector’s operations manage file transfers over the SFTP (Secure File Transfer Protocol) protocol.

2.4.4

April 22, 2025

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.13.2

Fixed Issues

Issue Resolution ID

The connector verifies user read access before reading the file.

W-17672899

The commons-collections:commons-collections:3.2.2 library is excluded and updated to org.apache.commons:commons-collections4:4.3 to address security vulnerabilities.

W-17637753

2.4.3

March 7, 2025

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.13.2

Fixed Issues

Issue Resolution ID

The connector no longer throws an error that the client is closed if there is no activity from the client side for more than 5 minutes.

W-17688949, W-17516083

2.4.2

February 7, 2025

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.13.2

Fixed Issues

Issue Resolution ID

The Write operation with CUSTOM_APPEND mode now works consistently for the CUSTOM_WRITE strategy.

W-17555345

2.4.1

December 24, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.13.2

Fixed Issues

Issue Resolution ID

The commons-io:commons-io library is upgraded to version 2.14.0 to address reported security vulnerabilities.

W-17368719

The org.json:json library is upgraded to version 20231013 to address reported security vulnerabilities.

W-14499233

2.4.0

November 13, 2024

What’s New

  • The connector no longer supports the KEYBOARD_INTERACTIVE preferred authentication method. Use the PUBLIC_KEY, PASSWORD, or GSSAPI_WITH_MIC preferred authentication methods instead.

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.13.2

Fixed Issues

Issue Resolution ID

The Preferred Authentication Methods field no longer includes KEYBOARD_INTERACTIVE.

W-16765499

2.3.0

September 23, 2024

What’s New

  • The connector has a new custom Write strategy field that enables you to configure the strategy to write a file. Use this strategy only in APPEND mode particularly for old SFTP servers that do not follow the standard SFTP guidelines. Additionally, you can configure the buffer size to write the file in the Buffer size for write strategy field.

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.13.2

Fixed Issues

Issue Resolution ID

The connector no longer hangs while performing operations on Rebex TinySFTP servers.

W-14051911

The connector now has a new custom Write strategy field that supports the append issues in the Globalscape and Titan SFTP Servers.

W-15124410

The connector no longer evicts an active connection when processing a huge file.

W-16342066

The connector no longer logs the Unknown channel request: keepalive@openssh.com warning when debug mode is disabled.

W-16750435

The connector no longer throws a null pointer exception during resource release when an exception occurs in the flow.

W-16645502

2.2.2

August 26, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.12.1

Fixed Issues

Issue Resolution ID

The connector no longer has thread leaks when connections fail.

W-15259057

2.2.1

August 13, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.12.1

Fixed Issues

Issue Resolution ID

The connector no longer incorrectly throws a connection timeout error.

W-15437508

2.2.0

July 12, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.12.1

Fixed Issues

Issue Resolution ID

The SFTP filename attribute is now consistent between the payload and its transformation to JSON.

W-15717354

2.1.4

July 2, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.12.1

Fixed Issues

Issue Resolution ID

Removed unnecessary dependency reducing the overall size of the Mule app that includes the SFTP Connector.

W-16134781

2.1.3

June 18, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.12.1

Fixed Issues

Issue Resolution ID

SFTP Connector now throws the SftpConnectionException message to cover missing cases of errors, such as connection refused and connection reset by peer.

W-14987667, W-15890258

Resolved memory leak issues related to classloader usage, which also addresses application deletion failures on Windows systems for Java versions 11 and 17.

W-15988716

2.1.2

May 30, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.12.1

Fixed Issues

Issue Resolution ID

SFTP Connector now creates a new file in append mode if the file does not exist.

W-15291302

SFTP Connector now appends content at the end of the file in append mode.

W-15294043

2.1.1

May 29, 2024

What’s New

  • SFTP Connector now supports external security configurations through a configuration file. You can configure this file in the Advanced tab of the connector configuration, which supports the following settings:

    • KexAlgorithms
      Specifies comma separated list of Key Exchange algorithms

    • Ciphers
      Specifies comma separated list of the symmetric Ciphers

    • HostKeyAlgorithms
      Specifies comma separated list of Host Key Signature algorithms

    • MACs
      Specifies comma separated list of Message Authentication Codes

Because you control this configuration file, it may introduce an additional security risk. Therefore, configuring security settings using this file means you accept the shared responsibilities documentation.

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.12.1

Fixed Issues

Issue Resolution ID

The Key Negotiation feature is working as expected now with legacy SFTP servers.

W-14557165

2.1.0

May 14, 2024

What’s New

  • This connector is now FIPS 140-2 compliant.

    • To make the connector FIPS 140-2 compliant, the net.i2p.crypto:eddsa:0.3.0 EdDSA library is removed from the connector artifact and the related algorithms are no longer available by default. If needed, add the EdDSA library as an external library to the connector configuration to use the EdDSA library if FIPS 140-2 compliance is not required.

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.12.1

2.0.7

March 05, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.12.1

Fixed Issues

Issue Resolution ID

Upgraded Apache Mina version.

W-15081128

Added support to strict key feature to mitigate Terrapin Attack.

W-14875716

Improved logging on "On New or Updated File" operation.

W-15003430

2.0.6

February 27, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.10.0

Fixed Issues

Issue Resolution ID

SFTP Connector now closes the SSH client when the login fails. Additionally, there are new null pointer exception checks at connection time and new logging actions to see errors.

W-14571055

2.0.5

February 20, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.10.0

Fixed Issues

Issue Resolution ID

SFTP Connector now connects to the SFTP client through a proxy with HTTP and SOCK5 protocols.

W-14165289, W-14317632, W-14317577

SFTP File attributes now have null values validation.

W-14571847

SFTP Connector now redeploys successfully when using EdDSA identity files.

W-14492587

2.0.4

January 26, 2024

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.10.0

Fixed Issues

Issue Resolution ID

The SFTP Connector Write operation with the parameter Overwrite enabled now works correctly with SFTP servers.

W-14412871

2.0.3

January 9, 2024

What’s New

  • This connector is now compatible with Java 17.

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8, 11, and 17

Apache Mina SSHD

2.10.0

2.0.2

December 28, 2023

Compatibility

Software Version

Mule

4.1.5 and later

Anypoint Studio

7.1.1 and later

OpenJDK

8 and 11

Apache Mina SSHD

2.10.0

Fixed Issues

Issue Resolution ID

The On New or Updated File source now supports multiple files concurrently.

W-14203139

2.0.1

October 6, 2023

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.1.1 and later

JDK

8

Apache Mina SSHD

2.10.0

Fixed Issues

Issue Resolution ID

The SFTP Connector Write operation now responds correctly.

W-14051911

2.0.0

Aug 17, 2023

What’s New

  • SFTP Connector 2.0.0 no longer supports the jcraft JSCH library. The connector now uses the Apache Mina SSHD library.

  • The List operation no longer fetches the content of each file. Now, the payload of each list item contains the complete path to the found file or directory.

  • The connector no longer uses the mule.sftp.useHomeDirectory system property. SFTP Connector now uses the default home directory.

  • The SFTP Regular Size file attribute is renamed to Regular File, because its behavior is not related to size. The file attribute value is a file (true) or a directory (false).

  • SFTP Connector 2.0.0 does not support ciphers 3des-ctr and arcfour. For more information, refer to Supported Ciphers.

  • The SFTP proxy protocol works only with HTTP and SOCKS5. SOCKS4 support is not supported.

  • SFTP Connector no longer uses javax.activation to resolve the media types of the files. The connector now uses Apache Tika, which can result in different media file interpretations.

  • The connector changed the classes to manage the date from LocalDateTime to ZonedDateTime.

  • The deprecated Encoding parameter in the configuration and Write operation is removed. The connector uses Mule’s default encoding.

Compatibility

Software Version

Mule

4.3.0 and later

Anypoint Studio

7.5.0 and later

JDK

8

Apache Mina SSHD

2.9.2

1.6.3

December 8, 2023

Compatibility

Software Version

Mule

4.1.2 and later

Anypoint Studio

7.1.1 and later

JDK

8

JSCH libraries

0.1.55

Fixed Issues

Issue Resolution ID

The org.mule.modules:mule-module-file-extension-common library is upgraded to version 1.4.3.

W-14535257

1.6.2

Sep 18, 2023

Compatibility

Software Version

Mule

4.1.2 and later

Anypoint Studio

7.1.1 and later

JDK

8

JSCH libraries

0.1.55

Fixed Issues

Issue Resolution ID

The SFTP Connector connection no longer breaks when a timeout exception is thrown.

W-13769562

1.6.1

Dec 15, 2022

Compatibility

Software Version

Mule

4.1.2 and later

Anypoint Studio

7.1.1 and later

JDK

8

JSCH libraries

0.1.55

Fixed Issues

Issue ID

SFTP Connector no longer has a memory leak when the session is not closed due to an error opening a channel.

W-12098169

1.6.0

Aug 30, 2022

Compatibility

Software Version

Mule

4.1.2 and later

Anypoint Studio

7.1.1 and later

JDK

8

Fixed Issues

Issue ID

The On New or Updated File operation now provides the Overwrite field, which enables you to overwrite the target file when the destination file has the same name.

W-11645847

1.5.1

August 17, 2022

Compatibility

Software Version

Mule

4.1.2 and later

Fixed Issues

Issue ID

SFTP Connector now supports the mule.sftp.useHomeDirectory system property, which you can set to true to use the default home directory. Previously, SFTP Connector did not use the default home directory when the working directory was not configured.

W-10673625

1.5.0

June 29, 2022

What’s New

  • SFTP Connector now supports an independent file system matcher that lists files following SFTP RTF standards. Use the Case sensitive field to configure an external file system matcher as case sensitive or insensitive.

Compatibility

Software Version

Mule

4.1.2 and later

Fixed Issues

Issue ID

SFTP Connector no longer fails when a file name contains :.

W-10678323

1.4.1

October 15, 2021

What’s New

  • Added more error and debug level logging information.

Compatibility

Software Version

Mule

4.1.2 and later

Fixed Issues

Issue ID

SFTP Connector On New or Updated File operation did not reconnect.

SE-22668

1.4.0

April 6, 2021

Minimum Mule Version

Mule 4.1.2

Fix issues

  • Fixed an issue where the SFTP Connector threw a MULE:CONNECTIVITY exception instead of an SFTP:CONNECTIVITY exception for all the operations (SE-19522).

1.3.10

September 30, 2020

Minimum Mule Version

Mule 4.1.2

Fix issues

  • SFTP Connector now throws an SFTP:ACCESS_DENIED Mule error code instead of a MULE:UNKNOWN code if the connector does not have the required permissions to read from or write to a file (SE-16476).

  • Improved error handling for the Write operation. SFTP Connector now throws an SFTP:FILE_DOESNT_EXIST Mule error code instead of a MULE:UNKNOWN code (SE-15186).

1.3.9

September 2, 2020

Minimum Mule Version

Mule 4.1.2

Fixed Issue

  • Fixed an issue in which the reconnection strategy did not re-establish the connection to the SFTP server when performing the Directory Listing Operation (SFTPC-51).

1.3.8

July 15, 2020

Minimum Mule Version

Mule 4.1.2

Fixed Issue

Lock not released after write operation is successful (SFTPC-47).

1.3.7

March 10, 2020

Minimum Mule Version

Mule 4.1.2

Fixed Issue

  • MULE-18163: Verifying root folder resulted in exception when using default working directory. (MULE-18163)

1.3.6

February 26, 2020

Minimum Mule Version

Mule 4.1.2

Fixed Issue

  • Avoid CD operation when working directory is not set (MULE-18058)

1.3.5

February 13, 2020

Minimum Mule Version

Mule 4.1.2

Fixed Issue

  • Fixed issue that caused connector fails to authenticate when using ECDSA algorithm with key size of 384 and 521 bits. (MULE-18061)

1.3.4

December 17, 2019

Minimum Mule Version

Mule 4.1.2

Fixed Issues

  • The issue that made SFTP Connector fail to recognize connection issues as such on certain cases is fixed. (MULE-17854)

  • The issue that made it impossible to rename a file without moving it using the listener POST action is fixed. (MULE-17836)

1.3.3

December 2, 2019

Minimum Mule Version

Mule 4.1.2

Fixed Issues

The issue that made some operations throw a MULE:UNKNOWN error when the configured working directory did not exist is fixed. (MULE-17731)

1.3.2

September 25, 2019

Minimum Mule Version

Mule 4.1.2

Fixed Issues

  • Fixed an issue where the Write operation was throwing a MULE:UNKNOWN error instead of an SFTP:ILLEGAL_PATH error. (MULE-17482)

  • Fixed an issue where the SFTP Listener operation was trying to release connections that were never obtained. (MULE-17491)

  • Fixed a bug where the SFTP Connector was unable to dispose of an invalid connection. (MULE-17494)

1.3.1

September 11, 2019

Minimum Mule Version

Mule 4.1.2

Fixed Issues

  • Fixed a bug that made the write operation fail to write big files on certain servers. (MULE-17395)

1.3.0

September 6, 2019

Minimum Mule Version

Mule 4.1.2

Features

The parameters Updated in the last, Not updated in the last, and Time unit are added to the File Matching Rules. These parameters enable you to have a List or Listener operation to filter files based on when they were last updated.

Fixed Issues

  • The issue where the read operation took more than one connection to read the file content is fixed. (MULE-17316)

  • The issue where if you were using the latest version of the SFTP connector with older versions of the File, FTP and FTPS connectors, those connectors failed to work correctly is fixed. (MULE-17404)

1.2.6

August 14, 2019

Minimum Mule Version

Mule 4.1.1

Fixed Issues

Windows apps failed if the path contained a colon character (:) in the FTP server. (MULE-17064)

1.2.5

July 1, 2019

Minimum Mule Version

Mule 4.1.1

Fixed Issues

  • Libraries that may contain vulnerabilities were updated. (MULE-16747)

  • Fixed a bug that made the time between a size check not behave as expected when the time unit was not milliseconds. (MULE-17004)

1.2.4

November 20, 2018

Minimum Mule Version

Mule 4.1.1

Fixed Issues

Mule 4 SFTP connection pooling is not working correctly. (MULE-16018)

1.2.3

October 23, 2018

Minimum Mule Version

Mule 4.1.1

Fixed Issues

  • SFTP Connector listener may skip a file given a special configuration. (MULE-15852)

1.2.2

July 19, 2018

Minimum Mule Version

Mule 4.1.0

Fixed Issues

SFTP Connector must not close the connection in a Paging Provider. (MULE-15354)

1.2.1

June 26, 2018

Minimum Mule Version

Mule 4.1.0

Fixed Issues

  • Change in behavior of the SFTP connector for Mule 4 with regard to directory paths. (MULE-15173)

  • SFTP authentication methods displayed incorrectly / missing (MULE-15185)

  • SFTP is not reconnecting after experiencing a disconnect (MULE-15196)

1.2.0

May 7, 2018

Minimum Mule Version

Mule 4.1.0

Features

  • You can make use of timeBetweenSizeCheck to prevent the connector from processing files while they are being written.

  • Fixed an issue that happened when using a filter by filenamePattern, failing to search files recursively in folders.

Fixed Issues

  • Add CustomSftpLogger for JSCh. (MULE-14738)

  • SFTP getting partial file. (MULE-14824)

  • SFTP Connector does not check for files recursively if a filenamePattern is given. (MULE-14863)

1.1.2

March 14, 2018

Minimum Mule Version

Mule 4.1.0

Fixed Issues

Connectors do not communicate correctly if their POJOs properties are nullable or not. (MULE-14701)

1.1.1

February 02, 2018

Fixed Issues

sftp:listener has an undescriptive display name. (MULE-14589)

1.1.0

January 19, 2018

Features

This release includes the following enhancements, changes, and fixes:

Added a message source that automatically polls for new files, while handling clustering, idempotency, post actions, and watermark automatically.

Upgrade Requirements

Mule 4.1

Fixed Issues

SFTP connectors exports internal classes. (MULE-14496)

See Also