
Wrapper Python per tshark, che permette il parsing di pacchetti Python utilizzando i dissector di Wireshark (versione legacy Python2)
Questo repository è per la versione legacy di pyshark, che funziona su Python 2.7+. Riceve solo correzioni di bug dopo la versione 0.3.8. Per la nuova versione supportata solo su Python 3.5+, usa il repository principale
Wrapper Python per tshark, che consente l'analisi dei pacchetti Python utilizzando i dissector di Wireshark.
Documentazione estesa: http://kiminewt.github.io/pyshark
Esistono diversi moduli Python per l'analisi dei pacchetti, questo è diverso perché non analizza effettivamente alcun pacchetto, ma utilizza semplicemente la capacità di tshark (utility a riga di comando di Wireshark) di esportare XML per utilizzare la sua analisi.
Questo pacchetto consente l'analisi da un file di cattura o da una cattura live, utilizzando tutti i dissector di Wireshark che hai installato. Testato su Windows/Linux.
Esegui semplicemente il seguente comando per installare l'ultima versione da pypi
pip install pyshark-legacy
Oppure installa dal repository git:
git clone https://github.com/KimiNewt/pyshark-legacy.git
cd pyshark/src
python setup.py install
Potrebbe essere necessario installare libxml, cosa che può essere inaspettata. Se ricevi un errore da clang o un messaggio di errore riguardante libxml, esegui quanto segue:
xcode-select --install
pip install libxml
Probabilmente dovrai accettare un EULA per XCode, quindi preparati a fare clic su una finestra di dialogo "Accetta" nell'interfaccia grafica.
>>> import pyshark
>>> cap = pyshark.FileCapture('/tmp/mycapture.cap')
>>> cap
<FileCapture /tmp/mycapture.cap (589 packets)>
>>> print cap[0]
Packet (Length: 698)
Layer ETH:
Destination: BLANKED
Source: BLANKED
Type: IP (0x0800)
Layer IP:
Version: 4
Header Length: 20 bytes
Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00: Not-ECT (Not ECN-Capable Transport))
Total Length: 684
Identification: 0x254f (9551)
Flags: 0x00
Fragment offset: 0
Time to live: 1
Protocol: UDP (17)
Header checksum: 0xe148 [correct]
Source: BLANKED
Destination: BLANKED
...
>>> capture = pyshark.LiveCapture(interface='eth0')
>>> capture.sniff(timeout=50)
>>> capture
<LiveCapture (5 packets)>
>>> capture[3]
<UDP/HTTP Packet>
for packet in capture.sniff_continuously(packet_count=5):
print 'Just arrived:', packet
>>> capture = pyshark.LiveRingCapture(interface='eth0')
>>> capture.sniff(timeout=50)
>>> capture
<LiveCapture (5 packets)>
>>> capture[3]
<UDP/HTTP Packet>
for packet in capture.sniff_continuously(packet_count=5):
print 'Just arrived:', packet
>>> capture = pyshark.RemoteCapture('192.168.1.101', 'eth0')
>>> capture.sniff(timeout=50)
>>> capture
I dati possono essere acceduti in diversi modi. I pacchetti sono divisi in layer, prima devi raggiungere il layer appropriato e poi puoi selezionare il tuo campo. Tutti i seguenti funzionano:
>>> packet['ip'].dst
192.168.0.1
>>> packet.ip.src
192.168.0.100
>>> packet[2].src
192.168.0.100
Per verificare se un layer è presente in un pacchetto, puoi usare il suo nome:
>>> 'IP' in packet
True
Per vedere tutti i nomi di campo possibili, usa l'attributo packet.layer.field_names (es. packet.ip.field_names) o la funzione di completamento automatico del tuo interprete.
Puoi anche ottenere i dati binari originali di un campo o una descrizione formattata:
>>> p.ip.addr.showname
Source or Destination Address: 10.0.0.10 (10.0.0.10)
# E anche alcuni nuovi attributi:
>>> p.ip.addr.int_value
167772170
>>> p.ip.addr.binary_value
'\n\x00\x00\n'
Pyshark supporta la decifratura automatica delle tracce utilizzando gli standard WEP, WPA-PWD e WPA-PSK (WPA-PWD è il valore predefinito).
>>> cap1 = pyshark.FileCapture('/tmp/capture1.cap', decryption_key='password')
>>> cap2 = pyshark.LiveCapture(interface='wi0', decryption_key='password', encryption_type='wpa-psk')
Una tupla degli standard di cifratura supportati, SUPPORTED_ENCRYPTION_STANDARDS, esiste in ogni classe di cattura.
>>> pyshark.FileCapture.SUPPORTED_ENCRYPTION_STANDARDS
('wep', 'wpa-pwd', 'wpa-psk')
>>> pyshark.LiveCapture.SUPPORTED_ENCRYPTION_STANDARDS
('wep', 'wpa-pwd', 'wpa-psk')
Questo progetto è concesso in licenza MIT. I contributi a questo progetto sono accettati con la stessa licenza.