Alex-Devera/tpotce
1
0
Fork 0
mirror of https://github.com/telekom-security/tpotce.git synced 2025-10-14 04:19:14 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Update README.md

Browse source
This commit is contained in:
Domenico Del Giudice 2025-03-03 16:20:29 +01:00 committed by GitHub
parent da5d9b5c10
commit eef292172a
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 24 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
README.md
View file

@ -110,18 +110,22 @@ To get things up and running just follow these steps:
```sh ```sh
git clone https://github.com/domedg/tpotce_MacOS/ git clone https://github.com/domedg/tpotce_MacOS/
``` ```
3. Go to repo folder: 3. Go to repo folder:
```sh ```sh
cd tpotce_MacOS/ cd tpotce_MacOS/
``` ```
4. Copy the docker configuration file 4. Copy the docker configuration file
```sh ```sh
cp compose/mac_win.yml ./docker-compose.yml cp compose/mac_win.yml ./docker-compose.yml
``` ```
5. Check if the script `genuser.sh` is executable, if is not run: 5. Check if the script `genuser.sh` is executable, if is not run:
```sh ```sh
chmod 777 genuser.sh chmod 777 genuser.sh
``` ```
6. Create a `WEB_USER` by running `./genuser.sh` <br> 6. Create a `WEB_USER` by running `./genuser.sh` <br>
If the `WEB_USER` is not properly set, check [Issue 5: WEB_USER Not Loaded](#issue-5-web_user-not-loaded). If the `WEB_USER` is not properly set, check [Issue 5: WEB_USER Not Loaded](#issue-5-web_user-not-loaded).
@ -129,7 +133,9 @@ To get things up and running just follow these steps:
```sh ```sh
sed -i '' 's/^TPOT_OSTYPE=linux$/TPOT_OSTYPE=mac/' .env sed -i '' 's/^TPOT_OSTYPE=linux$/TPOT_OSTYPE=mac/' .env
``` ```
8. You have to ensure on your own there are no port conflicts keeping T-Pot from starting up. Check the [list of required ports](https://github.com/telekom-security/tpotce?tab=readme-ov-file#required-ports). 8. You have to ensure on your own there are no port conflicts keeping T-Pot from starting up. Check the [list of required ports](https://github.com/telekom-security/tpotce?tab=readme-ov-file#required-ports).
9. To start T-Pot run: 9. To start T-Pot run:
``` ```
docker compose up docker compose up
@ -139,7 +145,9 @@ To get things up and running just follow these steps:
docker compose up -d docker compose up -d
``` ```
Before starting T-Pot, make sure Docker is running on your system. Before starting T-Pot, make sure Docker is running on your system.
10. During the first time running `docker-compose up`, you may encounter some issues. Check the [Installation Issues](#installation-issues) section to solve them. 10. During the first time running `docker-compose up`, you may encounter some issues. Check the [Installation Issues](#installation-issues) section to solve them.
11. To Stop T-Pot press: `CTRL-C` (it if was running in the foreground) and / or `docker compose down -v` to stop T-Pot entirely. 11. To Stop T-Pot press: `CTRL-C` (it if was running in the foreground) and / or `docker compose down -v` to stop T-Pot entirely.
**Update T-Pot:** **Update T-Pot:**
@ -456,17 +464,32 @@ conpot_local_kamstrup_382:
```sh ```sh
docker exec -it --user root <container_id> /bin/sh docker exec -it --user root <container_id> /bin/sh
``` ```
7. **Prune Unused Networks**: If you encounter network issues, you can remove all unused networks with the following command: 7. **Prune Unused Networks**: If you encounter network issues, you can remove all unused networks with the following command:
```sh ```sh
docker network prune docker network prune
``` ```
This command will prompt for confirmation before deleting all unused networks. This command will prompt for confirmation before deleting all unused networks.
8. **Restart Containers**: Sometimes, simply restarting the containers can resolve issues. You can do this by bringing the containers down and then up again: 8. **Restart Containers**: Sometimes, simply restarting the containers can resolve issues. You can do this by bringing the containers down and then up again:
```sh ```sh
docker-compose down && docker-compose up docker-compose down && docker-compose up
``` ```
This command stops and removes the containers, then recreates and starts them. This command stops and removes the containers, then recreates and starts them.
9. **Monitor Ports with lsof**: To check which process is using a specific port, use:
```sh
sudo lsof -i :<port>
```
This command lists the process ID (PID) and other details of the process using the specified port.
10. **Monitor Ports with netstat**: To list all listening ports and the associated processes, use:
```sh
sudo netstat -tulpn
```
This command provides a detailed view of all TCP and UDP ports in use, along with the corresponding process IDs and names.
--- ---
<a name="testing-conpot"></a> <a name="testing-conpot"></a>
@ -515,8 +538,6 @@ python3 start.py
3. **Result on Kibana dashboard:** 3. **Result on Kibana dashboard:**
<img width="1188" alt="kibana_dash" src="https://github.com/user-attachments/assets/de9c841b-830d-42d9-b778-61c270cc9c8c" /> <img width="1188" alt="kibana_dash" src="https://github.com/user-attachments/assets/de9c841b-830d-42d9-b778-61c270cc9c8c" />
<br>
<br>
<br> <br>
### **Brute force attack examples using Hydra:** ### **Brute force attack examples using Hydra:**