Skip to content

Commit

Permalink
fix: update docs to remove redundancy
Browse files Browse the repository at this point in the history
- update logger in extension.md
- remove redundant stuff in README and add readthedocs link
- update FAQs
  • Loading branch information
furusiyya committed Mar 4, 2025
1 parent 9d64fdf commit 617dc74
Show file tree
Hide file tree
Showing 3 changed files with 13 additions and 39 deletions.
44 changes: 8 additions & 36 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,41 +2,13 @@
![Tests](https://github.com/mushorg/glutton/actions/workflows/workflow.yml/badge.svg)
[![GoDoc](https://godoc.org/github.com/mushorg/glutton?status.svg)](https://godoc.org/github.com/mushorg/glutton)

Setup `go 1.21`.
Glutton is a protocol-agnostic, low-interaction honeypot that intercepts network traffic and logs interactions to help analyze malicious activities. It's built using Golang and leverages iptables and TPROXY to redirect all traffic to specific protocol handlers.

Install required system packages:
## Documentation
For more details, please read the [documentation](https://go-glutton.readthedocs.io/en/latest/), which provides the following sections:

Debian:
```
apt-get install gcc libpcap-dev iptables
```

Arch:
```
pacman -S gcc libpcap iptables
```

Fedora:
```
sudo dnf install gcc libpcap-devel iptables
```

Build glutton:
```
make build
```

To run/test glutton:
```
sudo bin/server
```

To get this to work on WSL, use this kernel: https://github.com/Locietta/xanmod-kernel-WSL2

### Setting up the Dev Container environment with VS Code

Since this project requires a Linux environment to build and run, you need to use a Docker container on other operating systems. For development, we recommend using the Dev Container Extension for VS Code.

First, install the Dev Container extension. To learn more about setting up and using dev containers, check out the following resources:
- [Install Dev Container](https://code.visualstudio.com/docs/devcontainers/containers)
- [Learn More](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
* [Introduction](https://go-glutton.readthedocs.io/en/latest/)
* [Setup](https://go-glutton.readthedocs.io/en/latest/setup/)
* [Configuration](https://go-glutton.readthedocs.io/en/latest/configuration/)
* [Extension](https://go-glutton.readthedocs.io/en/latest/extension/)
* [FAQs](https://go-glutton.readthedocs.io/en/latest/faq/)
3 changes: 1 addition & 2 deletions docs/extension.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,6 @@ Glutton is built to be easily extensible. Developers can add new protocol handle

import (
"context"
"log"
"net"
"github.com/mushorg/glutton/connection"
Expand All @@ -30,7 +29,7 @@ Glutton is built to be easily extensible. Developers can add new protocol handle
// HandleNewProtocol handles incoming connections.
func HandleNewProtocol(ctx context.Context, conn net.Conn, md connection.Metadata, logger interfaces.Logger, h interfaces.Honeypot) error {
// Log the connection for demonstration purposes.
log.Printf("Received NewProtocol connection from %s", conn.RemoteAddr().String())
logger.Info("Received NewProtocol connection from %s", conn.RemoteAddr().String())
// Here you could add protocol-specific handling logic.
// For now, simply close the connection.
return conn.Close()
Expand Down
5 changes: 4 additions & 1 deletion docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,11 @@

### Q: How do I configure Glutton?
**A:** Configuration is managed through YAML files:

- **config/config.yaml:** General settings such as port numbers and interface names.
- **config/rules.yaml:** Defines rules for matching and processing network traffic.

See the [Configuration](configuration.md) section for detailed instructions.

### Q: What are the system prerequisites?
**A:** Glutton requires a Linux system, so if you're using a different OS, you'll have to use Docker to set it up. Specific installation commands are provided in the [Setup](setup.md) section.
**A:** Glutton requires a Linux system, so if you're using a different OS, you'll have to use Docker to set it up. Specific installation commands are provided in the [Setup](setup.md) section.

0 comments on commit 617dc74

Please sign in to comment.