encwork 1.0.3

RSA-encrypted communication software written in Python.

Encwork

RSA-encrypted communication software written in Python.

What is it for?

Encwork is designed to be a safe communication system that will generate new keys for each session. It can be used for CLI's or command line tools, general networking that should be encrypted, or throwaway chats.

How is it secured?

Encwork uses 4096-bit long RSA keys for every message, other than for the public key exchange, which cannot be encrypted.
This should not be a problem, as no computer can get the private key from the public key, and the keys are recreated for every new session.

How does it work?

P2P

Each machine will set up a server socket, and a client socket. The client will try to connect to a specified target, while the server accepts connections and checks if the origin is the target. If it's not, it'll kill the connection and wait for the target to connect. Once both peers have confirmed the targets, they will exchange public keys and be ready to communicate.

Server-Based

There will be one machine running a server, and multiple clients can connect to it. The server talks to each client individually, but Encwork provides enough freedom that you could set up a system that allows users to talk to each other. The server will store all client's public keys & sockets in a dictionary, so all clients still have different keys that don't cross paths.

Requirements

Python v3.6+
If you don't already have it, download it here.
cryptography>=2.8
Download it using pip install "cryptography>=2.8", or download the wheel here and use pip install (.whl file).

Installation

PyPI

To get the module through PyPi: pip install encwork.

GitHub (Pulled Repo)

To install the module by pulling the repo: python setup.py install.

Usage

While Encwork comes with demonstration files such as p2p_example.py, client_example.py and server_example.py, they are only meant to demonstrate how Encwork works. You can get the module to build your own UI that will work with any other program that uses Encwork, including the example one.

The p2p_example.py file

Run it as any other python script, using python or python3 p2p_example.py. It's a very short piece of code, as it just uses functions from encwork.p2p. Simply give it a target machine and it'll start trying to connect.
Once you see the prompt "Enter a message to send," the connection and key exchange have completed and you are ready to communicate.

The client_example.py and server_example.py files

As explained above, one machine will run the server (server_example.py) and allow clients to connect to it (client_example.py). The example files are for a server that returns ping, for one- and two-way, including encryption/decryption in the time.

Documentation

To see how to use the Encwork module yourself, check out the Documentation.