
Wrapper Python para tshark, permitindo análise de pacotes em Python usando dissecadores do Wireshark (versão legada Python2)
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.
Este repositório é para a versão legada do pyshark, que funciona no Python2.7+. Ele só recebe correções de bugs após a versão 0.3.8. Para a nova versão que é suportada apenas no Python 3.5+, por favor use o repositório principal
Wrapper Python para tshark, permitindo a análise de pacotes Python usando os dissecadores do Wireshark.
Documentação estendida: http://kiminewt.github.io/pyshark
Existem vários módulos de análise de pacotes Python, este é diferente porque na verdade não analisa nenhum pacote, ele simplesmente usa a capacidade do tshark (utilitário de linha de comando do Wireshark) de exportar XMLs para usar sua análise.
Este pacote permite a análise a partir de um arquivo de captura ou uma captura ao vivo, usando todos os dissecadores do Wireshark que você instalou. Testado no Windows/Linux.
Simplesmente execute o seguinte para instalar a versão mais recente do pypi
pip install pyshark-legacy
Ou instale a partir do repositório git:
git clone https://github.com/KimiNewt/pyshark-legacy.git
cd pyshark/src
python setup.py install
Você pode precisar instalar libxml, o que pode ser inesperado. Se receber um erro do clang ou uma mensagem de erro sobre libxml, execute o seguinte:
xcode-select --install
pip install libxml
Você provavelmente terá que aceitar um EULA do XCode, então esteja pronto para clicar em um diálogo "Aceitar" na GUI.
>>> 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
Os dados podem ser acessados de várias maneiras. Os pacotes são divididos em camadas, primeiro você precisa alcançar a camada apropriada e depois pode selecionar seu campo.
Todos os seguintes funcionam:
>>> packet['ip'].dst
192.168.0.1
>>> packet.ip.src
192.168.0.100
>>> packet[2].src
192.168.0.100
Para testar se uma camada está em um pacote, você pode usar seu nome:
>>> 'IP' in packet
True
Para ver todos os nomes de campos possíveis, use o atributo packet.layer.field_names (isto é, packet.ip.field_names) ou a função de autocomplete no seu interpretador.
Você também pode obter os dados binários originais de um campo, ou uma descrição formatada dele: