<p align="center">
<br/>
<a href="https://trapster.cloud">trapster.cloud</a>
ยท
<a href="https://ballpoint.fr/">ballpoint.fr</a>
</p>
<div align="center">
<img src="./logo.png" height="200">
</div>
# 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](https://trapster.cloud) 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:
```bash
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:
```bash
trapster
```
In development mode, you can use the main script:
```bash
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:
1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Make your changes.
4. Commit your changes (git commit -m 'Add new feature').
5. Push to the branch (git push origin feature-branch).
6. 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.
Raw data
{
"_id": null,
"home_page": "https://trapster.cloud/",
"name": "trapster",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "trapster, honeypot, ballpoint, deceptive, security, network",
"author": "0xBallpoint",
"author_email": "contact@ballpoint.fr",
"download_url": "https://files.pythonhosted.org/packages/02/cb/b8e1ba93ded65068634b1a867b92633d7472065e9f36080446ec2036011a/trapster-1.0.8.tar.gz",
"platform": "linux",
"description": "<p align=\"center\">\n <br/>\n <a href=\"https://trapster.cloud\">trapster.cloud</a>\n \u00b7\n <a href=\"https://ballpoint.fr/\">ballpoint.fr</a>\n</p>\n<div align=\"center\">\n<img src=\"./logo.png\" height=\"200\">\n</div>\n\n\n# Trapster Community\n\n\n\n\n\nTrapster 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.\n\nVisit the [Trapster website](https://trapster.cloud) to learn more about our commercial product, which includes advanced features like pre-configured hardened OS, automatic deployment, webhook, and SIEM integration.\n\n## Features\n\n- **Deceptive Security**: Mimics network services to lure and detect potential intruders.\n- **Asynchronous Framework**: Utilizes Python's `asyncio` for efficient, non-blocking operations.\n- **Configuration Management**: Easily configurable through `trapster.conf`.\n- **Expandable Services**: Add and configure as many services as needed with minimal effort.\n\n## Installation\n\nTo install Trapster, clone the repository and use `setup.py` to install the dependencies:\n\n```bash\ngit clone https://github.com/0xBallpoint/trapster-community/\ncd trapster\npython -m venv venv\nsource ./venv/bin/activate\npython setup.py install\n```\n\n## Usage\n\n### Configuration\nTrapster uses a configuration file located at `data/trapster.conf`. Ensure the configuration file is correctly set up before running the daemon.\nYou can add as many services as you want, even mutliple services of the same type.\n\nYou 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`.\n\n### Running the Daemon\n\nAfter installation, to start the Trapster daemon, simply use the trapster command inside your folder:\n```bash\ntrapster\n```\nIn development mode, you can use the main script:\n```bash\npython3 main.py\n```\n\n## Log format\n\nEach module can generates up to four types of logs: `connection`, `data`, `login`, and `query`.\n* `connection`: Indicates that a connection has been made to the module.\n* `data`: Represents raw data that has been sent, logged in HEX format. This data is unprocessed.\n* `login`: Captures login attempts to the module. The data field is in JSON format and contains processed information.\n* `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.\n\n## Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch (git checkout -b feature-branch).\n3. Make your changes.\n4. Commit your changes (git commit -m 'Add new feature').\n5. Push to the branch (git push origin feature-branch).\n6. Create a pull request.\n\n## License\n\nTrapster is licensed under the GNU Affero General Public License v3 or later (AGPLv3+). See the LICENSE file for more details.\n\n",
"bugtrack_url": null,
"license": "AGPL3",
"summary": "Trapster Daemon",
"version": "1.0.8",
"project_urls": {
"Homepage": "https://trapster.cloud/"
},
"split_keywords": [
"trapster",
" honeypot",
" ballpoint",
" deceptive",
" security",
" network"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "39a03d3a83e632b9037a7e90a80bbd46ea40a3534a8617d6c27b3d96a230a6fd",
"md5": "c52b100b9cfdfa39826c37768c1f26d5",
"sha256": "793d6778d282963aa06f2693ccc15366928a111dff92d41b4aa995de1a119774"
},
"downloads": -1,
"filename": "trapster-1.0.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c52b100b9cfdfa39826c37768c1f26d5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 147900,
"upload_time": "2024-06-11T17:36:08",
"upload_time_iso_8601": "2024-06-11T17:36:08.846293Z",
"url": "https://files.pythonhosted.org/packages/39/a0/3d3a83e632b9037a7e90a80bbd46ea40a3534a8617d6c27b3d96a230a6fd/trapster-1.0.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "02cbb8e1ba93ded65068634b1a867b92633d7472065e9f36080446ec2036011a",
"md5": "f0bab9a5f0cbf4d1d9964d215db6a03e",
"sha256": "8625315736c09b852e52f72ab08a7a8e80f7143ad59c8494ee82776bb775e8ad"
},
"downloads": -1,
"filename": "trapster-1.0.8.tar.gz",
"has_sig": false,
"md5_digest": "f0bab9a5f0cbf4d1d9964d215db6a03e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 141974,
"upload_time": "2024-06-11T17:36:10",
"upload_time_iso_8601": "2024-06-11T17:36:10.643661Z",
"url": "https://files.pythonhosted.org/packages/02/cb/b8e1ba93ded65068634b1a867b92633d7472065e9f36080446ec2036011a/trapster-1.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-11 17:36:10",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "trapster"
}
JSON