mirror of
https://github.com/SHOGGOTH-SECTOR/sica-fondt.git
synced 2026-08-01 08:30:20 +00:00
24f816b6a3
Place useful parts of the surrounding repos into sica-fondt by layer, per the
body model (Ada = membrane; brain/endocrine/capabilities/knowledge non-Ada):
- brain/ LLM reasoning + providers (dapr, hermes, MoMoA)
- capabilities/ REPRAG sidecars: hermes tools/skills, dapr tools, parallel
dispatch, A51 channels, and the OSINT cluster
- knowledge/ LORAG corpus: 754 cyber-skills, agency personas, secure-coding,
MITRE ATT&CK data
- reference/ defensive threat-reference (C3, shhbruh doc) + AdaYaml parser
License handling: AGPL sources (worldosint, advanced_evolution, mercury,
Reticulum) and GPL DeTTECT are SPEC-only clean-room/port descriptions — no
copyleft code copied. MIT/Apache/data parts copied as working trees.
Safety: shhbruh escape/persistence material and C3 covert-C2 kept as reference
only, not wired into the running organism. See CONSOLIDATION.md.
https://claude.ai/code/session_01UehUqEXXJJCsHoA4voCU5c
65 lines
1.6 KiB
Markdown
65 lines
1.6 KiB
Markdown
# API Reference: Detecting Modbus Protocol Anomalies
|
|
|
|
## Modbus Protocol Limits
|
|
|
|
| Parameter | Maximum Value |
|
|
|-----------|--------------|
|
|
| Coil read quantity | 2000 |
|
|
| Register read quantity | 125 |
|
|
| Register write quantity | 123 |
|
|
| Unit ID range | 1-247 |
|
|
| PDU size | 253 bytes |
|
|
|
|
## Anomaly Detection Methods
|
|
|
|
| Anomaly | Detection | Severity |
|
|
|---------|-----------|----------|
|
|
| Timing deviation | Polling interval outside tolerance | MEDIUM-HIGH |
|
|
| Excessive read | Quantity > protocol limits | HIGH |
|
|
| Invalid function code | Not in standard set | HIGH |
|
|
| Modbus scan | >5 unique function codes from source | HIGH |
|
|
| Register range violation | Address outside configured range | MEDIUM |
|
|
|
|
## Zeek Modbus Log Fields
|
|
|
|
```
|
|
#fields ts uid id.orig_h id.orig_p id.resp_h id.resp_p func exception quantity
|
|
```
|
|
|
|
## Suricata Modbus Rules
|
|
|
|
```
|
|
alert modbus any any -> any 502 (msg:"Modbus Invalid Function Code"; \
|
|
modbus: function !1,!2,!3,!4,!5,!6,!15,!16; sid:4000001;)
|
|
alert modbus any any -> any 502 (msg:"Modbus Excessive Register Read"; \
|
|
modbus: function 3; modbus: quantity > 125; sid:4000002;)
|
|
```
|
|
|
|
## Scapy Modbus Analysis
|
|
|
|
```python
|
|
from scapy.contrib.modbus import ModbusADURequest
|
|
from scapy.all import rdpcap
|
|
|
|
pkts = rdpcap("modbus.pcap")
|
|
for pkt in pkts:
|
|
if pkt.haslayer(ModbusADURequest):
|
|
print(f"FC={pkt.funcCode} Len={pkt.len}")
|
|
```
|
|
|
|
## Baseline Monitoring
|
|
|
|
```python
|
|
# Expected polling behavior
|
|
expected_interval = 1.0 # seconds
|
|
tolerance = 0.5
|
|
# Alert if interval < 0.5s or > 3.0s
|
|
```
|
|
|
|
## CLI Usage
|
|
|
|
```bash
|
|
python agent.py --modbus-log modbus.log
|
|
python agent.py --modbus-log modbus.log --expected-interval 2.0
|
|
```
|