Unduh pypacker - Unduhan kode sumber pypacker

pypacker

Kategori lainnya

1.0.0

Unduh

Harap dicatat: Repositori ini terhenti karena relokasi ke GitLab. Kunjungi https://gitlab.com/mike01/pypacker untuk versi terbaru.

Informasi umum

Ini adalah Pypacker: Lib manipulasi paket tercepat dan paling sederhana untuk Python. Ini memungkinkan Anda membuat paket secara manual dengan mendefinisikan setiap aspek dari semua data header, membedah paket dengan mengurai byte paket mentah, mengirim/menerima paket pada lapisan yang berbeda dan mencegat paket.

Apa yang dapat Anda lakukan dengan Pypacker

Buat Paket dengan memberikan nilai spesifik atau ambil defaultnya:

 from pypacker . layer3 . ip import IP
from pypacker . layer3 . icmp import ICMP

ip = IP ( src_s = "127.0.0.1" , dst_s = "192.168.0.1" , p = 1 ) + 
	ICMP ( type = 8 ) + 
	ICMP . Echo ( id = 123 , seq = 1 , body_bytes = b"foobar" )

# output packet
print ( "%s" % ip )
IP ( v_hl = 45 , tos = 0 , len = 2 A , id = 0 , off = 0 , ttl = 40 , p = 1 , sum = 3 B29 , src = b' x7f x00 x00 x01 ' , dst = b' xc0 xa8 x00 x01 ' , opts = [], handler = icmp )
ICMP ( type = 8 , code = 0 , sum = C03F , handler = echo )
Echo ( id = 7 B , seq = 1 , ts = 0 , bytes = b'foobar' )

Baca paket dari file (format pcap/tcpdump), analisis dan tulis kembali:

 from pypacker import ppcap
from pypacker . layer12 import ethernet
from pypacker . layer3 import ip
from pypacker . layer4 import tcp

preader = ppcap . Reader ( filename = "packets_ether.pcap" )
pwriter = ppcap . Writer ( filename = "packets_ether_new.pcap" , linktype = ppcap . DLT_EN10MB )

for ts , buf in preader :
	eth = ethernet . Ethernet ( buf )

	if eth [ ethernet . Ethernet , ip . IP , tcp . TCP ] is not None :
		print ( "%d: %s:%s -> %s:%s" % ( ts , eth [ ip . IP ]. src_s , eth [ tcp . TCP ]. sport ,
			eth [ ip . IP ]. dst_s , eth [ tcp . TCP ]. dport ))
		pwriter . write ( eth . bin ())

pwriter . close ()

Mencegat (dan memodifikasi) Paket misalnya untuk MITM:

 # Add iptables rule:
# iptables -I INPUT 1 -p icmp -j NFQUEUE --queue-balance 0:2
import time

from pypacker import interceptor
from pypacker . layer3 import ip , icmp

# ICMP Echo request intercepting
def verdict_cb ( ll_data , ll_proto_id , data , ctx ):
	ip1 = ip . IP ( data )
	icmp1 = ip1 [ icmp . ICMP ]

	if icmp1 is None or icmp1 . type != icmp . ICMP_TYPE_ECHO_REQ :
		return data , interceptor . NF_ACCEPT

	echo1 = icmp1 [ icmp . ICMP . Echo ]

	if echo1 is None :
		return data , interceptor . NF_ACCEPT

	pp_bts = b"PYPACKER"
	print ( "changing ICMP echo request packet" )
	echo1 . body_bytes = echo1 . body_bytes [: - len ( pp_bts )] + pp_bts
	return ip1 . bin (), interceptor . NF_ACCEPT

ictor = interceptor . Interceptor ()
ictor . start ( verdict_cb , queue_ids = [ 0 , 1 , 2 ])
print ( "now sind a ICMP echo request to localhost: ping 127.0.0.1" )
time . sleep ( 999 )
ictor . stop ()

