mirror of
https://github.com/SHOGGOTH-SECTOR/sica-fondt.git
synced 2026-08-01 16:40:24 +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
62 lines
1.6 KiB
Markdown
62 lines
1.6 KiB
Markdown
# API Reference: Performing DNS Tunneling Detection
|
|
|
|
## scapy (DNS Packet Analysis)
|
|
|
|
```python
|
|
from scapy.all import rdpcap, DNS, DNSQR, DNSRR, sniff
|
|
|
|
# Read from PCAP
|
|
packets = rdpcap("traffic.pcap")
|
|
for pkt in packets:
|
|
if pkt.haslayer(DNSQR):
|
|
qname = pkt[DNSQR].qname.decode()
|
|
qtype = pkt[DNSQR].qtype # 1=A, 16=TXT, 28=AAAA
|
|
|
|
# Live capture
|
|
def dns_callback(pkt):
|
|
if pkt.haslayer(DNSQR):
|
|
print(pkt[DNSQR].qname)
|
|
|
|
sniff(filter="udp port 53", prn=dns_callback, count=100)
|
|
```
|
|
|
|
## Shannon Entropy Calculation
|
|
|
|
```python
|
|
import math
|
|
from collections import Counter
|
|
|
|
def shannon_entropy(data):
|
|
counter = Counter(data)
|
|
length = len(data)
|
|
return -sum((c/length) * math.log2(c/length)
|
|
for c in counter.values())
|
|
|
|
# Normal domain: ~2.5-3.5 bits
|
|
# DNS tunnel: ~4.0-5.0 bits
|
|
```
|
|
|
|
## DNS Tunneling Indicators
|
|
|
|
| Indicator | Threshold | Rationale |
|
|
|-----------|-----------|-----------|
|
|
| Subdomain entropy | > 3.8 | Encoded/encrypted data |
|
|
| Query length | > 50 chars | Payload in subdomain |
|
|
| TXT queries/domain | > 20/hour | Data channel |
|
|
| Unique subdomains | > 50/parent | Encoded sessions |
|
|
| Digit ratio | > 0.4 | Base64/hex encoding |
|
|
|
|
## Common DNS Tunnel Tools
|
|
|
|
| Tool | Encoding | Record Types |
|
|
|------|----------|-------------|
|
|
| iodine | Base128 | NULL, TXT, CNAME |
|
|
| dnscat2 | Hex/CNAME | TXT, MX, CNAME |
|
|
| dns2tcp | Base64 | TXT, KEY |
|
|
|
|
### References
|
|
|
|
- scapy: https://scapy.readthedocs.io/en/latest/
|
|
- DNS tunneling detection: https://www.sans.org/white-papers/dns-tunneling/
|
|
- iodine: https://github.com/yarrick/iodine
|