# simplerhacking/ss7-vulnerability-research-and-tutorial architecture

> Architecture diagram of the GitHub repository simplerhacking/ss7-vulnerability-research-and-tutorial, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/simplerhacking/ss7-vulnerability-research-and-tutorial
- Repository: https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial

## Overview

This repository is a written SS7 vulnerability research tutorial, not an executable system. Its reader-facing flow introduces SS7’s network architecture and weaknesses, explains documented attack mechanisms, then describes their consequences and incidents. The graph represents those documented concepts and relationships, not an implemented attack pipeline. No source excerpts or separate mitigation workflow are available in the supplied material.

Main entry points: [`README.md`](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md) (SS7 Network)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_network["SS7 Foundations"]
  node_ss7["SS7 Network<br/>[README.md]"]
  node_network_roles["Network Elements<br/>[README.md]"]
  node_protocol_stack["Protocol Stack<br/>[README.md]"]
  node_trust_weaknesses["Trust Weaknesses<br/>[README.md]"]
  node_sigtran["SIGTRAN Exposure<br/>[README.md]"]
end

subgraph group_attacks["Attack Mechanisms"]
  node_location_tracking["Location Tracking<br/>[README.md]"]
  node_subscriber_data[("Subscriber Location Data<br/>[README.md]")]
  node_call_sms_redirection["Call and SMS Redirection<br/>[README.md]"]
  node_routing_info["Routing Information<br/>[README.md]"]
  node_message_manipulation["Message Manipulation<br/>[README.md]"]
  node_signaling_disruption["Signaling Disruption<br/>[README.md]"]
end

subgraph group_impacts["Impacts and Incidents"]
  node_fraud["Revenue Share Fraud<br/>[README.md]"]
  node_sms_otp["SMS OTP Theft<br/>[README.md]"]
  node_surveillance["Surveillance<br/>[README.md]"]
  node_service_outages["Service Outages<br/>[README.md]"]
  node_incidents["Reported Incidents<br/>[README.md]"]
end

node_reader(("Reader"))
node_attacker(("Attacker"))

node_reader -->|"learns about"| node_ss7
node_ss7 -->|"includes"| node_network_roles
node_ss7 -->|"uses"| node_protocol_stack
node_ss7 -->|"has"| node_trust_weaknesses
node_sigtran -->|"widens access to"| node_ss7
node_attacker -->|"exploits"| node_location_tracking
node_location_tracking -->|"requests and obtains"| node_subscriber_data
node_attacker -->|"manipulates routing for"| node_call_sms_redirection
node_call_sms_redirection -->|"uses"| node_routing_info
node_attacker -->|"sends spoofed messages"| node_message_manipulation
node_message_manipulation -->|"can cause"| node_signaling_disruption
node_attacker -->|"generates traffic for"| node_fraud
node_call_sms_redirection -->|"enables"| node_sms_otp
node_attacker -->|"uses SS7 for"| node_surveillance
node_signaling_disruption -->|"can cause"| node_service_outages
node_reader -->|"reviews"| node_incidents

click node_ss7 "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_network_roles "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_protocol_stack "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_trust_weaknesses "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_sigtran "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_location_tracking "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_subscriber_data "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_call_sms_redirection "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_routing_info "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_message_manipulation "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_signaling_disruption "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_fraud "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_sms_otp "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_surveillance "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_service_outages "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"
click node_incidents "https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md"

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_ss7,node_network_roles,node_protocol_stack,node_trust_weaknesses,node_sigtran toneBlue
class node_location_tracking,node_subscriber_data,node_call_sms_redirection,node_routing_info,node_message_manipulation,node_signaling_disruption toneAmber
class node_fraud,node_sms_otp,node_surveillance,node_service_outages,node_incidents toneMint
class node_reader,node_attacker toneIndigo
```

## Components

### SS7 Foundations

- [SS7 Network](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Network Elements](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Protocol Stack](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Trust Weaknesses](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [SIGTRAN Exposure](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`

### Attack Mechanisms

- [Location Tracking](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Subscriber Location Data](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Call and SMS Redirection](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Routing Information](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Message Manipulation](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Signaling Disruption](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`

### Impacts and Incidents

- [Revenue Share Fraud](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [SMS OTP Theft](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Surveillance](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Service Outages](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`
- [Reported Incidents](https://github.com/simplerhacking/ss7-vulnerability-research-and-tutorial/blob/main/README.md): `README.md`

### Other components

- **Reader**
- **Attacker**

## Connections

- Reader → SS7 Network: learns about (evidence: `README.md`)
- SS7 Network → Network Elements: includes (evidence: `README.md`)
- SS7 Network → Protocol Stack: uses (evidence: `README.md`)
- SS7 Network → Trust Weaknesses: has (evidence: `README.md`)
- SIGTRAN Exposure → SS7 Network: widens access to (evidence: `README.md`)
- Attacker → Location Tracking: exploits (evidence: `README.md`)
- Location Tracking → Subscriber Location Data: requests and obtains (evidence: `README.md`)
- Attacker → Call and SMS Redirection: manipulates routing for (evidence: `README.md`)
- Call and SMS Redirection → Routing Information: uses (evidence: `README.md`)
- Attacker → Message Manipulation: sends spoofed messages (evidence: `README.md`)
- Message Manipulation → Signaling Disruption: can cause (evidence: `README.md`)
- Attacker → Revenue Share Fraud: generates traffic for (evidence: `README.md`)
- Call and SMS Redirection → SMS OTP Theft: enables (evidence: `README.md`)
- Attacker → Surveillance: uses SS7 for (evidence: `README.md`)
- Signaling Disruption → Service Outages: can cause (evidence: `README.md`)
- Reader → Reported Incidents: reviews (evidence: `README.md`)