Mengirim dan menerima paket:

 # send/receive raw bytes
from pypacker import psocket
from pypacker . layer12 import ethernet
from pypacker . layer3 import ip

psock = psocket . SocketHndl ( mode = psocket . SocketHndl . MODE_LAYER_2 , timeout = 10 )

for raw_bytes in psock :
	eth = ethernet . Ethernet ( raw_bytes )
	print ( "Got packet: %r" % eth )
	eth . reverse_address ()
	eth . ip . reverse_address ()
	psock . send ( eth . bin ())
	# stop on first packet
	break

psock . close ()

 # send/receive using filter
from pypacker import psocket
from pypacker . layer3 import ip
from pypacker . layer4 import tcp

packet_ip = ip . IP ( src_s = "127.0.0.1" , dst_s = "127.0.0.1" ) + tcp . TCP ( dport = 80 )
psock = psocket . SocketHndl ( mode = psocket . SocketHndl . MODE_LAYER_3 , timeout = 10 )

def filter_pkt ( pkt ):
	return pkt . ip . tcp . sport == 80

psock . send ( packet_ip . bin (), dst = packet_ip . dst_s )
pkts = psock . recvp ( filter_match_recv = filter_pkt )

for pkt in pkts :
	print ( "got answer: %r" % pkt )

psock . close ()

 # Send/receive based on source/destination data
from pypacker import psocket
from pypacker . layer3 import ip
from pypacker . layer4 import tcp

packet_ip = ip . IP ( src_s = "127.0.0.1" , dst_s = "127.0.0.1" ) + tcp . TCP ( dport = 80 )
psock = psocket . SocketHndl ( mode = psocket . SocketHndl . MODE_LAYER_3 , timeout = 10 )
packets = psock . sr ( packet_ip , max_packets_recv = 1 )

for p in packets :
    print ( "got layer 3 packet: %s" % p )
psock . close ()

Fitur utama

Buat paket jaringan pada lapisan OSI yang berbeda menggunakan kata kunci seperti MyPacket(value=123) atau byte mentah MyPacket(b"value")
Penggabungan lapisan melalui "+" seperti paket = lapisan1 + lapisan2
Akses cepat ke lapisan melalui notasi packet[tcp.TCP] atau packet.sublayerXYZ.tcp
Struktur paket yang dapat dibaca menggunakan print(packet) atau pernyataan serupa
Membaca/menyimpan paket melalui pembaca/penulis file Pcap/tcpdump
Pembacaan/penulisan paket langsung menggunakan API soket yang dibungkus
Kemampuan penghitungan Checksum Otomatis
Intersepsi Paket menggunakan target NFQUEUE
Membuat protokol baru dengan mudah (lihat FAQ di bawah)

Prasyarat

