https://github.com/1solon/as2-aes-encryption
This is a simple implementation of the Rijndael-AES encryption algorithm in C.
https://github.com/1solon/as2-aes-encryption
aes assignment c
Last synced: 2 months ago
JSON representation
This is a simple implementation of the Rijndael-AES encryption algorithm in C.
- Host: GitHub
- URL: https://github.com/1solon/as2-aes-encryption
- Owner: 1Solon
- Created: 2024-04-02T16:35:50.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-13T22:08:49.000Z (about 2 years ago)
- Last Synced: 2025-10-07T04:59:36.174Z (9 months ago)
- Topics: aes, assignment, c
- Language: Python
- Homepage:
- Size: 44.9 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## AS2-AES-Encryption
_Assignment to build a Rijndael-AES implementation in c_
## What is this?
This is a simple implementation of the Rijndael-AES encryption algorithm in C. The library exposes two functions:
```c
unsigned char *aes_encrypt_block(unsigned char *plaintext, unsigned char *key);
unsigned char *aes_decrypt_block(unsigned char *ciphertext, unsigned char *key);
```
The `aes_encrypt_block` function takes a 16-byte plaintext block and a 16-byte key, and returns a 16-byte ciphertext block. The `aes_decrypt_block` function takes a 16-byte ciphertext block and a 16-byte key, and returns a 16-byte plaintext block.
## Usage
To use the library, simply include the `libRijndael_lib.so` or `rijndael.h` header file in your project and link against the `rijndael` library.
**Note: this project is intended as an example only, DO NOT EVER USE SELF-BUILT CRYPTO IN A REAL PROJECT.**
## Building
To build the library, run the following commands:
```bash
cmake . -DCMAKE_EXPORT_COMPILE_COMMANDS=1 && make
```
This will generate the `libRijndael_lib.so` shared library in the `build` directory.
## Testing
To run the tests, run the following command:
```bash
pytest
```
If you do not have `pytest` installed, you can install it by running:
```bash
pip install pytest
```
## DevContainer
This project includes a `devcontainer.json` file for use with Visual Studio Code. To use the devcontainer, simply open the project in Visual Studio Code and click the "Reopen in Container" button that appears in the bottom right corner of the window.
## Acknowledgements
This project makes heavy use of examples from these links, which were invaluable in understanding the Rijndael-AES algorithm:
* [Wikipedia](https://en.wikipedia.org/wiki/Advanced_Encryption_Standard)
* [GeeksForGeeks](https://www.geeksforgeeks.org/advanced-encryption-standard-aes/)
* [Sam Trenholme's C implementation](http://www.samiam.org/key-schedule.html)
* [m3y54m](https://github.com/m3y54m/aes-in-c/blob/main/src/main.c)
For testing, I used the test vectors from the [NIST Cryptographic Algorithm Validation Program](https://csrc.nist.gov/projects/cryptographic-algorithm-validation-program/block-ciphers#AES).
I also used [ircmaxell](https://github.com/ircmaxell/quality-checker/blob/master/tmp/gh_18/PHP-PasswordLib-master/test/Data/Vectors/aes-ecb.test-vectors)'s tests