simplecrypto 0.3.0

Simple cryptographic library for hashing and encrypting

Cryptographic library with really simple API.

Includes functions for hashes, symmetric and assymetric crypto, along with helper functions. Acts as a wrapper for PyCrypto and a few standard libraries.

Install:

pip install simplecrypto

Hashes

from simplecrypto import md5, sha1, hash

md5('The quick brown fox jumps over the lazy dog')
# '9e107d9d372bb6826bd81d3542a419d6'

sha1('The quick brown fox jumps over the lazy dog')
# '2fd4e1c67a2d28fced849ee1bb76e7391b93eb12'

# 'hash' defaults to SHA1
hash('message')
# '6f9b9af3cd6e8b8a73c2cdced37fe9f59226e27d'

Symmetric crypto

from simplecrypto import encrypt, decrypt, AesKey

# `encrypt` and `decrypt` use AES-256.

m = encrypt('secret message', 'secret key')
print(m)
# 'uRKa9xX7zW6QT1yJxIQb5E/0DzaxQglVggnFam5K'
decrypt(m, 'secret key')
# b'secret message'

# Generates a new AES-256 random key.
key = AesKey()
m = key.encrypt('secret message')
print(m)
# 'wFTwwaGMMCAsvmQxhmL7ztDksThtWvGm2gy1e2UV'
key.decrypt(m)
# b'secret message'

key = AesKey('secret key') # key from string
key = AesKey(random(32)) # key from bytes

# AES keys can be exported and imported.
open('key', 'wb').write(key.serialize())
new_key = AesKey(open('key', 'rb').read())
print(key == new_key)
# True

Asymmetric crypto

from simplecrypto import RsaKeypair, RsaPublicKey

skey = RsaKeypair(2048)
pkey = skey.publickey

m = pkey.encrypt('secret message')
skey.decrypt(m)
# b'secret message'

s = skey.sign('authenticated message')
pkey.verify('authenticated message', s)
# True

# Long messages are encrypted with a random AES-256 key for performance.
m = pkey.encrypt('long message ' * 100)
skey.decrypt(m)
# b'long message long message long message...'

# RSA keypairs can be exported and imported.
open('key', 'wb').write(skey.serialize())
new_key = RsaKeypair(open('key', 'rb').read())
print(skey == new_key)
# True

# Individual public keys too.
open('key', 'wb').write(pkey.serialize())
new_key = RsaPublicKey(open('key', 'rb').read())
print(pkey == new_key)
# True

Protocol helpers

from simplecrypto import RsaKeypair
from simplecrypto import send, receive

alice = RsaKeypair()
bob = RsaKeypair()
charlie = RsaKeypair()

# Prepares a message from Alice to Bob and Charlie.
# The message is signed and encrypted.
m = send('secret message', alice, bob, charlie)

# Bob opens the message from Alice.
receive(m, bob, alice)
# b'secret message'

# Charlie opens the message from Alice.
receive(m, charlie, alice)
# b'secret message'

# Eve tries to eavesdrop.
eve = RsaKeypair()
receive(m, eve, alice)
# EncryptionError!

And miscellaneous helpers

import simplecrypto

simplecrypto.base64('message')
# 'bWVzc2FnZQ=='

simplecrytpo.from_hex('FF')
# b'\xff'

simplecrypto.pad('short', 10, '.')
# b'short.....'

random(5)
# b'A\xd5\x12\x054'    five random bytes

Last Updates

0.3.0 (2013-12-05)

• Add serialize to RSA keys.

• Allow RSA keys to receive PEM encoded keys in the constructor.

• Implement __repr__ method in base Key class (you can now print keys).

• Split package into modules key, formats, hashes, random and exceptions.

0.2.3 (2013-12-05)

• Update project information (keywords, classifiers, description, etc).

0.2.2 (2013-12-04)

• Add send and receive functions for secure message building.

• Raise EncryptionError instead of generic errors.

• Slightly better test coverage.

0.2.1 (2013-12-03)

• Add base Key class.

• Introduce raw versions of encrypt and decrypt.

• Implemented key printing and comparison.

0.2.0 (2013-12-03)

• Return str from to_base64 and allow from_base64 to receive str.

• Create classes for different key types.

• Change return from to_hex to str for consistency with base64.

• guess_hash function moved to different module.

• Automatically use session keys when encrypting large messages.

0.1.0 (2013-11-26)

• Initial release.