Blog

Managed File Transfer and Network Solutions

How To Set Up A HTTPS File Transfer

Posted by John Carl Villanueva on Tue, Dec 30, 2014 @ 02:21 AM


Overview

In this post, you'll learn how to set up a HTTPS file transfer. We'll begin with a "quickstart", where you'll use the default settings in order to get a HTTPS file transfer service up and running with just a few clicks. After that, we'll tackle some of the more advanced settings so you can choose your desired set of SSL/TLS cipher suites and server key. Your choice of cipher suites and keys will have an effect on the security of your HTTPS service and its compatibility with your users' web browsers.

Note: The HTTPS or HTTP Secure protocol is defined in RFC 2818, so if you want a really technical discussion on HTTPS alone, feel free to read that.

Note: JSCAPE's HTTPS is not affected by the Heartbleed vulnerability



What we'd like to do

 

https-file-transfer

 

Prefer to watch a video of this tutorial instead?

 

 

Let's now proceed with the quick start. 

 

1. Enable HTTPS on your host

 

Launch your JSCAPE MFT Server Manager and go to the Settings menu

 

01-how-to-setup-https-file-transfer-10-1.png

 

Next, go to the Web module. In the Web tab, tick both the HTTP on host and HTTPS on host checkboxes. Why do we have to tick the HTTP on host checkbox too? Because if we leave that unchecked, end users who attempt to connect via HTTP (which is usually the default action on most browsers) will get an "Unable to connect" error. 

 

02-how-to-set-up-https-file-transfer-10-1.png

 

Of course, since we want our users to connect to the secure HTTPS service (and not the unencrypted HTTP service), we have to make sure they are redirected to the HTTPS service even if they initially attempt to connect via HTTP. To do that, scroll down to the Connections panel and then tick the checkbox labeled Redirect HTTP requests to HTTPS

 

03-redirect-http-requests-to-https-10-1.png

 

The settings we made will allow end users to enter your server's host name or IP address as normal (usually via HTTP) and then redirect them to your HTTPS connection without them noticing.

So, for example, if a user enters either of the following into his browser:

http://domain.com

or

domain.com - in which case most browsers would just automatically append http:// to the beginning, 

JSCAPE MFT Server will automatically redirect the browser to your https service.

Pretty nifty, huh?

When you're done, go the bottom-right corner of that page and then click the Apply button.

 

04-how-to-setup-https-file-transfer-10-1.png

 

Note: If you just configure the server up to this point, your end users will be able to connect to it and see the login screen. They'll even be able to enter values into the fields but that's about it. They won't be able to login to the server. That's why you need to proceed to step 2. :)

 

2. Activate the HTTPS service on your desired domain

 

Go to the Domains tab, select the domain where you want HTTPS to be activated, and then click the Edit button. 

 

05-how-to-setup-https-file-transfer-10-1.png

 

Navigate to the Services module and then click the Add button.

 

06-how-to-setup-https-file-transfer-10-1-1.png

 

When the pop-up window appears, select HTTP/S from the drop-down list and then click OK.

 

07a-how-to-setup-https-file-transfer-10-1.png

 

In the next screen, tick both HTTP and HTTPS checkboxes, and then click the OK button.

 

07b-how-to-setup-https-file-transfer-10-1.png

 

You should then see your newly added HTTP/S service in your list of services.

 

08-how-to-setup-https-file-transfer-10-1.png

 

At this point, you would now have an operational HTTPS file transfer service, which you can try using in a test environment. However, be advised that it's by no means suitable for a production environment, especially one facing the Wild Wild Web.

First of all, the server key employed by default is only the example_rsa key that came with your JSCAPE MFT Server installation. You would want to replace that with something representative of your organization and, of course, more secure. Let me now show you where you can do that.

 

Preparing Server Keys

 

Before we replace example_rsa, let me explain first what this key is for. This key is known as a Server Key. And in the context of the Key Manager, the Server Key actually consists of three elements: a private key, a digital certificate and a public key. Here's how these three elements come into play.

When a user's Web browser first connects to your server via HTTPS, your server will look up which server key was assigned for the service and then send the corresponding digital certificate and public key back to the browser.

