
Ensemble d'outils pour auditer les systèmes VoIP basés sur SIP.
<center><img src="https://assets.kitploit.com/production/public/readmes/43212/6eee71d2f1e4d138db0d22382ca5a1f07e559d06c8ba6257179156199bdb8d47/88ff772aec8502903eb55970a1f2c4a9f02b189a5a2d10516482a8a9c32f5763-display-v1.webp" alt="logo" width="300"></center>
# Qu'est-ce que Sippts ? #
Sippts est un ensemble d'outils permettant d'auditer des serveurs et des appareils VoIP utilisant le protocole SIP. Sippts est programmé en Python et permet de vérifier la sécurité d'un serveur VoIP utilisant le protocole SIP.
# Est-ce gratuit ? #
Oui. Vous pouvez librement l'utiliser, le modifier et le distribuer. Si vous le modifiez, veuillez inclure une référence à ce site.
# Sippts peut-il être utilisé à des fins illégales ? #
Le but de cet outil est d'auditer vos propres systèmes ou d'effectuer des tests d'intrusion sur des systèmes pour lesquels vous avez reçu une autorisation expresse. Je ne suis pas responsable du mauvais usage de cet outil.
# Utilisation #
Afficher l'aide :
```
sippts -h
usage: sippts [-h] [-up] {video,astami,scan,exten,rcrack,send,enumerate,leak,ping,invite,dump,dcrack,flood,sniff,spoof,pcapdump,rtpbleed,rtcpbleed,rtpbleedflood,rtpbleedinject} ...
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⣀⣀⣀⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣄⣀⣀⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⣤⠤⠶⠒⠛⠉⠉⠉⠉⠀⠀⢀⣀⣀⣀⣤⣤⣤⣤⣤⣤⣤⣤⣬⣍⣙⣳⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣤⠴⠒⠋⠉⠀⠀⠀⢀⣀⣠⡤⠴⠖⠚⠛⠉⠉⠉⠀⣠⡶⠖⠲⣄⠀⠀⠀⠀⠀⠀⠀⠈⠉⢷⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⡤⠖⠋⠁⠀⠀⠀⣀⣤⠴⠖⣛⣉⣁⠀⠀⠀⠀⠀⠀⠀⣀⣀⣠⡇⢹⡄⠀⠸⡆⠀⠀⠀⠀⠀⠀⠀⠀⠈⢿⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⣀⡤⠞⠋⠀⠀⠀⢀⣠⠴⠚⠋⠁⠀⠀⡿⡏⠀⠈⣧⣤⠴⠖⠚⠛⠉⠉⠳⢄⡀⠀⣧⠀⠀⢷⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⣷⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⢠⡞⠧⣄⠀⢀⣠⠴⠚⠉⠀⠀⠀⠀⠀⢀⣴⠇⢹⠀⠀⢸⡆⠀⠀⠀⠀⠀⠀⠀⠀⠉⣲⣿⣀⣠⣼⣦⣤⣀⣀⣀⡀⠀⢀⣀⣠⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⢀⡿⠀⠀⠈⣿⠉⠀⠀⠀⠀⠀⠀⠙⢄⣰⠏⠀⠀⠘⡇⠀⠀⣇⢀⣀⡤⠤⠖⠒⠛⠉⠉⠉⣁⣀⠀⠀⠀⠉⠙⠛⢿⣿⡛⠛⠛⢻⡟⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⣸⣧⣄⠀⠀⡇⠀⠀⠀⠀⠀⠀⠀⠀⢈⣿⡄⠀⠀⠀⣷⠴⠚⠋⠉⠀⠀⢀⣠⣴⡖⠛⠉⠿⢻⣿⣉⡉⠙⠓⢲⠦⢤⣈⠙⢶⣶⠋⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⢠⣏⠙⢦⣹⣼⠀⠀⠀⠀⠀⠀⢀⣴⣾⠟⠁⢀⡏⢀⡞⠀⠀⠀⠀⠀⣰⣯⡟⡀⠀⣼⡏⢘⡢⢠⣷⣾⡿⠿⠿⣷⣤⣞⠀⠙⢦⡀⠀⠙⢿⣷⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⣰⡟⠿⡍⢷⢀⡇⠀⠀⠀⠀⠀⠀⠀⣠⣾⠏⣧⠀⢀⡞⠁⠀⠀⠀⠀⢠⡴⠋⠛⠻⣧⣤⡶⢿⡹⡟⠛⢯⣉⣿⢾⣧⣄⡈⠙⠲⢝⣷⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⢠⣏⠙⢦⣹⣼⠀⠀⠀⠀⠀⠀⢀⣴⣾⠟⠁⢀⡏⢀⡞⠀⠀⠀⠀⠀⣰⣯⡟⡀⠀⣼⡏⢘⡢⢠⣷⣾⡿⠿⠿⣷⣤⣞⠀⠙⢦⡀⠀⠙⢿⣷⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ SIPPTS version 4.1.2 (updated)
⣿⣍⡓⣄⣿⣧⣤⣤⣤⣶⣶⠿⠟⠋⠀⠀⣠⣎⣠⠎⠘⢄⠀⠀⠀⢀⡏⠛⠙⠋⢸⠋⠧⠤⠗⣾⢻⠁⠀⠀⠀⠀⠈⠻⡳⡀⠀⠙⢦⠀⣠⡹⡟⣦⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀ CVE version 0.1 (updated)
⣷⣤⣙⢾⣿⣭⡉⠉⠉⠁⠀⠀⣀⣠⠴⠚⠉⠉⠀⠀⠀⠈⠳⡀⠀⠘⣧⣤⢀⠀⢸⡶⣏⠙⣦⠹⡜⢦⡀⠀⠀⠀⠀⢀⡇⣿⣶⣶⣾⣿⣥⡇⠹⡌⠻⣄⠀⠀⠀⠀⠀⠀⠀⠀ https://github.com/Pepelux/sippts
⣿⠤⢬⣿⣇⠈⢹⡟⠛⠛⠛⠉⠉⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⢆⠀⢻⡹⡎⠃⠀⠳⡄⣽⠛⠦⠉⠲⣍⣓⣒⢒⣒⣉⡴⠋⣟⠙⢲⣿⠘⠃⠀⣷⠀⠙⢧⡀⠀⠀⠀⠀⠀⠀by Pepelux - https://twitter.com/pepeluxx
⣿⠶⠒⠺⣿⡀⢸⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⢣⡀⠳⡄⢀⡀⠀⠙⠮⣗⠚⢠⡖⠲⣌⣉⡭⣍⡡⣞⠓⣾⠉⣽⠃⢠⡄⣼⣿⠀⠀⠈⠳⡄⠀⠀⠀⠀⠀
⠸⡟⠉⣉⣻⣧⣼⠿⣦⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⣄⠙⢮⡿⢿⡃⠀⠈⠑⠶⢽⣒⣃⣘⣲⣤⣗⣈⣹⠵⠛⠁⠀⠀⡴⣻⠃⠀⠀⠀⠀⠹⣆⠀⠀⠀⠀
⠀⠹⣯⣁⣠⠼⠿⣿⡲⠿⠷⣤⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⢦⠀⠙⠳⣄⡀⠀⣄⣶⣄⠀⠉⠉⠉⣉⡉⠉⠀⠀⠘⣶⣴⣦⠞⠁⠀⠀⠀⠀⠀⠀⠘⣧⠀⠀⠀
⠀⠀⠘⣧⡤⠖⢋⣩⠿⣶⣤⣈⣙⣷⣤⣀⣠⣤⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⢳⡀⠀⠀⠉⠓⠶⢽⣼⣆⡀⠀⠀⢿⣿⣶⣀⣀⡬⠷⠚⠁⣀⣀⣀⠀⢰⣿⠿⡇⠀⠘⣧⠀⠀
⠀⠀⠀⠀⠙⠾⣏⣤⠞⢁⡞⠉⣿⠋⣹⠉⢹⠀⣿⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠹⡄⠀⠀⠀⠀⠀⠀⠉⠉⠉⠉⠉⠉⠉⠉⠀⣤⣤⣄⠀⣿⠙⢻⠆⠀⠓⢒⣁⡤⠴⠺⡆⠀
⠀⠀⠀⠀⠀⠀⠀⠙⠒⠻⠤⣴⣇⣀⣿⣀⣾⡤⠿⢷⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⣆⠀⠀⠀⠀⠀⣀⣀⡀⠀⢸⠿⢷⡄⠀⣿⣀⡿⠀⢈⣉⡭⠴⠒⠋⠉⠀⠀⠀⠀⢻⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠉⠻⣦⣀⠀⠀⠀⠀⠀⠀⠀⠀⠈⢆⠀⠀⠀⠰⣟⠛⡇⠀⠘⠧⠞⢁⣀⡤⠴⠒⠋⠉⠀⠀⠀⠀⠀⠀⠀⠀⣀⣠⣼⠃
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⠳⣦⣀⠀⠀⠀⠀⠀⠀⠈⢧⠀⠀⠀⠉⢋⣁⡤⠴⠚⠋⠉⠀⠀⠀⠀⠀⠀⠀⢀⣀⣠⣴⠶⠚⠛⠉⢉⣽⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠙⠷⣤⡀⠀⠀⠀⠀⠘⡆⠴⠒⠋⠉⠀⠀ ⢀⣀⣤⠴⠖⠛⠉⠉⠉⠉⠙⠛⠋⠉⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⢛⠷⠦⠀⠀⠀⣿⠀⠀ ⠀⠀⠀⢠⠴⡖⠛⠉⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠙⠷⣤⡀⠀⠘⡆⠴⠒⠋⠉⣤⠴⠖⠛⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⢛⢠⠴⡖⠛⠉⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
-= SIPPTS is a set of tools for auditing VoIP systems based on the SIP protocol =-
Commands:
{video,astami,scan,exten,rcrack,send,enumerate,leak,ping,invite,dump,dcrack,flood,sniff,spoof,pcapdump,rtpbleed,rtcpbleed,rtpbleedflood,rtpbleedinject}
video Animated help
astami Asterisk AMI pentest
scan Fast SIP scanner
exten Search SIP extensions of a PBX
rcrack Remote password cracker
send Send a customized message
enumerate Enumerate methods of a SIP server
leak Exploit SIP Digest Leak vulnerability
ping SIP ping
invite Try to make calls through a PBX
dump Dump SIP digest authentications from a PCAP file
dcrack SIP digest authentication cracking
flood Flood a SIP server
sniff SIP network sniffing
spoof ARP Spoofing tool
pcapdump Extract data from a PCAP file
rtpbleed Detect RTPBleed vulnerability (send RTP streams)
rtcpbleed Detect RTPBleed vulnerability (send RTCP streams)
rtpbleedflood Exploit RTPBleed vulnerability (flood RTP)
rtpbleedinject Exploit RTPBleed vulnerability (inject WAV file)
Options:
-h, --help show this help message and exit
-up Update scripts
Command help:
sippts <command> -h
```
Afficher l'aide de la commande scan :
```
sippts scan -h
usage: sippts scan [-i IP|HOST] [-f FILE] [-r REMOTE_PORT] [-p PROTOCOL]
[-proxy IP:PORT] [-m METHOD] [-d DOMAIN]
[-cd CONTACT_DOMAIN] [-fn FROM_NAME] [-fu FROM_USER]
[-fd FROM_DOMAIN] [-tn TO_NAME] [-tu TO_USER]
[-td TO_DOMAIN] [-ua USER_AGENT] [-ppi PPI] [-pai PAI] [-v]
[-vv] [-nocolor] [-o FILE] [-oi FILE] [-ot FILE] [-oj FILE]
[-ocsv FILE] [-cve] [-th THREADS] [-t TIMEOUT] [-ping]
[-fp] [-random] [-local-ip IP] [-h]
___ ___ ___ ___ _____ ___
/ __|_ _| _ \ _ \_ _/ __| ___ __ __ _ _ _
\__ \| || _/ _/ | | \__ \ (_-</ _/ _` | ' \
|___/___|_| |_| |_| |___/ /__/\__\__,_|_||_|
Module scan is a fast SIP scanner using multithread that can check several IPs and port ranges. It works with UDP, TCP, TLS, WS and WSS protocols.
Target:
-i IP|HOST Host/IP address/network (ex: mysipserver.com | 192.168.0.10 | 192.168.0.0/24)
-f FILE File with several IPs or network ranges
-r REMOTE_PORT Ports to scan. Ex: 5060 | 5070,5080 | 5060-5080 | 5060,5062,5070-5080 | ALL for 1-65535 (default: 5060)
-p, --protocol PROTOCOL
Protocol: udp|tcp|tls|ws|wss|all, or a list like udp,tls,wss (default: udp)
-proxy IP:PORT Use an outbound proxy (ex: 192.168.1.1 or 192.168.1.1:5070)
Headers:
-m METHOD SIP method: options, invite, register (default: options)
-d, --domain DOMAIN SIP Domain or IP address. Ex: my.sipserver.com (default: target IP address)
-cd CONTACT_DOMAIN Domain or IP address for Contact header. Ex: 10.0.1.2
-fn FROM_NAME From Name. Ex: Bob
-fu FROM_USER From User (default: 100)
-fd FROM_DOMAIN From Domain. Ex: 10.0.0.1
-tn TO_NAME To Name. Ex: Alice
-tu TO_USER To User (default: 100)
-td TO_DOMAIN To Domain. Ex: 10.0.0.1
-ua USER_AGENT User-Agent header (default: pplsip)
-ppi PPI P-Preferred-Identity
-pai PAI P-Asserted-Identity
Log:
-v Increase verbosity
-vv Increase more verbosity
-nocolor Show result without colors
-o FILE Save data into a log file
-oi FILE Save IPs into a log file
-ot FILE Save found hosts as ip:port/proto, ready for -f of exten, rcrack and leak
-oj FILE Save results into a JSON file
-ocsv FILE Save results into a CSV file
-cve Show possible CVEs
Other options:
-th THREADS Number of threads (default: 200)
-t, --timeout TIMEOUT
Sockets timeout (default: 5)
-ping Ping host before scan
-fp Try to fingerprinting
-random Randomize target hosts
-local-ip IP Set local IP address (by default try to get it)
-h, --help Show this help
Usage examples:
Searching for SIP services and devices with default ports (5060/udp) on the local network
sippts scan -i 192.168.0.0/24
Extend the port range from 5060 to 5080 and look for UDP, TCP and TLS services
sippts scan -i 192.168.0.0/24 -r 5060-5080 -p all
Load several target IP addresses from a file
sippts scan -f targets.txt
Random scanning for non-sequential scanning of IP ranges
sippts scan -f targets.txt -random
Disguise the tool behind another User-Agent
sippts scan -i 192.168.0.0/24 -ua Grandstream
Scan all ports and protocols of an address range using 500 threads (slow)
sippts scan -f targets.txt -r all -p all -th 500 -ua Grandstream
Typical scanning for large ranges
sippts scan -f targets.txt -r 5060-5080 -p all -th 500 -ua Grandstream -v -fp -o output.txt
Save the hosts found as ip:port/proto, to chain with exten, rcrack or leak
sippts scan -i 192.168.0.0/24 -r 5060-5080 -p all -ot targets.txt
sippts exten -f targets.txt -e 100-200 -oe extens.txt
sippts rcrack -f targets.txt -ef extens.txt -w wordlist.txt
Save the results as JSON or CSV, to process them with another tool
sippts scan -i 192.168.0.0/24 -oj result.json -ocsv result.csv
```
Mettre à jour les scripts :
```
sippts -up
```
# Ensemble d'outils pour les tests d'intrusion sur le protocole SIP #
Vous pouvez obtenir de l'aide sur l'utilisation de cet outil sur https://sippts.seguridadvoip.com ainsi que sur les pages wiki GitHub :
Sippts est un ensemble d'outils pour l'audit des serveurs et appareils VoIP utilisant le protocole SIP. Sippts est programmé en Python et se compose des commandes ou modules suivants :
* _**scan**_ est un scanner multithread rapide pour les services SIP. Il peut vérifier plusieurs adresses IP et plages de ports, et fonctionne sur UDP, TCP, TLS et WebSockets (WS et WSS). [Cliquez ici pour en savoir plus sur la commande scan](https://github.com/Pepelux/sippts/wiki/Command-scan)
* _**exten**_ identifie les extensions sur un serveur SIP. Il indique également si l'extension nécessite une authentification. Il peut vérifier plusieurs adresses IP, et avec -f il lit les cibles depuis un fichier. [Cliquez ici pour en savoir plus sur la commande exten](https://github.com/Pepelux/sippts/wiki/Command-exten)
* _**rcrack**_ est un cracker de mots de passe distant. Il peut tester des mots de passe pour plusieurs utilisateurs sur plusieurs adresses IP, et avec -f il lit les cibles depuis un fichier. [Cliquez ici pour en savoir plus sur la commande rcrack](https://github.com/Pepelux/sippts/wiki/Command-rcrack)
* _**invite**_ vérifie si un serveur nous permet de passer des appels sans authentification. Si le serveur SIP a une mauvaise configuration, il nous permettra de passer des appels vers des numéros externes. Il peut également transférer l'appel vers un second numéro externe. [Cliquez ici pour en savoir plus sur la commande invite](https://github.com/Pepelux/sippts/wiki/Command-invite)
* _**leak**_ exploite la vulnérabilité SIP Digest Leak découverte par Sandro Gauci, qui affecte un grand nombre d'appareils matériels et logiciels. [Cliquez ici pour en savoir plus sur la commande leak](https://github.com/Pepelux/sippts/wiki/Command-leak)
* _**flood**_ envoie des messages illimités à la cible. [Cliquez ici pour en savoir plus sur la commande flood](https://github.com/Pepelux/sippts/wiki/Command-flood)
* _**send**_ envoie un message SIP personnalisé sur UDP, TCP, TLS ou WebSockets (WS et WSS) et analyse la réponse. [Cliquez ici pour en savoir plus sur la commande send](https://github.com/Pepelux/sippts/wiki/Command-send)
* _**enumerate**_ énumère les méthodes disponibles d'un service ou serveur SIP, sur UDP, TCP, TLS ou WebSockets (WS et WSS). [Cliquez ici pour en savoir plus sur la commande enumerate](https://github.com/Pepelux/sippts/wiki/Command-enumerate)
* _**dump**_ extrait les authentifications SIP Digest d'un fichier PCAP. [Cliquez ici pour en savoir plus sur la commande dump](https://github.com/Pepelux/sippts/wiki/Command-dump)
* _**dcrack**_ casse les authentifications digest du protocole SIP. [Cliquez ici pour en savoir plus sur la commande dcrack](https://github.com/Pepelux/sippts/wiki/Command-dcrack)
* _**pcapdump**_ extrait les données SIP et RTP d'un fichier PCAP, et peut enregistrer les flux audio sous forme de fichiers WAV. [Cliquez ici pour en savoir plus sur la commande pcapdump](https://github.com/Pepelux/sippts/wiki/Command-pcapdump)
* _**ping**_ envoie un ping SIP pour vérifier si un serveur ou un appareil est actif. [Cliquez ici pour en savoir plus sur la commande ping](https://github.com/Pepelux/sippts/wiki/Command-ping)
* _**astami**_ scanne et audite l'Asterisk Manager Interface (AMI), et peut exécuter une commande sur ceux où les identifiants fonctionnent. [Cliquez ici pour en savoir plus sur la commande astami](https://github.com/Pepelux/sippts/wiki/Command-astami)
* _**sniff**_ capture le trafic SIP en direct et affiche les messages, les appareils et les authentifications digest qu'il voit. [Cliquez ici pour en savoir plus sur la commande sniff](https://github.com/Pepelux/sippts/wiki/Command-sniff)
* _**spoof**_ est un outil d'ARP spoofing, pour vous placer entre deux appareils et capturer leur trafic. [Cliquez ici pour en savoir plus sur la commande spoof](https://github.com/Pepelux/sippts/wiki/Command-spoof)
* _**video**_ joue une démo animée des workflows habituels : scan vers exten vers rcrack, dump vers dcrack, leak vers dcrack, et spoof vers sniff.
* _**rtpbleed**_ pour exploiter la vulnérabilité RTP Bleed en envoyant des données vers les ports RTP. [Cliquez ici pour en savoir plus sur la commande rtpbleed](https://github.com/Pepelux/sippts/wiki/Command-rtpbleed)
* _**rtcpbleed**_ pour exploiter la vulnérabilité RTP Bleed en envoyant des données vers les ports RTCP. [Cliquez ici pour en savoir plus sur la commande rtcpbleed](https://github.com/Pepelux/sippts/wiki/Command-rtcpbleed)
* _**rtpbleedflood**_ pour exploiter la vulnérabilité RTP Bleed en inondant un port RTP avec un dialogue actif. [Cliquez ici pour en savoir plus sur la commande rtpbleedflood](https://github.com/Pepelux/sippts/wiki/Command-rtpbleedflood)
* _**rtpbleedinject**_ pour exploiter la vulnérabilité RTP Bleed en injectant du trafic RTP. [Cliquez ici pour en savoir plus sur la commande rtpbleedinject](https://github.com/Pepelux/sippts/wiki/Command-rtpbleedinject)
## Certificats TLS ##
sippts parle TLS, et jusqu'à présent il jetait le certificat. Avec
`-tlsinfo`, le module `scan` lit ce que le serveur présente :
```
sippts scan -i 192.168.0.1 -r 5061 -p tls -tlsinfo
```
Cela ne coûte aucune connexion supplémentaire, car la poignée de main a lieu de toute façon. Deux tableaux suivent celui habituel : ce que dit le certificat (version TLS, chiffrement, clé, expiration, et avec `-v` également le sujet, l'émetteur, le SAN et le SHA-256), et ce qui mérite d'être signalé à son sujet — expiré, auto-signé, clé inférieure à 2048 bits, signature SHA-1 ou MD5, un nom qui ne correspond pas, une ancienne version TLS ou un chiffrement faible.
Celui qui compte le plus en VoIP est `CERT_DEFAULT_VENDOR` : le certificat d'usine d'un PBX ou d'un téléphone, dont la clé privée est livrée à l'intérieur de l'image du firmware. Quiconque télécharge cette image peut s'interposer au milieu du SIP-TLS.
Avec `-tlsversions`, il essaie également TLS 1.0, 1.1, 1.2 et 1.3 une version à la fois, ce qui coûte une poignée de main par version et est effectué une fois par hôte et par port :
```
sippts scan -i 192.168.0.1 -r 5061 -p tls -tlsversions
```
Chaque version revient comme `accepted`, `refused` ou `untested`. Cette dernière
signifie que *cet* OpenSSL ne peut pas proposer cette version, ce qui n'est pas la même chose que
le serveur l'ayant désactivée, et la différence compte lorsque le résultat est
consigné dans un rapport.
Deux limites honnêtes, que l'outil affiche au lieu de les masquer :
* **SSLv2 et SSLv3 ne peuvent pas être testés.** OpenSSL 3 est compilé sans eux, donc
sippts ne peut pas les proposer. Ils sont signalés comme `untested`, jamais comme
`disabled`.
* Un certificat auto-signé sur un trunk SIP interne n'est pas une conclusion en
soi. Jugez-le en contexte.
Le tableau principal, le fichier de `-o` et le CSV de `-ocsv` ne changent pas. Le
JSON de `-oj` gagne `tls` et `tls_findings`.
## Détournement d'appel ##
`Replaces` (RFC 3891) pointe vers un appel déjà établi, par son Call-ID et
ses deux tags. `sippts dump` et `sippts sniff` sont ce qui vous fournit ces trois
valeurs à partir d'une capture ; à partir de là :
```
sippts send -i 192.168.0.1 -m REFER -refer-to 200 -replaces "CALLID;to-tag=X;from-tag=Y"
sippts send -i 192.168.0.1 -m INVITE -replaces "CALLID;to-tag=X;from-tag=Y"
```
Sur un REFER, il s'agit d'un transfert assisté, et sur un INVITE, il prend l'appel en charge. `sippts invite` accepte également `-replaces`, pour l'ajouter au REFER que `-t` envoie déjà, de sorte que le transfert se produit à l'intérieur d'un appel qu'il vient d'établir.
## Ce qu'un serveur déclare prendre en charge ##
`enumerate` essaie les 14 méthodes SIP une par une et les distingue par la réponse, mais un serveur indique aussi ce qu'il accepte dans les en-têtes `Allow`, `Supported` et `Allow-Events`. Ceux-ci sont également lus et affichés dans un second tableau, qui souligne aussi les deux contradictions qui méritent attention : une méthode annoncée dans `Allow` qui répond ensuite `405`, et une méthode qui répond correctement sans être annoncée du tout. `Allow-Events` est celui qui indique si l'on peut s'abonner à `dialog`, `message-summary` ou `presence`, ce qui est la prochaine étape de `send -m subscribe`.
```
sippts enumerate -i 192.168.0.1
```
Le premier tableau conserve la forme qu'il a toujours eue, et il en va de même pour le CSV de
`-ocsv`. Les nouvelles données sont uniquement ajoutées au JSON de `-oj`, sous
`capabilities`.
## Vulnérabilités connues ##
Avec `-cve`, le module `scan` compare ce qu'il identifie à une liste de
vulnérabilités connues qui voyage à l'intérieur du paquet
(`src/sippts/data/cve.csv`). Elle contient environ 1400 CVE de 54 éditeurs, construite
à partir du [NVD du NIST](https://nvd.nist.gov), et les plages de versions proviennent des
CPE de chaque CVE :
```bash
sippts scan -i 192.168.0.0/24 -fp -cve
```
Les résultats dont la version se situe réellement dans la plage affectée sont listés en premier.
Les autres sont affichés derrière eux comme simplement possibles, car dans un scanner, une CVE
qui existe et n'est pas signalée est pire qu'une CVE signalée en excès. Une ligne
sans plage signifie que toutes les versions de cet appareil sont affectées.
Deux limites à connaître. La détection repose sur le `User-Agent`, donc un serveur
qui le masque ne peut être vérifié par rapport à quoi que ce soit. Et certains produits sont
versionnés avec des lettres (les A, B et C d'Asterisk Business Edition, ou
`beta_5`), qu'aucune comparaison numérique ne peut ordonner : ceux-ci sont mis en correspondance par texte
uniquement, et ressortent toujours comme possibles plutôt que confirmés.
Pour mettre à jour la liste :
```bash
sippts -up
```
qui le télécharge depuis github avec le reste des modules.
### Sévérité ###
Chaque CVE porte son score CVSS, coloré selon la sévérité : violet pour critique, rouge pour
élevée, jaune pour moyenne et cyan pour faible. Les plus graves sont listées en premier.
La NVD ne dispose pas du CVSS v3 pour toutes les CVE : environ un tiers de la liste est
antérieure à 2016 et ne possède que la v2, et pour Asterisk c'est la majorité d'entre elles. Lorsque
seule la v2 existe, elle est utilisée et **marquée avec `v2`**, car les deux échelles ne sont
pas équivalentes et la v2 n'a pas de niveau CRITICAL : CVE-2017-16563 est 6.0 MEDIUM en
v2 et 8.0 HIGH en v3.
Un sippts antérieur à 4.2.1 ne peut pas lire cette colonne. Mettez à jour avec `sippts -up`.
### Reconstruire la liste (mainteneurs) ###
`tools/cve_update.py` reconstruit `cve.csv` à partir de la NVD. Ce n'est pas quelque chose que
l'utilisateur de sippts exécute : l'idée est de le régénérer, d'examiner le diff, de le committer,
et de laisser tout le monde l'obtenir avec `sippts -up`. Cela garde la clé API et les
limites de débit de la NVD en dehors du déroulement d'un audit.
```bash
./tools/cve_update.py --dry-run # what would change, writing nothing
./tools/cve_update.py # rebuild it
./tools/cve_update.py --vendor yealink # only one vendor
NVD_API_KEY=xxxx ./tools/cve_update.py # ten times faster
```
Sans clé API, le NVD autorise 5 requêtes toutes les 30 secondes et une exécution complète prend environ quinze minutes. Elles sont gratuites sur
[nvd.nist.gov](https://nvd.nist.gov/developers/request-an-api-key).
Deux listes en haut du script contrôlent ce qui est recherché. `VENDORS` contient
les fournisseurs, et chacun peut être le fournisseur entier, une liste de produits, ou
filtré par tag. `TAGS_VOIP` contient les tags (`voip`, `sip`, `ip_phone`, `ata`,
`pbx`, `ip_office`, `mivoice`...). Le filtre est important pour les fournisseurs qui fabriquent aussi
des routeurs et des pare-feu : demander au NVD tout Zyxel renvoie 3223
lignes de matériel WiFi et DSL que sippts ne verra jamais via SIP.
## Systèmes d'exploitation ##
Sippts a été testé sur :
* Linux
* MacOS
## Prérequis ##
* Python 3
* Les dépendances listées dans requirements.txt, installées automatiquement par pip
* Pour sniff, dump et pcapdump : tshark (fourni avec Wireshark)
* Pour extraire l'audio avec pcapdump : sox et ffmpeg
## Installation ##
Installation via git :
```bash
git clone https://github.com/Pepelux/sippts.git
```
```bash
cd sippts
```
```bash
pip3 install .
```