Skip to content

Latest commit

 

History

History
40 lines (24 loc) · 1.98 KB

README.md

File metadata and controls

40 lines (24 loc) · 1.98 KB

OVERVIEW

This git project constitutes a file cloaking utility that provides password-based security of a single file or a single file system archive file (E.g. .tar.gz). The utility is probably most useful in the following situations:

  • Storing backups of sensitive information on the Internet
  • Transporting sensitive information electronically (E.g. email) or manually (E.g. using a flash drive)

This project is already proven running on an Intel/AMD environment (Biostar Celeron CPU motherboard) and the Raspberry Pi 2 (ARM 32-bit processor).

The source code is based on libgcrypt (GnuPG cryptography), using:

  • Password-based Key Derivation Function version 2 (PBKDF2)
  • AES data cryptography in Cipher-Block Chaining (CBC) mode
  • Hash-based Message Authentication Code (HMAC) function SHA512

Reference: https://gnupg.org/documentation/manuals/gcrypt/

Note that you probably already have the run-time libgcrypt shared object library installed. However, to compile the source programs, you will also need the libgcrypt development package (libgcrypt20-dev in the Ubuntu 17.10).

LICENSING

This is NOT commercial software; instead, usage is covered by the GNU General Public License version 3 (2007). In a nutshell, please feel free to use the project and share it as you will but please don't sell it. Thanks!

See the LICENSE file for the GNU licensing information.

GETTING STARTED

Subfolders:

  • src - C-language source code and a Makefile
  • bin - Upon completion of the make utility, this folder holds the cloak and uncloak executables.
  • docs - project documentation (admittedly, skimpy)
  • data - project example data files

The starting point with this project is in the docs/operations.txt file. Also, this note contains for cloaking the sample cleartext data and uncloaking the ciphertext.

Feel free to contact richard.elkins@gmail.com for inquiries and issues, especially if you find any bugs. I'll respond as soon as I can.

Richard Elkins

Dallas, Texas, USA, 3rd Rock, Sol, ...