Trapster Daemon
Project description
Trapster Community
Trapster Community is a low-interaction honeypot designed to be deployed on internal networks. It is built to monitor and detect suspicious activities, providing a deceptive layer to network security.
Visit the Trapster website to learn more about our commercial product, which includes advanced features like pre-configured hardened OS, automatic deployment, webhook, and SIEM integration.
Features
- Deceptive Security: Mimics network services to lure and detect potential intruders.
- Asynchronous Framework: Utilizes Python's
asyncio
for efficient, non-blocking operations. - Configuration Management: Easily configurable through
trapster.conf
. - Expandable Services: Add and configure as many services as needed with minimal effort.
Installation
To install Trapster, clone the repository and use setup.py
to install the dependencies:
git clone https://github.com/0xBallpoint/trapster-community/
cd trapster
python -m venv venv
source ./venv/bin/activate
python setup.py install
Usage
Configuration
Trapster uses a configuration file located at data/trapster.conf
. Ensure the configuration file is correctly set up before running the daemon.
You can add as many services as you want, even mutliple services of the same type.
You should also change the interface
name, Trapster uses that to discover the IP address it should bind to. On linux, you can type ifconfig
or ip a
.
Running the Daemon
After installation, to start the Trapster daemon, simply use the trapster command inside your folder:
trapster
In development mode, you can use the main script:
python3 main.py
Log format
Each module can generates up to four types of logs: connection
, data
, login
, and query
.
connection
: Indicates that a connection has been made to the module.data
: Represents raw data that has been sent, logged in HEX format. This data is unprocessed.login
: Captures login attempts to the module. The data field is in JSON format and contains processed information.query
: Logs data that has been processed and does not correspond to an authentication attempt. The data field is in JSON format and contains processed information.
Contributing
Contributions are welcome! Please follow these steps:
- Fork the repository.
- Create a new branch (git checkout -b feature-branch).
- Make your changes.
- Commit your changes (git commit -m 'Add new feature').
- Push to the branch (git push origin feature-branch).
- Create a pull request.
License
Trapster is licensed under the GNU Affero General Public License v3 or later (AGPLv3+). See the LICENSE file for more details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for trapster-1.0.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 12401b80fbf636f5e307e72f121c5adb8872edccf7358d05841d0d4b6fe01b1d |
|
MD5 | b55e9ff7d2d32e3e3efda461f7e1a10f |
|
BLAKE2b-256 | 78fe83dcdfbd8e4b02a1305f9c6f2f80c8c584e591169fdee5d54671bbe44037 |