{"id":664,"date":"2012-04-07T19:45:37","date_gmt":"2012-04-07T19:45:37","guid":{"rendered":"http:\/\/joelinoff.com\/blog\/?p=664"},"modified":"2018-08-22T01:14:44","modified_gmt":"2018-08-22T08:14:44","slug":"c-class-that-interfaces-to-openssl-ciphers","status":"publish","type":"post","link":"https:\/\/joelinoff.com\/blog\/?p=664","title":{"rendered":"C++ class that interfaces to OpenSSL ciphers"},"content":{"rendered":"

I have developed a class named Cipher<\/a> that allows you to encrypt and decrypt files or strings using the OpenSSL AES-256-CBC cipher and SHA1 digest algorithms. It is interoperable with the openssl<\/code> command line tool which makes it a good introduction to using OpenSSL for ciphers.<\/p>\n

The project has been moved to github: https:\/\/github.com\/jlinoff\/openssl-aes-cipher<\/a>. The latest version is 1.3. It has been updated to work with the opaque contexts that were introduced in openssl-1.1.<\/p>\n

I am re-releasing version 1.2 into the public domain on 2013-11-21 because I wish that I had found something like it when I was starting out with OpenSSL.
\n<\/p>\n

\n\n\n\n\n\n\n\n
Release<\/th>\nDate<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
1.2<\/td>\n2013-11-21<\/td>\nFixed the problem reported by Mihai Todor at line 300 in cipher.cc<\/code>.<\/td>\n<\/tr>\n
1.1<\/td>\n2012-09-22<\/td>\nFixed a valgrind problem at line 298 in cipher.cc as reported by an anonymous user.<\/td>\n<\/tr>\n
1.0<\/td>\n2012-02-14<\/td>\nInitial release with source links corrected as reported by nvanwyen.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

1 Downloads<\/h1>\n

You can download the source code in the following formats:<\/p>\n

\n\n\n\n\n\n\n\n
File<\/th>\nSize<\/th>\nCheck Sum<\/th>\nUncompress Command<\/th>\n<\/tr>\n<\/thead>\n
cipher-1.2.tar.bz2<\/a><\/td>\n15K<\/td>\n17148<\/td>\ntar jxf cipher-1.2.tar.bz2<\/td>\n<\/tr>\n
cipher-1.2.tar.gz<\/a><\/td>\n16K<\/td>\n29380<\/td>\ntar zxf cipher-1.2.tar.gz<\/td>\n<\/tr>\n
cipher-1.2.zip<\/a><\/td>\n19K<\/td>\n1134<\/td>\nunzip cipher-1.2.zip<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

2 Build and Test<\/h1>\n

To build and test the project type make<\/code>. You must have the openssl headers installed.<\/p>\n

    \n
  1. On CentOS you can install the openssl headers by running “yum install openssl-devel<\/code>“.<\/li>\n
  2. On cygwin you must download the openssl development package.<\/li>\n
  3. On Ubuntu you can install it by running “apt-get install openssl libssl-dev<\/code>“.<\/li>\n<\/ol>\n

    It uses the g++ compiler and has been tested on CentOS 5.5, CentOS 6.4, Ubuntu 11.04, cygwin and Mac OS X 10.9.<\/p>\n

    2.1 Source Files<\/h2>\n

    Here is the list of source files.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n
    File<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    a.h<\/td>\nDoxygen main-page.<\/td>\n<\/tr>\n
    cipher.cc<\/td>\nClass implementation.<\/td>\n<\/tr>\n
    cipher.h<\/td>\nClass interface.<\/td>\n<\/tr>\n
    ct.cc<\/td>\nTool that allows you to use the class.<\/td>\n<\/tr>\n
    doxygen.cfg<\/td>\nDoxygen configuration file.<\/td>\n<\/tr>\n
    Makefile<\/td>\nMakefile.<\/td>\n<\/tr>\n
    test.cc<\/td>\nTester.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    3 ct<\/h1>\n

    Once it is built there will be a tool called ct.exe. It uses the Cipher class to allow you to encrypt and decrypt files and strings. Type .\/ct.exe -h<\/code> to get information about how to use the tool.<\/p>\n

    3.1 Example<\/h2>\n

    The following example shows how to use the ct program.
    \n[crayon lang=”bash” toolbar=”always” title=”Run ct”]
    \n% # Encrypt stdin to stdout
    \n% echo ‘Lorem ipsum dolor sit amet’ | .\/ct.exe -e
    \nU2FsdGVkX19nxmlzUf9K7K0Z40ZlovVWSfndp4VHLKSl9j5FXuvHi7dz08nVDsrV
    \n% # Decrypt stdin to stdout
    \n% echo U2FsdGVkX19nxmlzUf9K7K0Z40ZlovVWSfndp4VHLKSl9j5FXuvHi7dz08nVDsrV \\
    \n| .\/ct.exe -d
    \nLorem ipsum dolor sit amet
    \n[\/crayon]<\/p>\n

    3.2 Help<\/h2>\n

    Here is the program help.
    \n[crayon lang=”bash” toolbar=”always” title=”Help”]
    \nNAME
    \nct – Cipher tool that used to encrypt or decrypt files.<\/p>\n

    SYNOPSIS
    \nct [OPTIONS]<\/p>\n

    DESCRIPTION
    \nEncrypt or decrypt a file.<\/p>\n

    OPTIONS
    \n-c Count of number of init rounds.<\/p>\n

    -C The name of the cipher to use (ex. aes-256-cbc).<\/p>\n

    –d Decrypt.<\/p>\n

    -D The name of the digest to use (ex. sha1).<\/p>\n

    –debug Turn on internal debugging.<\/p>\n

    –e Encrypt.<\/p>\n

    -h This help message.<\/p>\n

    -i Input file.<\/p>\n

    -o Output file.<\/p>\n

    -p Passphrase.<\/p>\n

    -s Salt as a string.<\/p>\n

    -x Salt as hex digits (16)..<\/p>\n

    -v Increase the level of verbosity.<\/p>\n

    -V Print the version number and exit.<\/p>\n

    EXAMPLES
    \n% # Help
    \n% .\/ct.exe -h<\/p>\n

    % # Encrypt stdin to stdout
    \n% echo ‘Lorem ipsum dolor sit amet’ | .\/ct.exe -e
    \nU2FsdGVkX19nxmlzUf9K7K0Z40ZlovVWSfndp4VHLKSl9j5FXuvHi7dz08nVDsrV<\/p>\n

    % # Decrypt stdin to stdout
    \n% echo U2FsdGVkX19nxmlzUf9K7K0Z40ZlovVWSfndp4VHLKSl9j5FXuvHi7dz08nVDsrV | .\/ct.exe -d
    \nLorem ipsum dolor sit amet<\/p>\n

    % # Encrypt a file
    \n% # It is okay to reference the same file.
    \n% .\/ct.exe -e -p ‘Tally Ho!’ -i foo.txt -o foo.txt<\/p>\n

    % # Decrypt a file
    \n% # It is okay to reference the same file.
    \n% .\/ct.exe -d -p ‘Tally Ho!’ -i foo.txt -o foo.txt<\/p>\n

    AUTHOR
    \nJoe Linoff
    \n[\/crayon]<\/p>\n

    Enjoy!<\/p>\n","protected":false},"excerpt":{"rendered":"

    I have developed a class named Cipher that allows you to encrypt and decrypt files or strings using the OpenSSL AES-256-CBC cipher and SHA1 digest algorithms. It is interoperable with the openssl command line tool which makes it a good introduction to using OpenSSL for ciphers. The project has been moved to github: https:\/\/github.com\/jlinoff\/openssl-aes-cipher. The … Continue reading C++ class that interfaces to OpenSSL ciphers<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0},"categories":[37,5],"tags":[],"_links":{"self":[{"href":"https:\/\/joelinoff.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/664"}],"collection":[{"href":"https:\/\/joelinoff.com\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/joelinoff.com\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/joelinoff.com\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/joelinoff.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=664"}],"version-history":[{"count":40,"href":"https:\/\/joelinoff.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/664\/revisions"}],"predecessor-version":[{"id":1757,"href":"https:\/\/joelinoff.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/664\/revisions\/1757"}],"wp:attachment":[{"href":"https:\/\/joelinoff.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=664"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/joelinoff.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=664"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/joelinoff.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=664"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}