Certificate Signing Request (CSR)
- is a block of encoded text that is given to a Certificate Authority to be signed which then becomes a TLS Certificate.
It is usually generated on the server where the certificate will be installed and contains information that will be included in the certificate such as the organization name, common name (domain name), locality, and country. It also contains the public key that will be included in the certificate. A private key is usually created at the same time that you create the CSR, making a key pair. A CSR is generally encoded using ASN.1 according to the PKCS #10 specification.
A certificate authority will use a CSR to create your SSL/TLS certificate, but it does not need your private key. You need to keep your private key secret. The certificate created with a particular CSR will only work with the private key that was generated with it. So if you lose the private key, the certificate will no longer work.
What is contained in a CSR?
this is defined by the X.509
|
Name |
Explanation |
Examples |
|---|---|---|
|
Common Name |
The fully qualified domain name (FQDN) of your server. This must match exactly what you type in your web browser or you will receive a name mismatch error. | |
|
Organization |
The legal name of your organization. This should not be abbreviated and should include suffixes such as Inc, Corp, or LLC. |
Google Inc. |
|
Organizational Unit |
The division of your organization handles the certificate. |
Information Technology |
|
City/Locality |
The city where your organization is located. |
Mountain View |
|
State/County/Region |
The state/region where your organization is located. This shouldn’t be abbreviated. |
California |
|
Country |
The two-letter ISO code for the country where your organization is located. |
US |
|
Email address |
An email address is used to contact your organization. | |
|
Public Key |
The public key will go into the certificate. |
The public key is created automatically |
What does a CSR look like?
Most CSRs are created in the Base-64 encoded PEM format. This format includes the “-----BEGIN CERTIFICATE REQUEST-----” and “-----END CERTIFICATE REQUEST-----” lines at the beginning and end of the CSR. A PEM format CSR can be opened in a text editor and looks like the following example:
-----BEGIN CERTIFICATE REQUEST-----
MIIByjCCATMCAQAwgYkxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlh
MRYwFAYDVQQHEw1Nb3VudGFpbiBWaWV3MRMwEQYDVQQKEwpHb29nbGUgSW5jMR8w
HQYDVQQLExZJbmZvcm1hdGlvbiBUZWNobm9sb2d5MRcwFQYDVQQDEw53d3cuZ29v
Z2xlLmNvbTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEApZtYJCHJ4VpVXHfV
IlstQTlO4qC03hjX+ZkPyvdYd1Q4+qbAeTwXmCUKYHThVRd5aXSqlPzyIBwieMZr
WFlRQddZ1IzXAlVRDWwAo60KecqeAXnnUK+5fXoTI/UgWshre8tJ+x/TMHaQKR/J
cIWPhqaQhsJuzZbvAdGA80BLxdMCAwEAAaAAMA0GCSqGSIb3DQEBBQUAA4GBAIhl
4PvFq+e7ipARgI5ZM+GZx6mpCz44DTo0JkwfRDf+BtrsaC0q68eTf2XhYOsq4fkH
Q0uA0aVog3f5iJxCa3Hp5gxbJQ6zV6kJ0TEsuaaOhEko9sdpCoPOnRBm2i/XRD2D
6iNh8f8z0ShGsFqjDgFHyF3o+lUyj+UC6H1QW7bn
-----END CERTIFICATE REQUEST-----
How do I generate a CSR and Sign it?
You need to generate a CSR and private key on the server where the certificate will be used. If you are familiar with OpenSSL you can use the following command to generate a CSR and private key (openssl - Generating SSL Certificates):
openssl req -new -newkey rsa:2048 -nodes -out servername.csr -keyout servername.key
Once you have your CSR generated, you will need it signed by a CA. You can use the SSL Wizard to find the best SSL Certificate Authority that will meet your needs.
/pki---components/certificate-signing-request-(csr)/csr-to-ca-to-signed-csr.png)
essentially there are 3 steps:
- generating a CSR
- submitting CSR to a CA of your choice. The CA would verify the contents within the CSR and then signs it with its own CA private key. This generates a Signed CSR or SSL Certificate
- importing the Signed CSR into the SSL server
How do I decode a CSR?
You can easily decode your CSR to see what is in it by using our CSR Decoder. In order to decode a CSR on your own machine using OpenSSL, use the following command:
openssl req -in server.csr -noout -text
What is a CSR/Private Key’s bit length?
The bit-length of a CSR and private key pair determine how easily the key can be cracked using brute force methods. As of 2016, a key size of fewer than 2048 bits is considered weak and could potentially be broken in a few months or less with enough computing power. If a private key is broken, all the connections initiated with it would be exposed to whoever had the key. The Extended Validation guidelines that SSL certificate providers are required to follow, require that all EV certificates use a 2048-bit key size to ensure their security well into the future. Because of this, most providers encourage 2048-bit keys on all certificates whether they are EV or not.
How CSR and CA work with SSL Handshake?
/pki---components/certificate-signing-request-(csr)/verifying_server_certificates.png)
Before a browser and an HTTPS server can exchange data over an encrypted connection, they first engage in a process known as the SSL handshake. One important part of the SSL handshake is the sending of the server certificate to the web browser. It’s here when the Web browser is able to authenticate the identity of the server it’s connecting to.
As soon as the browser receives a copy of the server certificate, it checks which CA signed the server cert and then retrieves the CA certificate of that particular Certificate Authority. It then uses the public key on that CA certificate to verify the digital signature on the server cert.
Once the digital signature has been authenticated, the browser and server can proceed with the rest of the SSL process. If you want to know how the public key on the server certificate is used, I suggest you read the article Roles of Server and Client Keys in Secure File Transfers.
SSL Mutual Authentication
/pki---components/certificate-signing-request-(csr)/ssl-mutual-authentication.png)