Enc

From OpenSSLWiki
Revision as of 18:13, 27 June 2013 by Frukto (talk | contribs)
Jump to navigationJump to search

This page describes the command line tools for encryption and decryption. Enc is used for various block and stream ciphers using keys based on passwords or explicitly provided. It can also be used for Base64 encoding or decoding.

Synopsis

The basic usage is to specify a ciphername and various options describing the actual task.

$ openssl enc -ciphername [options]

You can obtain an incomplete help message by using an invalid option, eg. -help.

Cipher alogorithms

To get a list of available ciphers you can use the list-cipher-algorithms command

$ openssl list-cipher-algorithms

The output gives you a list of ciphers with its variations in block size an mode of operation. For example AES-256-CBC for AES with blocksize 256 in CBC-mode. Some ciphers also have short names, for example the one just mentioned is also known as aes256. These names are case insensitive. In addition none is a valid ciphername. This algorithms does nothing at all.

Options

The list of options is rather long.

-in filename
This specifies the input file.
-out filename
This specifies the output file. It will be created or overwritten if it already exists.
-e or -d
This specifies whether to encrypt (-e) or to decrypt (-d). Encryption is the default. Of course you have to get all the other options right in order for it to function properly.
-base64, -a, -A
These flags tell OpenSSL to apply Base64-encoding before or after the cryptographic operation. The -a and -base64 are equivalent. If you want to decode a base64 file it is necessary to use the -d option. By default the encoded file has a line break every 64 characters. To suppress this you can use in addition to -base64 the -A flag. This will produce a file with no line breaks at all. You can use these flags just for encoding Base64 without any ciphers involved.
-pass arg
This specifies the password source.
-k password, -kfile filename
Both option are used to specify a password or a file containing the password which is used for key derivation. However they are deprecated. You should use the -pass option instead. The equivalents are -pass pass:password and -pass: pass:filename respectively.
-K key
The options allows set the key used for encryption or decryption. This is the key directly used by the cipher algorithm. This is rarely used, normally you specify a password from which a key is derived.
-iv IV
-S salt, -salt, -nosalt

Examples

Base64 Encoding

To encode a file text.plain you can use

$ openssl enc -base64 -in text.plain -out text.base64

To decode a file the the decrypt option (-d) has to be used

$ openssl enc -d -base64 -in text.base64 -out text.plain

Encryption

The most basic way to encrypt a file is this

$ openssl enc -des -base64 -in some.secret -out some.secret.enc
enter des-cbc encryption password :
Verifying - enter des-cbc encryption password :

It will encrypt the file some.secret using the DES-cipher in CBC-mode. The result will be base64 encoded and written to some.secret.enc. OpenSSL will ask for password which is used to derive a key as well the initialization vector. Since encryption is the default, it is not necessary to use the -e option.