Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/base4security/dolos-t
Deceptive Operations: Lure, Observe, and Secure Tool
https://github.com/base4security/dolos-t
automation containerization containers containers-as-a-service deception deception-defense deception-technology deceptive-defense deceptive-design docker dockerfiles framework gplv3 honeypot honeytoken network-security open-source orchestrator python3 security
Last synced: about 1 month ago
JSON representation
Deceptive Operations: Lure, Observe, and Secure Tool
- Host: GitHub
- URL: https://github.com/base4security/dolos-t
- Owner: Base4Security
- License: gpl-3.0
- Created: 2024-03-21T17:29:16.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2024-07-17T22:12:33.000Z (5 months ago)
- Last Synced: 2024-10-28T15:55:12.190Z (about 2 months ago)
- Topics: automation, containerization, containers, containers-as-a-service, deception, deception-defense, deception-technology, deceptive-defense, deceptive-design, docker, dockerfiles, framework, gplv3, honeypot, honeytoken, network-security, open-source, orchestrator, python3, security
- Language: Python
- Homepage: https://dolost.readthedocs.io/en/stable/
- Size: 1.66 MB
- Stars: 5
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
DOLOST
Deceptive Operations: Lure, Observe, and Secure Tool
[]()
[](https://badge.fury.io/py/dolost)
[](https://dolost.readthedocs.io/en/latest/?badge=latest)
[](/LICENSE)
[](https://doi.org/10.13140/RG.2.2.34289.29289)
[](https://GitHub.com/Base4Security/DOLOS-T/releases/)
[](https://GitHub.com/Base4Security/DOLOS-T/issues/)
[](https://GitHub.com/Base4Security/DOLOS-T/pull/)
## Table of Contents
- [About](#About)
- [Installation](#Installation)
- [Usage](#Usage)
- [Examples](/examples)
- [Contributing](/CONTRIBUTING.md)
- [License](/LICENSE.md)
## About
DOLOST is a framework designed to automate the creation and deployment of decoys and deceptive environments in the context of cyber deception operations.
It also guides the design of deception operations with a deep understanding of engagement strategies.
## Installation
1. **Ensure Python and Docker are Installed:**
Make sure you have Python 3.7 or later installed on your system and Docker installed on your Decoy's host (it could be the same system you are using right now, just keep it in mind for when you configure DOLOST). You can download and install Python from the official Python website (https://www.python.org/downloads/) and Docker from the official Docker website (https://www.docker.com/get-started).
2. **Install DOLOST Using pip:**
Run the following command to install the project:
```bash
# Python 3.7+ required
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install DOLOST
```
3. **Final Checks:**
Ensure that all required dependencies are installed without any errors. If you encounter any issues during the installation process, refer to the error messages for troubleshooting steps.
## Usage
To use the framework you need to start it with a first definition of the Docker client to connect with.
Here you have an example for DOLOST execution:
```python
import DOLOST
# Available Docker Client configuration:
# - from_env: Will try to use the current environment configuration to reach dockerd.
# - tcp: Will use the provided host and port to reach dockerd.
# - tcp_ssl: Will use the provided host and port + the SSL certificates to reach dockerd using TCP+SSL.
# - socket: Will use the provided socket path to reach dockerd.
# For more detailed information, refer to "Configuring Docker Client" in the Documentation.
dc = {'from_env': True}
# Available Verbosity Levels:
# - TRACE: Provides detailed tracing information.
# - DEBUG: Displays debug messages for troubleshooting.
# - INFO: Provides general information about the execution.
# - WARN: Displays warnings for potential issues.
# - ERROR: Indicates errors that occurred during execution.
# Note: Each verbosity level includes all levels above it. For example,
# setting verbosity to DEBUG will also display INFO, WARN, and ERROR messages.
verbosity = "INFO"
if __name__ == "__main__":
DOLOST.start(verbosity=verbosity, docker_client=dc)
```