welcome: please sign in

Revision 33 as of 2009-02-01 21:51:28

Clear message

MemberManual / ServingWebsites / SslCert

This is the page of the MemberManual that describes how to generate a valid SSL cert.


There are several different options available for providing an SSL certificate to use with us.

The first option is to get a signed certificate from a trusted Certificate Authority ("CA" for short). If you want to make it os that visitors to your website never see an annoying nag dialog box, then this is your best option.

Alternatively, you can provide us with a certificate request ("CSR" for short), and we can provide you with a signed certificate. Please be aware that since our CA certificate is not included by default with any web browsers or operating systems, you won't really gain much benefit from having us sign your cert, except for a nebulous "cool factor" :) . If you want to be sure that the people who browse your website won't be prompted about accepting your SSL certificate, then this is not for you.

The last option is to make a self-signed certificate.

After you get the certificate in one of the listed ways, you'll need to use the Members Portal to submit a SSL Certificate Installation request. Most probably, you'll also need to submit an IP address request to have your SSL-enabled website work properly.

Option 1: Getting a certificate from a real CA

There are several options available. By far the largest providers are VeriSign and Thawte. We make no specific recommendations concerning which CA to choose: just make certain that their root CA certificates are included with the majority of web browsers.

One interesting option is a free SSL certificate from Comodo on http://www.instantssl.com/. They issue a regular and trusted SSL certificate at no cost, provided that you're fine with the following:

Option 2: Having HCoop provide you with a certificate

If you are creating an SSL certificate to use for a web virtual host via DomTool, then you need to create both a key file and a csr file. The csr file is called a "certifcate signing request" (sometimes abbreviated "certificate request"), and you will want to specify that on the SSL form in the HCoop Portal. We'll also need access to your key.

This allows you to import a single CA certificate (click on the link if you wish to install it), which avoids the "certificate confirmation" dialog box when you browse one of our websites (or one of our member websites). Be aware that we are not in any way requiring that you have your certificate signed by HCoop; it is solely for the sake of convenience and the aforementioned nebulous "cool factor" that we provide this option.

To create a cerificate request in file.csr and a private key in file.key, do the following. These files should be readable only by you and the HCoop admins, so be sure to set permissions properly on the directory where you store the certificate request and key. The certificate should be placed somewhere in your home directory, like "~/certs", for example.

openssl req -newkey rsa:2048 -keyout file.key -out file.csr -nodes

Here is an explanation of the parameters that you will be asked to provide. Replace yourdomain.org with your domain name.

You will supply us with:

When we process your request, we will:

Now you're ready to follow the rest of the instructions on the parent page.

Making a self-signed .pem file

This is for reference, in case you want to make a self-signed certificate rather than having HCoop sign it. DAYS indicates the number of days that you want the certificate to be valid.

FILE is the filename of the certificate that will be generated: it should end in ".pem". DAYS indicates the number of days that you want the certificate to be valid.

openssl req -x509 -newkey rsa:2048 -keyout FILE -out FILE -days DAYS -nodes

Now you're ready to follow the rest of the instructions on the parent page.