7 releases
0.1.6 | May 22, 2024 |
---|---|
0.1.5 | May 8, 2024 |
#801 in Cryptography
43KB
710 lines
Easydes
Encrypt with DES easily in Rust.
This is a Rust library that implements the DES cryptographic algorithm.
Running
easydes --help
easydes <VERSION>
Encrypt and decrypt with DES.
USAGE:
easydes [OPTIONS] --key <KEY> --infile <INPATH> <-e|-d>
OPTIONS:
-3, --triple_des Encrypt/Decrypt using Triple DES.
-d Decrypt
-e Encrypt
-h, --help Print help information
-i, --iv <IV> Encryption/Decryption IV. Only used in CBC.
--infile <INPATH> Specify the path to the input file.
-k, --key <KEY> Encryption/Decryption key
-m <MODE> Specify the mode. Default is ECB which doesn't require an IV.
[default: ECB] [possible values: ECB, CBC]
--outfile <OUTPATH> Specify the path to the output file.
-v Enable verbose logging
-V, --version Print version information
Example
To encrypt a file, run
easydes --key 133457799BBCDFF1 --iv 0000000000000000 -m CBC -e --infile tests/infile.txt --outfile output.enc
To decrypt this file, you can run
easydes --key 133457799BBCDFF1 --iv 0000000000000000 -m CBC -d --infile output.enc --outfile plaintext.txt
Triple DES
To encrypt a file with Triple DES, run
easydes -3 --key 133457799BBCDFF111111111111111112222222222222222 --iv 1111111111111111 -m CBC -e --infile tests/infile.txt --outfile output.enc
To decrypt this file, you can run
easydes -3 --key 133457799BBCDFF111111111111111112222222222222222 --iv 1111111111111111 -m CBC -d --infile output.enc --outfile clear.txt; cat clear.txt
Build
To build the binary with cargo, run
cargo build --release
Using the library
By including the crate with
use easydes::easydes::*;
you can use the DES functions in your own library. For example
let plaintext: &str = "HelloWorldHelloWorld";
let key: [u8; 8] = [0x13, 0x34, 0x57, 0x79, 0x9B, 0xBC, 0xDF, 0xF1];
let iv: [u8; 8] = [0x01 as u8; 8];
let mut ciphertext = easydes::des_cbc(
&key,
&iv,
&mut plaintext.as_bytes().to_vec(),
easydes::Des::Encrypt,
);
println!("{:#02x?}", ciphertext);
let mut plaintext_again: Vec<u8> =
easydes::des_cbc(&key, &iv, &mut ciphertext, easydes::Des::Decrypt);
Tests
Please see TESTING.md.
License
Please read LICENSE.md.
Dependencies
~1.5MB
~25K SLoC