SFTP Configuration On Files.com That May Be Relevant

The following configuration items have caused SFTP issues for customers.

User Account Settings

Verify that the username is enabled and that the username and password are correct. Edit the user and confirm that the Account enabled setting is turned on. Confirm that the Authentication method is not set to "none". When set to "none", a user account can only authenticate by using an API key or an SSH/SFTP Key.

SFTP Protocol Privileges

The user might have SFTP disabled in their settings. Edit the user and check that SFTP is enabled in their Privileges for Protocol access.

Require Password Change

If the user account has been configured to Require password change on next login, SFTP login will not succeed until the password has been changed. Ask the user to access Files.com through the web interface and complete the password change before attempting a login via SFTP.

Two Factor Authentication (2FA)

If the user has Two Factor Authentication (2FA) enabled, only certain 2FA methods work with SFTP. The Two Factor Authentication documentation page has more information on this. When using 2FA with SFTP, disable any parallelism in your SFTP app, because 2FA is only valid for one connection at a time. Elsewhere we recommend maxing out the available parallelism in your app for performance. 2FA is a case where that option is not available.

IP Whitelist

If your site or user is subject to an IP whitelist, the user must access the site using one of the whitelisted IPs from either list. Check your IP whitelists to confirm that the IP address making SFTP connections is allowed.

Eliminate SFTP as the Sole Cause

If a user has problems logging in via SFTP, have them attempt to log in using the Files.com web interface. If the issue persists there, that eliminates SFTP as the cause.