Securing Faspex / Installing SSL Provided by Authorities |
Follow the steps below to generate an RSA Private Key, Certificate Signing Request (CSR) and optional self-signed certificate using OpenSSL. For your organization's internal and/or testing purposes, Aspera also provides server.crt and server.key, which are located in the following directory:
OS Version | File Location |
---|---|
32-bit Windows | C:\Program Files (x86)\Common Files\Aspera\Common\apache\conf\ |
64-bit Windows | C:\Program Files\Common Files\Aspera\Common\apache\conf\ |
In a Command Prompt window (Start menu > All Programs > Accessories > Command Prompt), create a new working directory as follows:
> cd c:\ > mkdir ssl > cd c:\ssl
Enter the following commands in your Command Prompt window:
OS Version | Commands |
---|---|
32-bit Windows |
> copy "c:\Program Files\Common Files\Aspera\common\apache\conf\openssl.cnf" "c:\ssl\" > cd c:\ssl |
64-bit Windows |
> copy "c:\Program Files (x86)\Common Files\Aspera\common\apache\conf\openssl.cnf" "c:\ssl\" > cd c:\ssl |
In this step, you will generate an RSA Private Key and CSR using OpenSSL. In a Command Prompt window, enter the following command (where my_key_name.key is the name of the unique key that you are creating and my_csr_name.csr is the name of your CSR):
> openssl req -config "c:\ssl\openssl.cnf" -new -nodes-newkey rsa:2048 -keyout my_key_name.key -out my_csr_name.csr
> mkdir c:\ssl > copy "C:Program Files (x86)\Aspera\Enterprise Server\etc\openssl.cnf" "c:\ssl"
After entering the command in the previous step, you will be prompted to input several pieces of information, which are the certificate's X.509 attributes.
Generating a 1024 bit RSA private key ....................++++++ ................++++++ writing new private key to 'my_key_name.key' ----- You are about to be asked to enter information that will be incorporated into your certificate request. What you are about to enter is what is called a Distinguished Name or a DN. There are quite a few fields but you can leave some blank For some fields there will be a default value, If you enter '.', the field will be left blank. ----- Country Name (2 letter code) [US]:Your_2_letter_ISO_country_code State or Province Name (full name) [Some-State]:Your_State_Province_or_County Locality Name (eg, city) []:Your_City Organization Name (eg, company) [Internet Widgits Pty Ltd]:Your_Company Organizational Unit Name (eg, section) []:Your_Department Common Name (i.e., your server's hostname) []:secure.yourwebsite.com Email Address []:johndoe@yourwebsite.com
You will also be prompted to input "extra" attributes, including an optional challenge password. Please note that manually entering a challenge password when starting the server can be problematic in some situations (e.g., when starting the server from the system boot scripts). You can skip inputting a challenge password by hitting the "enter" button.
... Please enter the following 'extra' attributes to be sent with your certificate request A challenge password []: An optional company name []:
After finalizing the attributes, the private key and CSR will be saved to your root directory.
You now need to send your unsigned CSR to a Certifying Authority (CA). Once the CSR has been signed, you will have a real Certificate, which can be used by Apache.
At this point, you may need to generate a self-signed certificate because:
You may also generate a self-signed certificate through OpenSSL. This temporary certificate will generate an error in the client's browser to the effect that the signing certificate authority is unknown and not trusted. To generate a temporary certificate (which is good for 365 days), issue the following command:
openssl x509 -req -days 365 -in my_csr_name.csr -signkey my_key_name.key -out my_cert_name.crt
After receiving your signed certificate from your CA, copy the files into Apache's /conf directory and edit your httpd-ssl.conf file (note that you can store the certificate and key in any directory, as long as the path(s) are updated in your configuration file. For additional information, please continue to the topic Create an SSL Certificate (Apache).