3 unstable releases
0.2.0 | Sep 16, 2024 |
---|---|
0.1.1 | Jul 17, 2024 |
0.1.0 | Feb 13, 2024 |
#729 in Cryptography
172 downloads per month
77KB
884 lines
Rust Cryptographic Primitives
This repository contains a collection of cryptographic primitives implemented in Rust. The goal is to provide a comprehensive set of cryptographic primitives that are easy to use and hard to misuse.
This crate was done as a personal project to learn Rust and cryptography, implementing some of the algorithms I learned in the "Secure and Dependable Systems" course at my university. The code is open source and I am happy to receive contributions and feedback. Feel free to open an issue or a pull request on this repository.
If this crate is useful to you, please consider giving it a star on GitHub :)
Features
The crate currently provides the following cryptographic primitives, with an encryption and decryption function for each:
- Rail Fence Cipher
- Route Cipher
- Feistel Network
- Substitution-Permutation Network (SPN)
- Advanced Encryption Standard (AES)
The helpers
module provides the following helper functions for cryptographic algorithms:
rotl8
initialize_aes_sbox
permute
feistel_round_function
kdf
gmix_column
gmix_column_inv
xor_bytes
The constants
module provides some useful constants for cryptographic algorithms, such as:
- a sample
S-Box
- a sample
P-Box
MIX_COLUMNS_LOOKUP_2
,MIX_COLUMNS_LOOKUP_3
,MIX_COLUMNS_LOOKUP_9
,MIX_COLUMNS_LOOKUP_11
,MIX_COLUMNS_LOOKUP_13
,MIX_COLUMNS_LOOKUP_14
lookup tables for the AES MixColumns operation
The block_cipher
module provides the following block cipher modes of operation, with an encryption and decryption function for each:
- Electronic Codebook (ECB) mode
- Cipher Block Chaining (CBC) mode
- Counter (CTR) mode
- Output Feedback (OFB) mode
For any suggestions or requests, feel free to open an issue on this repository.
Usage
Add this to your Cargo.toml
:
[dependencies]
cryptographic_primitives = "0.2.0"
You can also use cargo
to add the dependency to your Cargo.toml
:
cargo add cryptographic_primitives
Then, simply import the crate and use the cryptographic primitives:
use cryptographic_primitives::*;
Example
Here is an example of using the aes_128_encrypt
and aes_128_decrypt
functions to encrypt and decrypt a plaintext using the Electronic Codebook (ECB) mode of operation:
use cryptographic_primitives::{aes_128_decrypt, aes_128_encrypt};
use cryptographic_primitives::block_ciphers::{ecb_encrypt, ecb_decrypt};
let plaintext = b"Hello, World!";
let key = 0x2b7e151628aed2a6abf7158809cf4f3c;
let encrypted = ecb_encrypt(plaintext, key, aes_128_encrypt).unwrap();
let decrypted = ecb_decrypt(&encrypted, key, aes_128_decrypt).unwrap();
assert_eq!(decrypted, plaintext);
License
This project is licensed under the MIT license.
Dependencies
~1.5MB
~34K SLoC