Python 3.x (CPython, Pypy, Jython atau Penerjemah apa pun)
Opsional (untuk pencegat):
- CPython
- sistem berbasis Linux
- iptables
- Dukungan target NFQUEUE di kernel untuk intersepsi paket
- perpustakaan libnetfilter_queue (lihat http://www.netfilter.org/projects/libnetfilter_queue)

Instalasi

Beberapa contoh:

Unduh/clone pypacker -> python setup.py install (versi terbaru)
pip install pypacker (disinkronkan ke master pada perubahan versi utama)

Contoh penggunaan

Lihat contoh/ dan tes/test_pypacker.py.

Pengujian

Tes dijalankan sebagai berikut:

Tambahkan direktori Pypacker ke PYTHONPATH.

cd pypacker
ekspor PYTHONPATH=$PYTHONPATH:$(pwd)

menjalankan tes

tes python/test_pypacker.py

Hasil tes kinerja: pypacker

 orC = Intel Core2 Duo CPU @ 1,866 GHz, 2GB RAM, CPython v3.6
orP = Intel Core2 Duo CPU @ 1,866 GHz, 2GB RAM, Pypy 5.10.1
rounds per test: 10000
=====================================
>>> parsing (IP + ICMP)
orC = 86064 p/s
orP = 208346 p/s
>>> creating/direct assigning (IP only header)
orC = 41623 p/s
orP = 59370 p/s
>>> bin() without change (IP)
orC = 170356 p/s
orP = 292133 p/s
>>> output with change/checksum recalculation (IP)
orC = 10104 p/s
orP = 23851 p/s
>>> basic/first layer parsing (Ethernet + IP + TCP + HTTP)
orC = 62748 p/s
orP = 241047 p/s
>>> changing Triggerlist element value (Ethernet + IP + TCP + HTTP)
orC = 101552 p/s
orP = 201994 p/s
>>> changing Triggerlist/text based proto (Ethernet + IP + TCP + HTTP)
orC = 37249 p/s
orP = 272972 p/s
>>> direct assigning and concatination (Ethernet + IP + TCP + HTTP)
orC = 7428 p/s
orP = 14315 p/s
>>> full packet parsing (Ethernet + IP + TCP + HTTP)
orC = 6886 p/s
orP = 17040 p/s

Hasil uji kinerja: pypacker vs dpkt vs scapy

 Comparing pypacker, dpkt and scapy performance (parsing Ethernet + IP + TCP + HTTP)
orC = Intel Core2 Duo CPU @ 1,866 GHz, 2GB RAM, CPython v3.6
orC2 = Intel Core2 Duo CPU @ 1,866 GHz, 2GB RAM, CPython v2.7
rounds per test: 10000
=====================================
>>> testing pypacker parsing speed
orC = 17938 p/s
>>> testing dpkt parsing speed
orC = 12431 p/s
>>> testing scapy parsing speed
orC2 = 726 p/s

Pertanyaan Umum

Q : Di mana saya harus mulai belajar menggunakan Pypacker?

A : Jika Anda sudah mengetahui Scapy, memulai dengan membaca contoh-contohnya boleh saja. Jika tidak, ada pengenalan umum tentang pypacker yang disertakan di dokumen yang menunjukkan penggunaan dan konsep pypacker.

T : Seberapa cepat pypacker?

A : Lihat hasilnya di atas. Untuk hasil terperinci pada mesin Anda, jalankan tes.

Q : Apakah ada dokumentasinya?

J : Pypacker didasarkan pada kode dpkt, yang tidak memiliki dokumentasi kode internal resmi dan sangat sedikit. Hal ini membuat pemahaman tentang perilaku internal menjadi rumit. Bagaimanapun, dokumentasi kode telah diperluas untuk Pypacker. Dokumentasi dapat ditemukan di direktori dan file berikut:

contoh/ (banyak contoh yang menunjukkan penggunaan Pypacker)
wiki (pengantar umum tentang pypacker)
pypacker.py (struktur Paket umum)

Protokol itu sendiri (lihat layerXYZ) umumnya tidak memiliki banyak dokumentasi karena didokumentasikan oleh RFC/standar resminya masing-masing.

T : Protokol apa saja yang didukung?

A : Protokol minimum yang didukung saat ini adalah: Ethernet, Radiotap, IEEE80211, ARP, DNS, STP, PPP, OSPF, VRRP, DTP, IP, ICMP, PIM, IGMP, IPX, TCP, UDP, SCTP, HTTP, NTP, RTP, DHCP, RIP, SIP, Telnet, HSRP, Diameter, SSL, TPKT, Pmap, Radius, BGP

Q : Bagaimana protokol ditambahkan?

A : Jawaban singkat: Perluas kelas Paket dan tambahkan variabel kelas __hdr__ untuk menentukan bidang header. Jawaban panjang: Lihat example/examples_new_protocol.py untuk contoh yang sangat lengkap.

Q : Bagaimana saya bisa berkontribusi pada proyek ini?

A : Silakan gunakan pelacak bug Github untuk permintaan bug/fitur. Harap baca pelacak bug untuk mengetahui bug yang sudah diketahui sebelum mengajukan bug baru. Patch dapat dikirim melalui permintaan tarik.

T : Di bawah lisensi apa Pypacker diterbitkan?

A : Ini adalah Lisensi GPLv2 (lihat file LISENSI untuk informasi lebih lanjut).

Q : Apakah ada rencana untuk mendukung [protokol xyz]?

J : Dukungan untuk protokol tertentu ditambahkan ke Pypacker sebagai hasil dari kontribusi orang terhadap dukungan tersebut - tidak ada rencana formal untuk menambahkan dukungan untuk protokol tertentu pada rilis tertentu di masa mendatang.

Q : Ada masalah xyz dengan Pypacker yang menggunakan Windows 3.11/XP/7/8/mobile dll. Bisakah Anda memperbaikinya?

J : Fitur dasar dapat digunakan pada OS apa pun. Yang opsional mungkin menimbulkan masalah (misalnya pencegat) dan tidak akan ada dukungan untuk itu. Mengapa? Karena kualitas itu penting dan saya tidak akan memberikan dukungan untuk sistem yang lebih rendah. Berpikirlah dua kali sebelum memilih sistem operasi dan hadapi konsekuensinya; jangan salahkan orang lain atas keputusanmu. Alternatifnya: beri saya kompensasi uang dan saya akan lihat apa yang bisa saya lakukan (;

Petunjuk penggunaan

Terkait kinerja

Untuk kinerja maksimum, mulailah mengakses atribut pada tingkat terendah misalnya untuk pemfilteran:

 # This will lazy parse only needed layers behind the scenes
if ether.src == "...":
    ...
elif ip.src == "...":
    ...
elif tcp.sport == "...":
    ...

Hindari mengonversi paket menggunakan format "%s" atau "%r" karena akan memicu penguraian di belakang layar:

 pkt = Ethernet() + IP() + TCP()
# This parses ALL layers
packet_print = "%s" % pkt

Hindari mencari lapisan menggunakan notasi indeks nilai tunggal melalui pkt[L] karena ia mem-parsing semua lapisan hingga L ditemukan atau lapisan tertinggi tercapai:

 packet_found = pkt[Telnet]
# Alternative: Use multi-value index-notation. This will stop parsing at any non-matching layer:
packet_found = pkt[Ethernet,IP,TCP,Telnet]

Untuk kinerja yang lebih baik, nonaktifkan bidang otomatis (mempengaruhi pemanggilan bin(...)):

 pkt = ip.IP(src_s="1.2.3.4", dst_s="1.2.3.5") + tcp.TCP()
# Disable checksum calculation (and any other update) for IP and TCP (only THIS packet instance)
pkt.sum_au_active = False
pkt.tcp.sum_au_active = False
bts = pkt.bin(update_auto_fields=False)

Perbesar buffer terima/kirim untuk mendapatkan performa maksimal. Hal ini dapat dilakukan dengan menggunakan perintah berikut (diambil dari: http://www.cyberciti.biz/faq/linux-tcp-tuning/):

 sysctl -w net.core.rmem_max=12582912
sysctl -w net.core.rmem_default=12582912
sysctl -w net.core.wmem_max=12582912
sysctl -w net.core.wmem_default=12582912
sysctl -w net.core.optmem_max=2048000
sysctl -w net.core.netdev_max_backlog=5000
sysctl -w net.unix.max_dgram_qlen=1000
sysctl -w net.ipv4.tcp_rmem="10240 87380 12582912"
sysctl -w net.ipv4.tcp_wmem="10240 87380 12582912"
sysctl -w net.ipv4.tcp_mem="21228 87380 12582912"
sysctl -w net.ipv4.udp_mem="21228 87380 12582912"
sysctl -w net.ipv4.tcp_window_scaling=1
sysctl -w net.ipv4.tcp_timestamps=1
sysctl -w net.ipv4.tcp_sack=1