Examples¶ The examples are meant to be done in order, each providing the basis for the ones that follow. They are deliberately low on prose, we prefer to let the configuration files and command lines speak for themselves. You will find a reference section at the bottom of each page, with links to relevant parts of the OpenSSL documentation.

In this article you’ll find how to generate CSR (Certificate Signing Request) using OpenSSL from the Linux command line, without being prompted for values which go in the certificate’s subject field.

Below you’ll find two examples of creating CSR using OpenSSL.

Openssl Examples Ecc C++

  1. File called openssl.cnf is used to specify the default parameters to be provided to these commands. Examples of default parameter include those of default certificate request values, the directories for saving the certificates, serial number, CA private key and certificate, and crl. In our hw2 directory we provide a sample.
  2. Openssl sclient -connect example.com:443 Use the openssl sclient -connect flag to display diagnostic information about the SSL connection to the server. The information will include the servers certificate chain, printed as subject and issuer. The end entity server certificate will be the only certificate printed in PEM format.
  3. For example: old-openssl -in bad.p12 -out keycerts.pem openssl -in keycerts.pem -export -name 'My PKCS#12 file' -out fixed.p12 SEE ALSO.
  4. OpenSSL Commands Examples OpenSSL is an open-source implementation of the SSL protocol. The OpenSSL commands are supported on almost all platforms including Windows, Mac OSx, and Linux operating systems. The OpenSSL can be used for generating CSR for the certificate installation process in servers.

In the first example, i’ll show how to create both CSR and the new private key in one command.

And in the second example, you’ll find how to generate CSR from the existing key (if you already have the private key and want to keep it).

Both examples show how to create CSR using OpenSSL non-interactively (without being prompted for subject), so you can use them in any shell scripts.

Create CSR and Key Without Prompt using OpenSSL

Use the following command to create a new private key 2048 bits in size example.key and generate CSR example.csr from it:

OptionDescription
openssl reqcertificate request generating utility
-nodesif a private key is created it will not be encrypted
-newkeycreates a new certificate request and a new private key
rsa:2048generates an RSA key 2048 bits in size
-keyoutthe filename to write the newly created private key to
-outspecifies the output filename
-subjsets certificate subject

Generate CSR From the Existing Key using OpenSSL

Use the following command to generate CSR example.csr from the private key example.key:

OptionDescription
openssl reqcertificate request generating utility
-newgenerates a new certificate request
-keyspecifies the file to read the private key from
-outspecifies the output filename
-subjsets certificate subject

Automated Non-Interactive CSR Generation

The magic of CSR generation without being prompted for values which go in the certificate’s subject field, is in the -subj option.

-subj argReplaces subject field of input request with specified data and outputs modified request. The arg must be formatted as /type0=value0/type1=value1/type2=…, characters may be escaped by (backslash), no spaces are skipped.

The fields, required in CSR are listed below:

FieldMeaningExample
/C=CountryGB
/ST=StateLondon
/L=LocationLondon
/O=OrganizationGlobal Security
/OU=Organizational UnitIT Department
/CN=Common Nameexample.com

You’ve created encoded file with certificate signing request.

Now you can decode CSR to verify that it contains the correct information.

Updated on April 3, 2019

OpenSSL is among the most popular cryptography libraries. It is most commonly used to implement the Secure Sockets Layer and Transport Layer Security (SSL and TLS) protocols to ensure secure communications between computers. In recent years, SSL has become basically obsolete since TLS offers a higher level of security, but some people have gotten into the habit of referring to both protocols as SSL.

Cryptography is tricky business, and OpenSSL has too many features to cover in one article, but this OpenSSL tutorial will help you get started creating keys and certificates.

OpenSSL tutorial: An introduction to internet security

When a client requests a secure connection to a server, the server, in turn, requests information to figure out which types of cryptographic security the client can support. Once it determines the most secure option, the following takes place:

  1. The server sends a security certificate that is signed with the server's public key.
  2. Once the client verifies the certificate, it generates a secret key and sends it to the server encrypted with the public key.
  3. Next, both sides use the secret key to create two sets of public-private keys. At last, secure communication can commence.

SSL and TLS are two of many security protocols used to accomplish these steps. To implement these protocols, we need software like OpenSSL.

Abbreviations key

You'll come across tons of abbreviations in this guide and other OpenSSL tutorials. For quick reference, here is a short list of some terms you might encounter:

  • CSR: Certificate Signing Request
  • DER: Distinguished Encoding Rules
  • PEM: Privacy Enhanced Mail
  • PKCS: Public-Key Cryptography Standards
  • SHA: Secure Hash Algorithm
  • SSL: Secure Socket Layer
  • TLS: Transport Layer Security

Part 1 - Getting started

You can download the source code for most platforms from the official OpenSSL website.

If you need a windows distribution, Shining Light Productions has a good one although there are plenty of alternatives. Once everything is successfully installed, let's begin by experimenting with the OpenSSL command line tool.

First, you can use the following command to display which version of OpenSSL you're running:

To get a full list of the standard commands, enter the following:

Check out the official OpenSSL docs for explanations of the standard commands. To view the many secret key algorithms available in OpenSSL, use:

Now, let's try some encryption. If you wanted to encrypt the text 'Hello World!' with the AES algorithm using CBC mode and a 256-bit key, you would do as follows:

You'll be prompted to enter a password from which the 256-bit secret key will be computed. In the above example, the password example is used, but you should have stronger passwords. You should now have a binary file called encrypted.bin that you can decrypt as follows:

Part 2 - Public and private keys