The digital certificate will serve as your server's credentials and will help the user's browser determine whether your HTTPS server can be trusted or not. In order for the browser to trust your server's digital certificate, the certificate should bear a Certificate Authority's (CA's) digital signature. Without that signature, the browser would alert the user like this:

 

connection-is-untrusted

 

The user can still disregard that warning and proceed to login to your server but at least he would have already been notified of the risks. 

The public key and private key, on the other hand, will be used to secure certain pieces of data that are exchanged during what is known as the SSL Handshake. The SSL handshake is the procedure at the start of an HTTPS file transfer session wherein a web browser and the HTTPS server agree which set of algorithms (collectively known as cipher suites) should be used during the session.

An SSL handshake culminates with the creation of a session key, which is a symmetric key used for encrypting whatever files are uploaded and downloaded during the HTTPS file transfer session.

We'll talk about where you can configure those algorithms in the succeeding section. In the meantime, let me walk you through the steps of preparing a server key.

Go to the Keys menu. 

 

09-how-to-setup-https-file-transfer-10-1.png

 

Navigate to the Server Keys tab and then click GenerateGenerate Key.

 

10-how-to-setup-https-file-transfer-10-1.png

 

Enter pertinent information, including:

Key alias - Alias you wish to assign to the key. 

Key algorithm - The algorithm used in generating this key. Valid options are RSA and DSA. 

Key length - The length of the key in bytes. Valid options are 1024 and 2048. Although longer key lengths naturally translate to stronger encryption, they can also be more computationally demanding. Read the article "Choosing Key Lengths for Encrypted File Transfers" for more details on this matter. Note, for key lengths greater than 1024 you must install the Unlimited Jurisdiction Policy Files

Validity - The number of days this key is valid. 

Common name - The name you wish to assign this key. Typically the domain name this key will server e.g. ftp.mydomain.com 

Organizational unit - The unit within your organization that this key will be used for e.g. IT. 

Organization - Your organization name. 

Locality - Your city. 

State/Province - Your state or province. 

Country - Your 2 character country code e.g. "US".

 

11-how-to-setup-https-file-transfer-10-1.png

 

Click OK when done.

You should then see your newly created Server Key.

 

12-how-to-setup-https-file-transfer-10-1-1.png

 

In order for that server key's corresponding certificate to be trusted by your end user's browsers you would have to submit a Certificate Signing Request (CSR) for this particular server key to a Certificate Authority. This particular process is beyond the scope of this article but you can find more details in our documentation for Obtaining a trusted certificate.

Once your private key has been signed by the CA, you may then import it. Read the documentation for Importing third party certificates for details. Pay attention to the "Note" on that page, as some of the problems you may potentially encounter moving forward can simply be caused by that.

After importing, go back to Settings > Web and then, in the HTTPS panel, select the alias of the newly imported private key. When you're done, click the Apply button at the right-corner of that page.

 

13-how-to-setup-https-file-transfer-10-1.png

 

Selecting SSL/TLS Cipher Suites

 

Earlier, when we briefly touched on a process known as the "SSL Handshake", we mentioned the term "cipher suites". Let me now explain what they're for.

A cipher suite is typically composed of 4 algorithms:

1. an algorithm for key exchanges;

2. an algorithm for implementing authentication;

3. an algorithm for establishing confidentiality; and

4. an algorithm for establishing data integrity

Here's an example of a cipher suite:

 

TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256

 

Here,

✔ ECDHE, which stands for Elliptic Curve Diffie-Hellman Ephemeral, is the algorithm for exchanging keys;

✔ ECDSA, which stands for Elliptic Curve Digital Signature Algorithm, is the algorithm for implementing authentication;

✔ AES_128 is the symmetric encryption key algorithm and is used for establishing confidentiality; and

✔ SHA256 is the secure hashing algorithm used for establishing data integrity

Before any HTTPS file transfer can take place, your end user's Web browser and your secure Web server must first agree on a common set of algorithms. Basically, as soon the browser first connects via what is known as a "Client Hello", it immediately informs your server which cipher suites it supports. Your server will then check which among those cipher suites are enabled on its side and then choose the most secure.

So, really, if you want maximum compatibility, i.e., you want to make sure your server can serve as many kinds and versions (including legacy) of web browsers as possible, then you simply need to enable all supported cipher suites on your server.

On the other hand, if you want to achieve maximum security, then you'll have to restrict your HTTPS file transfers to only the most secure cipher suites. A discussion on which cipher suites are the most secure is beyond the scope of this article. But I think it's going to be a very interesting topic, so stay tuned for that.

To enable or disable SSL/TLS cipher suites, once again go back into Settings > Web and then click the SSL/TLS ciphers button.

 

14-how-to-setup-https-file-transfer-10-1.png

 

You can then start selecting the SSL/TLS cipher suites you want to enable for your HTTPS file transfers.

 

15-how-to-setup-https-file-transfer-10-1-1.png

 

As soon as you're done, click OK and then click Apply.

That's it! I hope you liked what you learned today. 

If you haven't tried this out yet and want to do so now, simply download the FREE evaluation edition of JSCAPE MFT Server and follow the instructions on this article. Enjoy!



Get started

Download Now


 Want to be updated on posts like this? Connect with us...

 

 

Topics: JSCAPE MFT Server, Managed File Transfer, Tutorials, Secure File Transfer