telecom-security
Assess telecommunications infrastructure security including VoIP/SIP, SS7/Diameter, cellular networks, SMS-based authentication, and telephony-integrated applications. Identifies vulnerabilities in phone-based verification, call routing, and telecom protocol implementations. Use when auditing SMS 2FA, VoIP systems, IVR applications, or any telephony-dependent security controls.
Best use case
telecom-security is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Assess telecommunications infrastructure security including VoIP/SIP, SS7/Diameter, cellular networks, SMS-based authentication, and telephony-integrated applications. Identifies vulnerabilities in phone-based verification, call routing, and telecom protocol implementations. Use when auditing SMS 2FA, VoIP systems, IVR applications, or any telephony-dependent security controls.
Teams using telecom-security should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/telecom-security/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How telecom-security Compares
| Feature / Agent | telecom-security | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Assess telecommunications infrastructure security including VoIP/SIP, SS7/Diameter, cellular networks, SMS-based authentication, and telephony-integrated applications. Identifies vulnerabilities in phone-based verification, call routing, and telecom protocol implementations. Use when auditing SMS 2FA, VoIP systems, IVR applications, or any telephony-dependent security controls.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Telecom Security Audit Skill
## When to Use
Activate this skill when the engagement involves:
- **SMS-based 2FA/MFA** — assessing OTP delivery, SIM swap risk, interception vectors
- **SIP/VoIP infrastructure** — auditing PBX, softphones, SIP trunks, WebRTC gateways
- **IVR systems** — interactive voice response security, DTMF handling, menu traversal
- **Call center authentication** — knowledge-based auth, callback verification, social engineering resistance
- **Telephony APIs** — Twilio, Vonage, Bandwidth, Plivo, Telnyx integration security
- **Cellular security** — baseband, IMSI catchers, roaming, carrier interconnects
- **Carrier-grade infrastructure** — SS7/SIGTRAN, Diameter, GTP, SIM provisioning
## Historical Context
The name **2600** comes from a 2600 Hz tone — the exact frequency that, when played into an AT&T
long-distance trunk line, seized control of the switch. This was in-band signaling: control data
traveled on the same channel as voice, so anyone who could produce the tone could command the network.
- **Blue box**: generated MF (multi-frequency) tones to route calls after seizing a trunk with 2600 Hz
- **Red box**: simulated coin deposit tones on payphones
- **Black box**: manipulated line voltage to prevent billing on incoming calls
The fundamental lesson: **when control signaling shares a channel with user data, users become
operators.** AT&T eventually moved to out-of-band signaling (SS7), but SS7 introduced its own
trust model vulnerability — carriers implicitly trust each other, and that trust is now exploitable
by anyone with an SS7 interconnect.
## Attack Surface Taxonomy
### SS7/MAP (Legacy Signaling)
- **Location tracking**: `SendRoutingInfo` / `ProvideSubscriberInfo` queries reveal cell tower location
- **SMS interception**: `UpdateLocation` re-registers victim to attacker-controlled MSC
- **Call interception**: `InsertSubscriberData` redirects call forwarding
- **Authentication bypass**: obtain IMSI, trigger re-authentication to capture triplets
### Diameter (4G/5G Signaling)
- Roaming scenarios inherit SS7's implicit trust between carriers
- S6a/S6d interfaces expose subscriber data during inter-PLMN handoffs
- Diameter Edge Agents (DEA) provide filtering, but coverage is inconsistent
### SIP/VoIP
- **Registration hijacking**: unauthenticated REGISTER, digest auth brute force
- **Eavesdropping**: RTP without SRTP, SIP without TLS
- **Toll fraud**: compromised endpoints used for premium-rate number dialing
- **Caller ID spoofing**: `From` header trivially set to any value
- **SRTP key negotiation**: SRTP-SDES sends keys in plaintext SDP (use DTLS-SRTP instead)
### SMS/OTP
- **SS7 interception**: redirect SMS at the network level (proven in real attacks)
- **SIM swap**: social engineering carrier support to port number to attacker SIM
- **Smishing**: SMS phishing with shortened/obfuscated URLs
- **OTP interception**: malware with SMS read permission on Android
### IVR/DTMF
- **Brute force**: PIN/account number guessing via rapid DTMF input
- **Menu traversal**: undocumented options, debug menus, operator escape sequences
- **Information disclosure**: reading back account details, SSN, balances without strong auth
- **Recording exposure**: call recordings stored without encryption or access control
### Caller ID / ANI
- **Caller ID (CNAM)**: trivially spoofable — no cryptographic verification in legacy PSTN
- **STIR/SHAKEN**: adds certificate-based attestation but adoption is still incomplete
- **ANI vs Caller ID**: ANI is harder to spoof but not immune in VoIP-to-PSTN transitions
### SIM Security
- **SIM swap**: social engineering carrier reps, insider threats, automated porting attacks
- **SIM cloning**: legacy Comp128v1 vulnerability (historical, mostly patched)
- **eSIM provisioning**: QR code interception, SM-DP+ server compromise
- **SIM toolkit (STK)**: Simjacker-style attacks via crafted OTA SMS
### Telephony APIs
- **Webhook spoofing**: attacker sends fake status callbacks to application endpoints
- **Credential leakage**: API keys/auth tokens in client-side code, logs, or VCS history
- **Rate limiting gaps**: no throttle on verification SMS sends (cost amplification, spam)
- **Number enumeration**: carrier lookup APIs reveal active numbers and carrier info
## Audit Methodology
1. **Enumerate telephony-dependent auth paths**
- Map every flow that uses phone numbers: login, password reset, transaction verification
- Identify which are SMS-only vs. offering TOTP/WebAuthn alternatives
2. **Assess SMS 2FA for known bypass vectors**
- Can an attacker SIM-swap the target? (carrier policy, account PIN, port-out protection)
- Is the application vulnerable if SMS is intercepted? (session fixation, race conditions)
- Are OTPs time-limited and single-use? Are they sufficiently long (6+ digits)?
3. **Test caller ID verification**
- Can a spoofed caller ID bypass IVR authentication?
- Does the system use callback verification for sensitive operations?
- Is STIR/SHAKEN attestation level checked for incoming SIP calls?
4. **Audit VoIP configuration**
- SIP: TLS enabled? Certificate validation? Digest auth or mutual TLS?
- Media: SRTP enforced? DTLS-SRTP or SDES? Key management reviewed?
- Registration: rate limiting on REGISTER? Fail2ban or equivalent?
5. **Review IVR security**
- Lockout after N failed PIN attempts?
- Sensitive data readback requires step-up authentication?
- Debug/admin menus accessible from external callers?
6. **Test telephony API integration**
- Webhook endpoints validate request signatures (e.g., Twilio `X-Twilio-Signature`)?
- Replay protection via timestamp validation?
- API credentials rotated, scoped to minimum permissions?
7. **Assess carrier/provider resilience**
- Single carrier dependency? Failover path?
- Geographic number portability risks?
- Provider SLA and incident response capability?
## Code Review Patterns
Look for these anti-patterns during source review:
```python
# FINDING: SMS as sole second factor — no TOTP/WebAuthn alternative
if user.mfa_method == "sms":
send_otp(user.phone_number) # No fallback offered
# FINDING: Phone number as primary account identifier
user = User.objects.get(phone=request.data["phone"]) # SIM swap = account takeover
# FINDING: Caller ID trusted for authentication
if call.caller_id == expected_number:
grant_access() # Trivially spoofable
# FINDING: SIP credentials in plaintext config
SIP_PASSWORD = "oops-plaintext" # Should use secrets manager
# FINDING: No SRTP — voice traffic sent unencrypted
media_encryption = "none" # Should be "srtp" with DTLS key exchange
# FINDING: Telephony webhook without signature verification
@app.route("/twilio/status", methods=["POST"])
def status_callback():
process(request.form) # No X-Twilio-Signature check
# FINDING: No rate limiting on phone verification endpoint
@app.route("/verify/send", methods=["POST"])
def send_verification():
send_sms(request.json["phone"]) # Unlimited sends = cost amplification
# FINDING: Phone number enumeration via error differences
if not user_exists(phone):
return {"error": "User not found"} # vs. "Invalid credentials"
```
## Remediation Quick Reference
| Issue | Remediation |
|-------|-------------|
| SMS as sole 2FA | Offer TOTP (RFC 6238) or WebAuthn as alternatives |
| SIM swap risk | Enable carrier port-out PIN, number lock, SIM swap detection alerts |
| Caller ID trusted | Never authenticate on caller ID alone; use callback verification |
| SIP without TLS | Enforce TLS 1.2+ for signaling, validate certificates |
| RTP without SRTP | Enforce SRTP with DTLS-SRTP key exchange (not SDES) |
| IVR PIN brute force | Lockout after 3-5 failures, exponential backoff, CAPTCHA for web-initiated calls |
| Webhook spoofing | Validate HMAC signatures, check timestamps, reject replays >5 min |
| Number enumeration | Uniform error responses, rate limit lookup endpoints |
| API key exposure | Use environment variables or secrets manager, rotate regularly, scope permissions |
| No OTP expiry | OTPs expire in 5-10 minutes, single-use, minimum 6 digits |
## Tools Reference
- **SIPVicious** (`sipvicious`): SIP scanning, enumeration, password cracking
- **Ohrwurm**: RTP fuzzer for VoIP
- **Mr.SIP**: SIP-based audit and attack tool
- **SigPloit**: SS7/Diameter/GTP pentesting framework
- **Owasp VoIPAudit**: VoIP security testing methodology
- **Owasp Owasp Telephony cheatsheet**: telephony security reference
- **Owasp Testing Guide**: relevant sections on OTP, 2FA bypass
## Related Skills
- `social-engineering-audit` — SIM swap and call center pretexting vectors
- `entry-point-analyzer` — mapping telephony-dependent authentication surfaces
- `static-security-analyzer` — scanning for hardcoded SIP credentials and API keysRelated Skills
web-security-testing
Web application security testing workflow for OWASP Top 10 vulnerabilities including injection, XSS, authentication flaws, and access control issues.
typo3-security
Security hardening checklist and best practices for TYPO3 v13/v14 installations, covering configuration, file permissions, and common vulnerabilities.
tauri-security-rules
Security-related rules for Tauri application development.
sqlserver-security
Audits and hardens SQL Server security including login management, permission reviews, TDE encryption, SQL Server Audit configuration, and surface area reduction. Use when performing security reviews, setting up new instances, responding to security incidents, or preparing for compliance audits.
spring-security
Spring Security 6 patterns for authentication, authorization, and OAuth2
solidity-security
Master smart contract security best practices to prevent common vulnerabilities and implement secure Solidity patterns. Use when writing smart contracts, auditing existing contracts, or implementin...
software-security-appsec
Modern application security patterns aligned with OWASP Top 10 (2021) and OWASP Top 10:2025 Release Candidate, OWASP API Security Top 10 (2023), NIST SSDF, zero trust, supply chain security, authentication, authorization, input validation, and cryptography.
slack-auth-security
OAuth flows, token management, and security best practices for Slack apps. Use when implementing app distribution, multi-workspace installations, token storage and rotation, managing scopes and permissions, or securing production Slack applications.
securitytrails-automation
Automate Securitytrails tasks via Rube MCP (Composio). Always search tools first for current schemas.
security
Use this skill when designing or reviewing systems where security is a concern - authentication, authorization, data protection, input handling, or any system processing untrusted input. Applies adversarial thinking to specifications, designs, and implementations.
security-workflow
Use when creating backlog tasks from security findings, integrating security scans into workflow states, or managing security remediation tracking. Invoked for security workflow integration and task automation.
security-validation-checklist
Guides security validation checklist: Signal protocol security, encryption standards, authentication patterns, data protection. Use when validating security, reviewing security implementations, or ensuring security compliance.