SigCorr is the first open-source tool to detect cross-protocol attack chains spanning SS7/MAP, Diameter S6a, and GTPv2-C through unified subscriber identity correlation.
Passive Cross-Protocol Attack Detection for Mobile Core Networks
SigCorr is the first open-source tool to detect cross-protocol attack chains spanning SS7/MAP, Diameter S6a, and GTPv2-C through unified subscriber identity correlation.
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 | Attack | Description |
|---|---|---|
| ATK-001 | Silent Location Tracking | SRI followed by PSI to track subscriber |
| ATK-002 | Interception Setup | SRI followed by ISD to redirect calls |
| ATK-006 | Subscriber DoS | CancelLocation + DeleteSubscriberData |
| ATK-011 | SMS Interception | SRI-SM followed by MT-ForwardSM |
| ATK-014 | Auth Vector Harvesting | SRI followed by SendAuthInfo |
| ATK-021 | IMSI Catcher Detection | Rogue UpdateLocation + SendAuthInfo |
| ID | Attack | Description |
|---|---|---|
| ATK-003 | Multi-Protocol Reconnaissance | MAP + Diameter + GTP coordinated attack |
| ATK-005 | Diameter-to-SS7 Downgrade | Diameter AIR failure then MAP fallback |
| ATK-009 | Diameter Recon + GTP Hijack | AIR followed by CreateSession |
| ATK-010 | Diameter Location Hijack | AIR followed by spoofed ULR |
┌─────────────────────────────────────────────────────────────────┐
│ 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
Edit 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
Validates 9 attack patterns against generated pcaps.
# Download public samples first (see test-pcaps/public-samples/DOWNLOAD_GUIDE.md)
bash ./test-pcaps/test_public_samples.sh
Tests against 20+ real-world pcap samples for:
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
Contributions are welcome! Whether it's bug reports, new attack pattern ideas, protocol support, or documentation improvements — all help is appreciated.
git checkout -b feature/new-attack-pattern)git commit -m 'Add ATK-022: new pattern')git push origin feature/new-attack-pattern)Please make sure ./test.sh passes before submitting.
SigCorr is released under the GNU Affero General Public License v3.0 (AGPL-3.0).
This means you are free to use, modify, and distribute SigCorr, including in commercial environments. If you modify SigCorr and make it available over a network (e.g., as a hosted service), you must release your modifications under the same license.
See LICENSE for the full text.
If the AGPL does not work for your use case — for example, if you want to embed SigCorr into a proprietary product or offer it as part of a commercial service without the AGPL's source-sharing requirements — a commercial license is available.
Contact Shreyas S at [email protected] or open a GitHub Issue tagged licensing to discuss.
If you use SigCorr in academic research, please cite:
@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)