Charles-CSEC
Charles-CSEC copied to clipboard
aniko33
CSEC is a client-based encrypted chat. allows you to avoid network sniffing or an attack done directly from the server. it is easy to use and modify and is available on Linux, Windows, Mac.
Charles CSEC
Index
-
Features
-
Installation
-
Configuration (server-side)
-
Commands (client-side)
-
Running
-
How does it work
-
Showcase
-
Bug report
-
License
-
Contributors
Features
-
RSA encryption
-
Easy to read code
-
Protected by network sniffer
-
File upload with Anonfile
-
No trace of your IP
Installation
From source code
You need to have Python and PIP installed which you can download from your package manager or site.
After installing Python and PIP you need to install program dependencies. You can with this command:
git clone https://github.com/aniko33/Charles-CSEC && cd Charles-CSEC
Then, you will need to install python dependencies:
pip install -r requirements.txt
After you installed the various dependencies, now you can customise your configurations your server or start your client.
From the compiled version
You have to go to the latest releases and you have to download the client or the server depending on what you want to do.
Important note
If you have installed the server version, create a file named config.json and set the default configurations.
Configuration
To configure your server, open the config.json file in the following path: server/config.json.
Scroll to the top and edit this part:
{
"ip": "127.0.0.1",
"port": 8889,
"buffer": 1024,
"welcome_message": "[red]welcome to <chat name>[/red]",
"protected_by_password": false,
"password": "P4ssw0rd"
}
| Variable | Description |
|---|---|
| ip | The IP address where the server will start listening for connections |
| port | The connection port, it is recommended to keep it default (8889) |
| buffer | The maximum network buffer, changes in this value affects the RSA key lenght |
| welcome_message | Welcome message to new users, the colors can be found in the Rich documentation |
| protected_by_password | You can enter true if you want to protect your chat by password or you can put false |
| password | Enter the password you want |
Commands
-
/helpshow command list -
/nickget your nickname -
/upload <path>upload file with Anonfile, usage:/upload /home/user/file.txt
Running
To run the program just go to the main folder and execute this command:
Client
cd client && python main.py
Server
cd server && python main.py
How does it work
The keys are generated using the RSA Encryption Algorithm.
when the client wants to send a message, it gets encrypted with the public key, through the server then will forward it to the connected clients, that will decrypt it using the private key.
For more detailed explanation, please, refer to the RSA Encryption Algorithm Documentation
Showcase
Bug report
To report an exploit or a bug write, create a new issue
License
This application is distributed under the GPL license you can consult the file: LICENSE.txt
aniko33