Getting Your Data Securely Into Clario

SFTP

Connection Details

  • hostname: sftp.clar.io
  • username: <your email address>
  • password: <your password>
  • port: 22

Warning

SFTP usernames are case-sensitive; Our authentication system expects it to be all lowercase.

Upload large data files into Clario using any application that supports Secure File Transfer Protocol (SFTP). Your login credentials will be the same as your Clario username and password. Non-interactive authentication is supported via public-key exchange. See Public Key Exchange for details on getting set up.

Upload all files to the /toClario folder for automated processing.

Note

If you do not have an SFTP application, there are several free SFTP clients available for download online, such as WinSCP, FileZilla, and GlobalScape CuteFTP.

Direct Upload

Upload a file up to 10 MB in size to Clario via the upload toolbar button. Files are available for use upon upload completion.

To begin an upload, a file browser showing your local file system is displayed allowing you to select a file. Allowed extensions include .txt, .csv, .dat, .xlsx, .gz and .gzip. File size is limited to 10MB and anything exceeding this limit must be sent to Clario via SFTP.

What happens next?

Once a file has been received an attempt is made to determine the file type. The process is represented below:

../_images/sftp_process.png

Note

The process highlighted in green represents the preferred path for getting data into Clario

  • If the file is a single archive gzip file, the gz/gzip extension is removed and the file is uploaded as-is. This is the fastest way to get a file into Clario. Sending a file in gzip format obviates the need for us to decompress, verify, and compress the file, speeding up the overall transfer/upload time.
  • If the file is a multi archive zip file, it is decompressed into its constituent files. An attempt is then made to identify the type of each file from the archive.
  • If the file is a plain text file, the file is gzipped and uploaded.
  • If the file is of an unknown type, it is rejected with an error message (sent via email if SFTP notifications are enabled) indicating what was determined about the suspect file. The file is then deleted.

Once a file has been successfully uploaded, the files are moved to:

  • Shared Files in the case of SFTP
  • Shared Files or Project Files in the case of Direct Upload