emdneto / aestoolbox

An AES Toolbox for computing the Rijndael Key Schedule for a 128, 192, or 256-bit key.

AES-Toolbox

An AES Toolbox for computing Rijndael key schedule given a 128, 192, or 256-bit key.

• Documentation: https://aestoolbox.readthedocs.io.

Features

• AES Key Schedule
• AES Encrypt/Decrypt (work in progress)

Installation

shell

Stable release via pip

To install AES-Toolbox, run this command in your terminal:

$ pip install aestoolbox

If you don't have pip installed, this Python installation guide can guide you through the process.

Get from source

The sources for AES-Toolbox can be downloaded from the Github repo. This is the preferred method to install AES-Toolbox, as it will always install the most recent stable release.

You can either clone the public repository:

$ git clone git://github.com/emdneto/aestoolbox

Or download the tarball:

$ curl -OJL https://github.com/emdneto/aestoolbox/tarball/master

Once you have a copy of the source, you can install it with:

$ python setup.py install

Using AES-Toolbox

Usage (via CLI)

$ aes-schedule [-h] [-v] [-i] key
$ aes-schedule 0x0101010102020202030303030404040 -i -v

The above command should output:

{'xk': 
{0: '0x01010101020202020303030304040404',
1: '0xf2f3f3f3f0f1f1f1f3f2f2f2f7f6f6f6',
2: '0xb2b1b19b4240406ab1b2b2984644446e',
3: '0xadaa2ec1efea6eab5e58dc33181c985d',
4: '0x39ec626cd6060cc7885ed0f4904248a9',
5: '0x05beb10cd3b8bdcb5be66d3fcba42596',
6: '0x6c812113bf399cd8e4dff1e72f7bd471',
7: '0x0dc98206b2f01ede562fef3979543b48',
8: '0xad2bd0b01fdbce6e49f4215730a01a1f',
9: '0x568910b44952deda00a6ff8d3006e592',
10: '0x0f505fb04602816a46a47ee776a29b75'},

'xki': 
{0: '0x01010101020202020303030304040404',
 1: '0xfdfafef8fff8fcfafcfbfff9f8fffbfd',
 2: '0xc263931b3d9b6fe1c1609018399f6be5',
 3: '0x70e738474d7c57a68c1cc7beb583ac5b',
 4: '0xa68450a9ebf8070f67e4c0b1d2676cea',
 5: '0xb86800d6539007d93474c768e613ab82',
 6: '0xffd917eeac491037983dd75f7e2e7cdd',
 7: '0xe238ed774e71fd40d64c2a1fa86256c2',
 8: '0xc20b68478c7a95075a36bf18f254e9da',
 9: '0x7edace11f2a05b16a896e40e5ac20dd4',
 10: '0x0f505fb04602816a46a47ee776a29b75'}}

Usage as Python Library

Soon

Disclaimer

AES-Toolbox implementations should not be used in security software or production environments. The AES-Toolbox is for research purposes.

aestoolbox's Issues

Fix README.rst

Deploy to pypi as python package

Configure black, pyflake and .pre-commit-config

Configure travisci

Fix docs

Write tests for aes_schedule.py

Change docs theme and host under readthedocs

Fix Coverage

Fix dev requirements

Write docs

Write AES_192 key scheduling tests

Fix __init__.py files

Write AES-256 key scheduling tests

Create aes_decrypt

Create aes_encrypt for blocks

Write AES-128 Inverse Key Schedule tests

Design a args wrapper

We need a common wrapper for args to be reused by future components:
So, we need to parse args from:

• aes-schedule
• aes-cipher