SigCorr è il primo strumento open-source per rilevare catene di attacco cross-protocollo che coinvolgono SS7/MAP, Diameter S6a e GTPv2-C tramite la correlazione unificata dell'identità dell'abbonato.
Rilevamento passivo di attacchi cross-protocollo per reti mobili core
SigCorr è il primo strumento open-source a rilevare catene di attacchi cross-protocollo che coinvolgono SS7/MAP, Diameter S6a e GTPv2-C tramite la correlazione unificata dell'identità del subscriber.
git clone https://github.com/sage-s11/sigcorr.git
cd sigcorr
mvn clean package -DskipTests
java -jar target/sigcorr-0.1.0.jar analyze capture.pcap
./test.sh
| ID | Attacco | Descrizione |
|---|---|---|
| ATK-001 | Localizzazione silenziosa | SRI seguito da PSI per tracciare il subscriber |
| ATK-002 | Configurazione di intercettazione | SRI seguito da ISD per reindirizzare le chiamate |
| ATK-006 | DoS del subscriber | CancelLocation + DeleteSubscriberData |
| ATK-011 | Intercettazione SMS | SRI-SM seguito da MT-ForwardSM |
| ATK-014 | Raccolta di vettori di autenticazione | SRI seguito da SendAuthInfo |
| ATK-021 | Rilevamento IMSI Catcher | UpdateLocation + SendAuthInfo illegittimi |
| ID | Attacco | Descrizione |
|---|---|---|
| ATK-003 | Ricognizione multi-protocollo | Attacco coordinato MAP + Diameter + GTP |
| ATK-005 | Downgrade da Diameter a SS7 | Fallimento AIR su Diameter e successivo fallback su MAP |
| ATK-009 | Ricognizione Diameter + dirottamento GTP | AIR seguito da CreateSession |
| ATK-010 | Dirottamento della posizione Diameter | AIR seguito da ULR spoofato |
┌─────────────────────────────────────────────────────────────────┐
│ SigCorr │
├─────────────────────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ SS7/MAP │ │ Diameter │ │ GTPv2-C │ │
│ │ Parser │ │ Parser │ │ Parser │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │
│ └────────────┬────┴────────────────┘ │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ Identity Resolver │ IMSI ↔ MSISDN correlation │
│ └──────────┬──────────┘ │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ Correlation Engine │ Temporal windowing │
│ └──────────┬──────────┘ │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ Pattern Matcher │ 22 attack signatures │
│ └──────────┬──────────┘ │
│ ▼ │
│ ALERTS │
└─────────────────────────────────────────────────────────────────┘
════════════════════════════════════════════════════════════════
SigCorr v0.1.0 - Cross-Protocol Signaling Security Correlator
════════════════════════════════════════════════════════════════
Analyzing: full_multi_protocol_attack.pcap
Events decoded:
SS7/MAP: 2
Diameter: 2
GTPv2-C: 1
Total: 5
Alerts:
ALERT[CRITICAL] ATK-001 | Silent Location Tracking
subscriber=IMSI:234101234567890
confidence=95%
events=2
ALERT[CRITICAL] ATK-003 | Multi-Protocol Reconnaissance
subscriber=IMSI:234101234567890
confidence=90%
cross-protocol=true
events=5
Summary: 2 alerts generated
Modifica sigcorr-config.yaml:
sigcorr:
tshark:
path: /usr/bin/tshark
timeout: 30s
correlation:
temporal_window: 30s
inference_window: 10s
detection:
min_confidence: 70
enabled_patterns:
- ATK-001
- ATK-002
- ATK-003
# ... or 'all'
output:
evidence_dir: ./evidence
extract_pcap: true
./test.sh
Valida 9 pattern di attacco su pcap generati.
# Download public samples first (see test-pcaps/public-samples/DOWNLOAD_GUIDE.md)
bash ./test-pcaps/test_public_samples.sh
Esegue test su oltre 20 campioni pcap reali per:
sigcorr/
├── src/main/java/io/sigcorr/
│ ├── core/ # Core models (SignalingEvent, SubscriberIdentity)
│ ├── ingest/ # Protocol parsers (TsharkBridge)
│ ├── correlation/ # Identity resolution, temporal windowing
│ └── detection/ # Attack patterns, alerting
├── test-pcaps/
│ ├── attack-samples/ # Generated attack pcaps
│ ├── public-samples/ # Real-world validation samples
│ └── generate_*.py # Pcap generators
├── evidence/ # Extracted evidence pcaps (runtime)
├── pom.xml
├── sigcorr-config.yaml
└── test.sh
I contributi sono benvenuti! Che si tratti di segnalazioni di bug, idee per nuovi pattern di attacco, supporto di protocolli o miglioramenti alla documentazione — ogni aiuto è apprezzato.
git checkout -b feature/new-attack-pattern)git commit -m 'Add ATK-022: new pattern')git push origin feature/new-attack-pattern)Assicurati che ./test.sh venga eseguito senza errori prima di inviare.
SigCorr è rilasciato sotto la GNU Affero General Public License v3.0 (AGPL-3.0).
Ciò significa che sei libero di usare, modificare e distribuire SigCorr, anche in ambienti commerciali. Se modifichi SigCorr e lo rendi disponibile tramite rete (ad esempio come servizio hostato), devi rilasciare le tue modifiche sotto la stessa licenza.
Vedi LICENSE per il testo completo.
Se l'AGPL non è adatta al tuo caso d'uso — ad esempio, se vuoi incorporare SigCorr in un prodotto proprietario o offrirlo come parte di un servizio commerciale senza gli obblighi di condivisione del codice sorgente dell'AGPL — è disponibile una licenza commerciale.
Contatta Shreyas S all'indirizzo [email protected] oppure apri una GitHub Issue con tag licensing per discuterne.
Se utilizzi SigCorr nella ricerca accademica, cita:
@software{sigcorr2025,
author = {Shreyas S},
title = {SigCorr: Passive Cross-Protocol Attack Detection for Mobile Core Networks},
year = {2025},
url = {https://github.com/sage-s11/sigcorr},
doi = {10.5281/zenodo.19439509}
}
Shreyas S (GitHub: @sage-s11)