0xb00b5/firegex-traffic-viewer
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

minor fixes and added docs

Browse Source
This commit is contained in:
Domingo Dirutigliano
2025-03-07 23:13:36 +01:00
parent 8a271da839
commit 4fa530a6bd
8 changed files with 205 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
fgex-lib/firegex/nfproxy/internals/data.py
View File

@@ -2,9 +2,7 @@ from firegex.nfproxy.internals.models import FilterHandler
from firegex.nfproxy.internals.models import FullStreamAction
class RawPacket:
"""
class rapresentation of the nfqueue packet sent in this context by the c++ core
"""
"class rapresentation of the nfqueue packet sent in python context by the c++ core"
def __init__(self,
data: bytes,
@@ -24,30 +22,37 @@ class RawPacket:
@property
def is_input(self) -> bool:
"It's true if the packet is an input packet, false if it's an output packet"
return self.__is_input
@property
def is_ipv6(self) -> bool:
"It's true if the packet is an ipv6 packet, false if it's an ipv4 packet"
return self.__is_ipv6
@property
def is_tcp(self) -> bool:
"It's true if the packet is a tcp packet, false if it's an udp packet"
return self.__is_tcp
@property
def data(self) -> bytes:
"The data of the packet assembled and sorted from TCP"
return self.__data
@property
def l4_size(self) -> int:
"The size of the layer 4 data"
return self.__l4_size
@property
def raw_packet_header_len(self) -> int:
"The size of the original packet header"
return self.__raw_packet_header_size
@property
def l4_data(self) -> bytes:
"The layer 4 payload of the packet"
return self.__raw_packet[self.raw_packet_header_len:]
@l4_data.setter
@@ -60,6 +65,7 @@ class RawPacket:
@property
def raw_packet(self) -> bytes:
"The raw packet with IP and TCP headers"
return self.__raw_packet
@raw_packet.setter
@@ -92,6 +98,7 @@ class RawPacket:
class DataStreamCtx:
"class to store the context of the data handler"
def __init__(self, glob: dict, init_pkt: bool = True):
if "__firegex_pyfilter_ctx" not in glob.keys():

4
fgex-lib/firegex/nfproxy/internals/models.py
View File

@@ -2,12 +2,14 @@ from dataclasses import dataclass, field
from enum import Enum
class Action(Enum):
"""Action to be taken by the filter"""
ACCEPT = 0
DROP = 1
REJECT = 2
MANGLE = 3
class FullStreamAction(Enum):
"""Action to be taken by the filter when the stream is full"""
FLUSH = 0
ACCEPT = 1
REJECT = 2
@@ -15,6 +17,7 @@ class FullStreamAction(Enum):
@dataclass
class FilterHandler:
"""Filter handler"""
func: callable
name: str
params: dict[type, callable]
@@ -22,6 +25,7 @@ class FilterHandler:
@dataclass
class PacketHandlerResult:
"""Packet handler result"""
glob: dict = field(repr=False)
action: Action = Action.ACCEPT
matched_by: str = None

37
fgex-lib/firegex/nfproxy/models/http.py
View File

@@ -129,6 +129,7 @@ class InternalHttpResponse(InternalCallbackHandler, pyllhttp.Response):
super(pyllhttp.Response, self).__init__()
class InternalBasicHttpMetaClass:
"""Internal class to handle HTTP requests and responses"""
def __init__(self):
self._parser: InternalHttpRequest|InternalHttpResponse
@@ -138,57 +139,71 @@ class InternalBasicHttpMetaClass:
@property
def total_size(self) -> int:
"""Total size of the stream"""
return self._parser.total_size
@property
def url(self) -> str|None:
"""URL of the message"""
return self._parser.url
@property
def headers(self) -> dict[str, str]:
"""Headers of the message"""
return self._parser.headers
@property
def user_agent(self) -> str:
"""User agent of the message"""
return self._parser.user_agent
@property
def content_encoding(self) -> str:
"""Content encoding of the message"""
return self._parser.content_encoding
@property
def has_begun(self) -> bool:
"""If the message has begun"""
return self._parser.has_begun
@property
def body(self) -> bytes:
"""Body of the message"""
return self._parser.body
@property
def headers_complete(self) -> bool:
"""If the headers are complete"""
return self._parser.headers_complete
@property
def message_complete(self) -> bool:
"""If the message is complete"""
return self._parser.message_complete
@property
def http_version(self) -> str:
"""HTTP version of the message"""
return self._parser.http_version
@property
def keep_alive(self) -> bool:
"""If the message should keep alive"""
return self._parser.keep_alive
@property
def should_upgrade(self) -> bool:
"""If the message should upgrade"""
return self._parser.should_upgrade
@property
def content_length(self) -> int|None:
"""Content length of the message"""
return self._parser.content_length_parsed
def get_header(self, header: str, default=None) -> str:
"""Get a header from the message without caring about the case"""
return self._parser.lheaders.get(header.lower(), default)
def _packet_to_stream(self, internal_data: DataStreamCtx):
@@ -259,6 +274,11 @@ class InternalBasicHttpMetaClass:
return datahandler
class HttpRequest(InternalBasicHttpMetaClass):
"""
HTTP Request handler
This data handler will be called twice, first with the headers complete, and second with the body complete
"""
def __init__(self):
super().__init__()
# These will be used in the metaclass
@@ -267,6 +287,7 @@ class HttpRequest(InternalBasicHttpMetaClass):
@property
def method(self) -> bytes:
"""Method of the request"""
return self._parser.method_parsed
def _before_fetch_callable_checks(self, internal_data: DataStreamCtx):
@@ -276,6 +297,11 @@ class HttpRequest(InternalBasicHttpMetaClass):
return f"<HttpRequest method={self.method} url={self.url} headers={self.headers} body={self.body} http_version={self.http_version} keep_alive={self.keep_alive} should_upgrade={self.should_upgrade} headers_complete={self.headers_complete} message_complete={self.message_complete} has_begun={self.has_begun} content_length={self.content_length} stream={self.stream}>"
class HttpResponse(InternalBasicHttpMetaClass):
"""
HTTP Response handler
This data handler will be called twice, first with the headers complete, and second with the body complete
"""
def __init__(self):
super().__init__()
self._parser: InternalHttpResponse = InternalHttpResponse()
@@ -283,6 +309,7 @@ class HttpResponse(InternalBasicHttpMetaClass):
@property
def status_code(self) -> int:
"""Status code of the response"""
return self._parser.status
def _before_fetch_callable_checks(self, internal_data: DataStreamCtx):
@@ -292,6 +319,11 @@ class HttpResponse(InternalBasicHttpMetaClass):
return f"<HttpResponse status_code={self.status_code} url={self.url} headers={self.headers} body={self.body} http_version={self.http_version} keep_alive={self.keep_alive} should_upgrade={self.should_upgrade} headers_complete={self.headers_complete} message_complete={self.message_complete} has_begun={self.has_begun} content_length={self.content_length} stream={self.stream}>"
class HttpRequestHeader(HttpRequest):
"""
HTTP Request Header handler
This data handler will be called only once, the headers are complete, the body will be empty and not buffered
"""
def __init__(self):
super().__init__()
self._parser._save_body = False
@@ -306,6 +338,11 @@ class HttpRequestHeader(HttpRequest):
return False
class HttpResponseHeader(HttpResponse):
"""
HTTP Response Header handler
This data handler will be called only once, the headers are complete, the body will be empty and not buffered
"""
def __init__(self):
super().__init__()
self._parser._save_body = False

11
fgex-lib/firegex/nfproxy/models/tcp.py
View File

@@ -7,20 +7,27 @@ class InternalTCPStream:
data: bytes,
is_ipv6: bool,
):
self.data = bytes(data)
self.__data = bytes(data)
self.__is_ipv6 = bool(is_ipv6)
self.__total_stream_size = len(data)
@property
def data(self) -> bytes:
"""The data of the packets assembled and sorted from TCP"""
return self.__data
@property
def is_ipv6(self) -> bool:
"""It's true if the packet is an ipv6 packet, false if it's an ipv4 packet"""
return self.__is_ipv6
@property
def total_stream_size(self) -> int:
"""The size of the stream"""
return self.__total_stream_size
def _push_new_data(self, data: bytes):
self.data += data
self.__data += data
self.__total_stream_size += len(data)
@classmethod