For the sake of example, we can demonstrate how OpenSSL manages public keys using the RSA algorithm. You can use other algorithms of course, and the same principles will apply. The first step is to generate public and private pairs of keys. Enter the following command to create an RSA key of 1024 bits:

You should now have a file called key.pem containing a public key and private key. As the file's name suggests, the private key is coded using the Privacy Enhanced Email, or PEM, standard. Use the following code to display it:

You should see a long combination of characters. For detailed information about how your key was generated, enter:

This command should return information about the public and private exponents, the modulus and the other methods and numbers used to optimize the algorithm. In this context, the -noout option prevents display of the key in base 64 format, which means that only hexadecimal numbers are visible. The public exponent is an exception, of course, since it is always 65537 for 1024 bit keys.

To encrypt our private key, we use the following code:

Once the key file has been encrypted, you will then be prompted to create a password. Next, we can extract the public key from the file key.pem with this command:

Finally, we are ready to encrypt a file using our keys. Use the following format:

Openssl

In the above context, <input_file> is the file you want to encrypt. Since we're using RSA, keep in mind that the file can't exceed 116 bytes. The <key.pem> is the file containing the public key. If that file doesn't also include the private key, you must indicate so using -pubin. The <output_file> is the encrypted file name.

Openssl Example C

Now, to decrypt the file, you can simply flip the equation. Change -encrypt to -decrypt, and switch the input and output files.

Part 3 - Creating digital signatures

At last, we can produce a digital signature and verify it. Signing a large file directly with a public key algorithm is inefficient, so we should first compute the digest value of the information to be signed. This can be accomplished using the following command:

In this example, <hash_algorithm> is whichever algorithm you choose to compute the digest value. The <input_file> is the file containing the data you want to hash while 'digest' is the file that will contain the results of the hash application.

The next step is to compute the signature of the digest value as follows:

Finally, you can check the validity of a signature like so:

Here, signature is the filename of your signature, and key.pem is the file with the public key. To confirm the verification for yourself, you can compute the digest value of the input file and compare it to the digest value produced from the verification of the digital signature.

Part 4 - Certificate signing requests

Let's say that you want to create digital certificates signed by your own certificate authority. Before you can get an SSL certificate from a certificate authority, or CA, you must first generate a certificate signing request or a CSR. A CSR includes a public key as well as some extra information that gets inserted into the certificate when signed.

When you first create a CSR, you'll be asked to supply some information about yourself or your organization. In the field 'Common Name,' or CN, you must provide the fully qualified domain name of the host for which the certificate is intended. If you're actually purchasing an SSL certificate from a CA, then the information you provide should be factual and accurate! Imagine you want to secure an Apache HTTP or Nginx web server with HTTPS. You can use the following snippet to create a new 2048-bit private key along with a CSR from scratch:

Openssl

Openssl Example Config File

Imagine you want to secure an Apache HTTP or Nginx web server with HTTPS. You can use the following snippet to create a new 2048-bit private key along with a CSR from scratch:

Just replace 'domain' with your domain name. Here, the -newkey rsa:2048 option tells OpenSSL that it should use the RSA algorithm to create a 2048-bit key, and the -nodes option indicates that the key shouldn't be password protected.

After you've provided all of the necessary information, your CSR will be generated. Lg tv support airplay. Now, you can send it to a CA and request an SSL certificate. If your CA supports SHA-2, be sure to add the -sha256 option if you want your CSR to be signable with SHA-2.

To create a CSR for a private key that already exists, you would use this format:

Openssl Example Tls

Again, replace domain with your domain name. The -key option here indicates that you're using an existing private key while -new indicates that you're creating a new CSR. In the prior example, -new was implied because you were making a new key.

Let's say you already have a certificate that you want to renew, yet you somehow lost the original CSR. Don't panic; you can generate a new one based on information from your certificate and the private key. For example, if you were using an X509 certificate, you'd use the following code:

The -x509toreq option is needed to let OpenSSL know the certificate type.

Part 5 - Generating SSL certificates

If you desire the extra security of an SSL certificate, but you can't afford or don't want to be bothered with a CA, a less expensive alternative is to sign your own certificates. Self-signed certificates are signed with their own private keys, and they are just as effective at encrypting data as CA-signed certificates; however, users might receive an alert from their browser indicating that the connection is not secure, so self-signed certificates are really only recommended in environments where you're not required to prove your service's identity such as on a non-public server.

Again, assume that you're using HTTPS to secure an Apache HTTP or Nginx web server. The following command will create a 2048-bit private key along with a self-signed certificate:

The -x509 option tells OpenSSL that you want a self-signed certificate, while -days 365 indicates that the certificate should be valid for one year. OpenSSL will generate a temporary CSR for the purpose of gathering information to associate with the certificate, so you will have to answer the prompts per usual.

If you already have a private key that you want to associate with a self-signed certificate, just change the code slightly:

Remember that inclusion of the -new option is necessary since you are creating a new CSR from an existing key.

Part 6 - Viewing certificates

To view certificates and CSR files, you must decode them from the PEM format. Use the following command to view the contents of a CSR in plain text:

To view a certificate's content in plain text, use:

Openssl Example

You can verify that a certificate was signed by a specific CA by plugging its name into the following code:

Summary

In today's increasingly digital world, improving internet security is imperative to protect our own security. Many website databases contain treasure troves of information about visitors, and hackers are always learning new ways to navigate system vulnerabilities and exploit such data. That's why security protocols must continue to evolve. Stay informed to make sure you're providing adequate protection for your users.