# gobysec/goby architecture

> Architecture diagram of the GitHub repository gobysec/goby, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gobysec/goby
- Repository: https://github.com/gobysec/goby

## Overview

Goby is a desktop network-security assessment tool. Its documented workflow is to run network scans against a target enterprise, identify its attack surface, assess exposed vulnerabilities, and potentially use those findings to penetrate the intranet. The README also describes rule- and protocol-based recognition, port categories, and weak-password checks. No implementation files or source excerpts were provided, so the graph reflects documented capabilities only; edges show README-stated relationships, not inferred internal calls.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assessment["Assessment workflow"]
  node_goby["Goby tool"]
  node_nic["Network interface"]
  node_attack_surface["Attack surface"]
end

subgraph group_recognition["Recognition capabilities"]
  node_rule_engines["Rule recognition"]
  node_protocol_engines["Protocol recognition"]
  node_port_groups["Port categories"]
  node_vuln_checks["Vulnerability checks"]
  node_weak_passwords["Weak-password checks"]
end

subgraph group_exploitation["Exposure response"]
  node_intranet["Company intranet"]
end

node_operator(("Security operator"))
node_target["Target enterprise"]

node_operator -->|"uses"| node_goby
node_goby -->|"requires permission"| node_nic
node_goby -->|"scans"| node_target
node_goby -->|"maps"| node_attack_surface
node_goby -->|"recognizes assets"| node_rule_engines
node_goby -->|"recognizes protocols"| node_protocol_engines
node_goby -->|"groups ports"| node_port_groups
node_goby -->|"checks vulnerabilities"| node_vuln_checks
node_goby -->|"checks credentials"| node_weak_passwords
node_goby -->|"may penetrate"| node_intranet

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_goby,node_nic,node_attack_surface toneBlue
class node_rule_engines,node_protocol_engines,node_port_groups,node_vuln_checks,node_weak_passwords toneAmber
class node_intranet toneMint
class node_operator,node_target toneIndigo
```

## Components

### Assessment workflow

- **Goby tool**
- **Network interface**
- **Attack surface**

### Recognition capabilities

- **Rule recognition**
- **Protocol recognition**
- **Port categories**
- **Vulnerability checks**
- **Weak-password checks**

### Exposure response

- **Company intranet**

### Other components

- **Security operator**
- **Target enterprise**

## Connections

- Security operator → Goby tool: uses (evidence: `README.md`)
- Goby tool → Network interface: requires permission (evidence: `README.md`)
- Goby tool → Target enterprise: scans (evidence: `README.md`)
- Goby tool → Attack surface: maps (evidence: `README.md`)
- Goby tool → Rule recognition: recognizes assets (evidence: `README.md`)
- Goby tool → Protocol recognition: recognizes protocols (evidence: `README.md`)
- Goby tool → Port categories: groups ports (evidence: `README.md`)
- Goby tool → Vulnerability checks: checks vulnerabilities (evidence: `README.md`)
- Goby tool → Weak-password checks: checks credentials (evidence: `README.md`)
- Goby tool → Company intranet: may penetrate (evidence: `README.md`)
