Introduction

Our SFTP solution allows you to send us data to ingest. When you send us the files, we process them in real time and subsequently delete the files from the server.

Connection requirements

You can use any SFTP client (for example, FileZilla) that supports a SSH Private Key for authorization.

Credentials

Once the contract is signed, you will generate an SSH public/private key pair, and share the public key with us. Banyan will then provide you with the hostname and user name for your SFTP server, which you will access with your private SSH key.

In general:

Server address: YOUR_COMPANY_NAME.sftp.banyan.com
User: sftpuser
Authentication: SSH Private Key

Where to upload

Once you are logged in to the server, please use the input folder inside the data folder to upload the files. Files uploaded anywhere else won't be processed.

Schedule

Depending on your infrastructure we would prefer to receive the file at least once per day or as otherwise mentioned in your agreement with Banyan.

File format

We recommend files sent should be no bigger than 2GB compressed in size.

Caveats

When you’ll write your custom implementation to upload data to our SFTP server, make sure to take the following scenarios in to account:

The server can become unavailable for a short period of time. Make sure to have in place a retry mechanism.
The SSH signature of the server might change due to hardware failure or changes in the hardware configuration. Make sure to take this into account (the URI won’t change).
Due to a limitation of the cloud storage backend, files cannot be updated in-place: they must first be deleted, and then re-uploaded.