
SIPベースのVoIPシステムを監査するためのツールセット
<center><img src="https://assets.kitploit.com/production/public/readmes/43212/6eee71d2f1e4d138db0d22382ca5a1f07e559d06c8ba6257179156199bdb8d47/88ff772aec8502903eb55970a1f2c4a9f02b189a5a2d10516482a8a9c32f5763-display-v1.webp" alt="logo" width="300"></center>
# Sipptsとは? #
Sipptsは、SIPプロトコルを使用するVoIPサーバーやデバイスを監査するためのツールセットです。SipptsはPythonでプログラムされており、SIPプロトコルを使用するVoIPサーバーのセキュリティをチェックすることができます。
# 無料ですか? #
はい。自由に使用、変更、配布することができます。変更した場合は、このサイトへの参照を含めてください。
# sipptsは違法な目的に使用できますか? #
このツールの目的は、自身のシステムを監査すること、または明示的な許可を得たシステムに対してペネトレーションテストを実行することです。このツールの悪用については責任を負いません。
# 使用方法 #
ヘルプを表示:
```
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
```
コマンド 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
```
スクリプトを更新:
```
sippts -up
```
# SIPプロトコルに対するペネトレーションテスト用ツールセット #
このツールの使用方法については、https://sippts.seguridadvoip.com および Github の wiki ページで確認できます:
Sippts は、SIP プロトコルを使用する VoIP サーバーやデバイスを監査するためのツールセットです。Sippts は Python でプログラムされており、以下のコマンドまたはモジュールで構成されています:
* _**scan**_ は SIP サービスのための高速なマルチスレッドスキャナーです。複数の IP アドレスとポート範囲をチェックでき、UDP、TCP、TLS、WebSockets (WS および WSS) 上で動作します。[scan コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-scan)
* _**exten**_ は SIP サーバー上の内線番号を特定します。また、その内線番号が認証を必要とするかどうかも通知します。複数の IP アドレスをチェックでき、-f を指定するとファイルからターゲットを読み込みます。[exten コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-exten)
* _**rcrack**_ はリモートパスワードクラッカーです。複数の IP アドレス上の複数のユーザーのパスワードをテストでき、-f を指定するとファイルからターゲットを読み込みます。[rcrack コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-rcrack)
* _**invite**_ は、サーバーが認証なしでの通話を許可しているかどうかをチェックします。SIP サーバーの設定が不適切な場合、外部番号への通話が許可されます。また、通話を2番目の外部番号に転送することもできます。[invite コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-invite)
* _**leak**_ は、Sandro Gauci によって発見された SIP Digest Leak 脆弱性を悪用します。この脆弱性は多数のハードウェアおよびソフトウェアデバイスに影響を与えます。[leak コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-leak)
* _**flood**_ はターゲットに無制限のメッセージを送信します。[flood コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-flood)
* _**send**_ はカスタマイズした SIP メッセージを UDP、TCP、TLS、WebSockets (WS および WSS) 経由で送信し、応答を分析します。[send コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-send)
* _**enumerate**_ は SIP サービスまたはサーバーで利用可能なメソッドを、UDP、TCP、TLS、WebSockets (WS および WSS) 経由で列挙します。[enumerate コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-enumerate)
* _**dump**_ は PCAP ファイルから SIP Digest 認証情報を抽出します。[dump コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-dump)
* _**dcrack**_ は SIP プロトコルのダイジェスト認証情報をクラックします。[dcrack コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-dcrack)
* _**pcapdump**_ は PCAP ファイルから SIP および RTP データを抽出し、音声ストリームを WAV ファイルとして保存できます。[pcapdump コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-pcapdump)
* _**ping**_ は SIP ping を送信して、サーバーまたはデバイスが稼働しているかどうかを確認します。[ping コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-ping)
* _**astami**_ は Asterisk Manager Interface (AMI) をスキャンおよび監査し、認証情報が有効なものに対してコマンドを実行できます。[astami コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-astami)
* _**sniff**_ は SIP トラフィックをライブでキャプチャし、検出したメッセージ、デバイス、ダイジェスト認証情報を表示します。[sniff コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-sniff)
* _**spoof**_ は ARP スプーフィングツールで、2台のデバイスの間に割り込み、それらのトラフィックをキャプチャします。[spoof コマンドの詳細はこちら](https://github.com/Pepelux/sippts/wiki/Command-spoof)
* _**video**_ は一般的なワークフローのアニメーションデモを再生します: scan から exten へ、そして rcrack へ、dump から dcrack へ、leak から dcrack へ、spoof から sniff へ。
* _**rtpbleed**_ は、RTPポートにデータを送信してRTP Bleed脆弱性を悪用します。[rtpbleedコマンドの詳細についてはこちらをクリックしてください](https://github.com/Pepelux/sippts/wiki/Command-rtpbleed)
* _**rtcpbleed**_ は、RTCPポートにデータを送信してRTP Bleed脆弱性を悪用します。[rtcpbleedコマンドの詳細についてはこちらをクリックしてください](https://github.com/Pepelux/sippts/wiki/Command-rtcpbleed)
* _**rtpbleedflood**_ は、アクティブなダイアログを持つRTPポートをフラッディングしてRTP Bleed脆弱性を悪用します。[rtpbleedfloodコマンドの詳細についてはこちらをクリックしてください](https://github.com/Pepelux/sippts/wiki/Command-rtpbleedflood)
* _**rtpbleedinject**_ は、RTPトラフィックを注入してRTP Bleed脆弱性を悪用します。[rtpbleedinjectコマンドの詳細についてはこちらをクリックしてください](https://github.com/Pepelux/sippts/wiki/Command-rtpbleedinject)
## TLS証明書 ##
sipptsはTLSを扱いますが、これまでは証明書を破棄していました。
`-tlsinfo` を指定すると、`scan` モジュールはサーバーが提示する内容を読み取ります:
```
sippts scan -i 192.168.0.1 -r 5061 -p tls -tlsinfo
```
追加の接続は不要です。ハンドシェイクはどのみち行われるからです。通常のテーブルの後に2つのテーブルが続きます。1つは証明書の内容(TLSバージョン、暗号、鍵、有効期限、そして`-v`指定時はサブジェクト、発行者、SAN、SHA-256も)を示すもの、もう1つは報告に値する事項——期限切れ、自己署名、2048ビット未満の鍵、SHA-1またはMD5署名、一致しない名前、古いTLSバージョン、弱い暗号——を示すものです。
VoIPで最も重要なのは`CERT_DEFAULT_VENDOR`です。これはPBXや電話機の工場出荷証明書であり、その秘密鍵がファームウェアイメージ内に同梱されています。そのイメージをダウンロードした者は誰でもSIP-TLSの中間者になれます。
`-tlsversions`を指定すると、TLS 1.0、1.1、1.2、1.3を1つずつ順に試します。これはバージョンごとに1回のハンドシェイクを要し、ホストとポートごとに1度だけ実行されます:
```
sippts scan -i 192.168.0.1 -r 5061 -p tls -tlsversions
```
各バージョンは `accepted`、`refused`、`untested` のいずれかで返されます。最後のものは、*この* OpenSSL がそのバージョンを提供できないことを意味し、サーバー側で無効化されていることとは異なります。この違いは、結果をレポートに記載する際に重要になります。
ツールが隠さずに表示する、正直な制約が2つあります:
* **SSLv2 と SSLv3 はテストできません。** OpenSSL 3 はこれらを組み込まずにビルドされているため、sippts はこれらを提供できません。これらは `untested` として報告され、決して `disabled` とは報告されません。
* 内部 SIP トランク上の自己署名証明書は、それ自体では所見にはなりません。文脈に照らして判断してください。
メインテーブル、`-o` のファイル、`-ocsv` の CSV は変わりません。`-oj` の JSON には `tls` と `tls_findings` が追加されます。
## 通話ハイジャック ##
`Replaces` (RFC 3891) は、すでに確立している通話を、その Call-ID と2つのタグによって指定します。`sippts dump` と `sippts sniff` は、キャプチャからこれら3つの値を取得する手段です。そこから:
```
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"
```
REFER ではアテンド転送となり、INVITE では通話を引き継ぎます。`sippts invite` は `-replaces` も受け付け、`-t` がすでに送信する REFER にこれを追加するため、転送は自身が設定した通話の内部で行われます。
## サーバーがサポートすると述べるもの ##
`enumerate` は 14 の SIP メソッドを 1 つずつ試し、応答によってそれらを区別しますが、サーバーは `Allow`、`Supported`、`Allow-Events` ヘッダーで受け付けるものも表明します。これらも読み取られ、2 番目の表に出力されます。この表は、注目すべき 2 つの矛盾も指摘します。`Allow` で広告されているのに `405` を返すメソッドと、広告されていないのに正常に応答するメソッドです。`Allow-Events` は、`dialog`、`message-summary`、`presence` を購読できるかどうかを示すものであり、`send -m subscribe` が次に進む先です。
```
sippts enumerate -i 192.168.0.1
```
最初のテーブルはこれまで通りの形を保ち、`-ocsv` の CSV も同様です。新しいデータは `-oj` の JSON にのみ、`capabilities` の下に追加されます。
## 既知の脆弱性 ##
`-cve` を指定すると、`scan` モジュールはフィンガープリントした内容を、パッケージ内に同梱されている既知の脆弱性リスト(`src/sippts/data/cve.csv`)と照合します。このリストには、[NIST の NVD](https://nvd.nist.gov) から構築された 54 ベンダーの約 1400 件の CVE が含まれており、バージョン範囲は各 CVE の CPE に由来します:
```bash
sippts scan -i 192.168.0.0/24 -fp -cve
```
バージョンが実際に影響範囲内に該当する結果が先に表示されます。それ以外は、スキャナにおいて存在するCVEが報告されないことは過剰に報告されるよりも悪いため、単に可能性のあるものとしてその後ろに表示されます。範囲のない行は、そのデバイスのすべてのバージョンが影響を受けることを意味します。
知っておく価値のある2つの制限があります。検出は`User-Agent`に依存しているため、それを隠すサーバーは何とも照合できません。また、一部の製品は文字でバージョン管理されており(Asterisk Business EditionのA、B、C、または`beta_5`など)、数値比較では順序付けできません。これらはテキストのみで照合され、常に確認済みではなく可能性ありとして出力されます。
リストを更新するには:
```bash
sippts -up
```
github から他のモジュールと一緒にダウンロードします。
### 深刻度 ###
各 CVE には CVSS が付与され、深刻度に応じて色分けされています。critical は紫、high は赤、medium は黄、low はシアンです。最も深刻なものが先頭に表示されます。
NVD にはすべての CVE について CVSS v3 が存在するわけではありません。リストのおよそ3分の1は2016年より古く、v2 しか持っておらず、Asterisk ではそのほとんどが該当します。v2 しか存在しない場合は v2 が使用され、**`v2` とマークされます**。これは2つのスケールが等価ではなく、v2 には CRITICAL レベルが存在しないためです。CVE-2017-16563 は v2 では 6.0 MEDIUM、v3 では 8.0 HIGH です。
4.2.1 より古い sippts はこの列を読み取れません。`sippts -up` で更新してください。
### リストの再構築(メンテナー向け) ###
`tools/cve_update.py` は NVD から `cve.csv` を再構築します。これは sippts のユーザーが実行するものではありません。再生成し、差分を確認し、コミットして、他の全員が `sippts -up` で取得できるようにする、というのが狙いです。これにより、NVD の API キーやレート制限が監査の最中に持ち込まれることを避けられます。
```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
```
API キーがない場合、NVD では 30 秒ごとに 5 リクエストが許可され、完全な実行には約 15 分かかります。API キーは [nvd.nist.gov](https://nvd.nist.gov/developers/request-an-api-key) で無料で取得できます。
スクリプト冒頭の 2 つのリストが検索対象を制御します。`VENDORS` にはベンダーを保持し、それぞれをベンダー全体、製品のリスト、またはタグによるフィルタリングとして指定できます。`TAGS_VOIP` にはタグ(`voip`、`sip`、`ip_phone`、`ata`、`pbx`、`ip_office`、`mivoice`...)を保持します。このフィルターは、ルーターやファイアウォールも製造しているベンダーにとって重要です。NVD に Zyxel 全体を問い合わせると、sippts が SIP 経由で決して見ることのない WiFi および DSL 機器の 3223 行が返ってきます。
## 対応オペレーティングシステム ##
Sippts は以下でテストされています:
* Linux
* MacOS
## 要件 ##
* Python 3
* requirements.txt に記載された依存関係(pip により自動的にインストールされます)
* sniff、dump、pcapdump の場合:tshark(Wireshark の一部)
* pcapdump で音声を抽出する場合:sox および ffmpeg
## インストール ##
git 経由でインストール:
```bash
git clone https://github.com/Pepelux/sippts.git
```
```bash
cd sippts
```
```bash
pip3 install .
```