gnukek 1.0.0b3

Kinetic Effective Key

KEK

Kinetic Encryption Key

---

This library provides symmetric, asymmetric (public key), hybrid (symmetric + asymmetric) encryption.

It was build using cryptography library and has uncomplicated interface.

Algorithms:

• AES in CBC mode (128-256 bit)

• RSA (2048-4096 bit)

---

Read the documentation on ReadTheDocs!

---

Installation

Use the package manager pip to install KEK.

pip install gnukek

Usage

Import key objects:

from KEK.hybrid import PrivateKEK, PublicKEK

To generate key:

private_key = PrivateKEK.generate()

To generate public key object:

public_key = private_key.public_key

To encrypt data:

encrypted = public_key.encrypt(b"byte data")

You can also encrypt data using private key object: private_key.encrypt()

To decrypt data:

decrypted = private_key.decrypt(encrypted) # b"byte data"

To sign data:

data = b"byte data"
signature = private_key.sign(data) 

To verify signature:

public_key.verify(signature, data) # True

Both private and public keys can be serialized in PEM encoded PKCS8 format:

serialized_key = private_key.serialize()
loaded_private_key = PrivateKEK.load(serialized_key)

Hybrid encryption

How it works?

• Ecryption:

  • Data is encrypted via fresh generated symmetric key.

  • Symmetric key is encrypted via public asymmetric key.

• Decryption:

  • Symmetric key is decrypted via private asymmetric key.

  • Data is decrypted via loaded symmetric key.

Encrypted data consists of:

• Key id

• Encrypted symmetric key

• Data encrypted via symmetric key

• Key version

License

GPLv3 license