welcome: please sign in

Diff for "MemberManual/ServingWebsites/SslCert"

Differences between revisions 1 and 18 (spanning 17 versions)
Revision 1 as of 2005-08-08 02:35:31
Size: 188
Editor: AdamChlipala
Comment:
Revision 18 as of 2007-11-17 05:42:13
Size: 2934
Editor: MichaelOlson
Comment: Add complementary copy text
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
To create a self-signed SSL cerificate in `file.crt` with key in `file.key`, you can run: #pragma section-numbers off

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

[[TableOfContents]]

= Making a cert for use with Domtool =

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 crt file. The crt file is called a "certifcate request", and you will want to specify that on the SSL form in the HCoop Portal. We'll also need access to your key.

To create a cerificate request in `file.crt` and a private key in `file.key`, do the following. The certificate should be placed somewhere in your home directory, like "{{{~/certs}}}", for example.
Line 4: Line 14:
openssl req -x509 -newkey rsa:1024 -keyout file.key -out file.crt -days 9999 -nodes openssl req -newkey rsa:2048 -keyout file.key -out file.crt -nodes
Line 6: Line 16:

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

 * '''Country'''/'''State'''/'''Locality''': These are self-explanatory.
 * '''Organization Name''': This can be anything you want. It is often the full name or description of your organization or website.
 * '''Organizational Unit Name''': This can be anything you want. It can be left blank.
 * '''Common Name''': This is the domain that goes with the certificate. It can be either a single name (i.e. "yourdomain.org"), or a wildcard domain (like "*.yourdomain.org"). The wildcard domain is used for sharing the same certificate in multiple subdomains of your domain.
 * '''Email Address''': A valid email address. People often use {{{ca@yourdomain.org}}}.
 * '''Challenge Password''': Leave blank.
 * '''Company Name''': This can be anything you want. It can be left blank.

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. Now you're ready to follow the rest of the instructions on [:../:the previous page].

When we process your request, we will:

 * Sign the certificate request as a Certificate Authority (CA).
 * Concatenate the signed request with your key.
 * Place a complementary copy of the result in the smae directory as the certificate request.
 * Place the result in {{{/etc/apache2/ssl/user/yourdomain.org.pem}}}.
 * Grant you Domtool permissions so that you can use this certificate at location {{{/etc/apache2/ssl/user/yourdomain.org.pem}}} in your Domtool configuration.

= Making a self-signed .pem file =

This is for reference, in case you want to make a self-signed certificate for one of your own machines. '''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
}}}

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

TableOfContents

Making a cert for use with Domtool

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 crt file. The crt file is called a "certifcate request", and you will want to specify that on the SSL form in the HCoop Portal. We'll also need access to your key.

To create a cerificate request in file.crt and a private key in file.key, do the following. The certificate should be placed somewhere in your home directory, like "~/certs", for example.

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

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

  • Country/State/Locality: These are self-explanatory.

  • Organization Name: This can be anything you want. It is often the full name or description of your organization or website.

  • Organizational Unit Name: This can be anything you want. It can be left blank.

  • Common Name: This is the domain that goes with the certificate. It can be either a single name (i.e. "yourdomain.org"), or a wildcard domain (like "*.yourdomain.org"). The wildcard domain is used for sharing the same certificate in multiple subdomains of your domain.

  • Email Address: A valid email address. People often use ca@yourdomain.org.

  • Challenge Password: Leave blank.

  • Company Name: This can be anything you want. It can be left blank.

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. Now you're ready to follow the rest of the instructions on [:../:the previous page].

When we process your request, we will:

  • Sign the certificate request as a Certificate Authority (CA).
  • Concatenate the signed request with your key.
  • Place a complementary copy of the result in the smae directory as the certificate request.
  • Place the result in /etc/apache2/ssl/user/yourdomain.org.pem.

  • Grant you Domtool permissions so that you can use this certificate at location /etc/apache2/ssl/user/yourdomain.org.pem in your Domtool configuration.

Making a self-signed .pem file

This is for reference, in case you want to make a self-signed certificate for one of your own machines. 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

MemberManual/ServingWebsites/SslCert (last edited 2022-01-15 06:48:28 by JesseShumway)