Manipulation of network packets(网络报文操作)¶
网络报文操作主要用于负向协议测试,可在发送前修改报文。其特殊之处在于,协议实现及其规定的协议时序仍会被保留。也就是说,可以在正确时机对特定响应进行操作并发送,以触发预期错误场景。这一点与手动发送畸形报文有明显区别,因为手动发送时,很难准确把握时序行为或动态设置的协议字段。
Usage of manipulation objects(操作对象的用法)¶
报文操作通过操作对象实现。操作对象可以是固定的 ByteStream(静态操作),也可以是 Python 回调(动态操作)。回调可以是一般的 python 可调用对象,例如函数或实现了 __call__ 方法的对象。
对于 ByteStream,传入的 ByteStream 会直接替代原始报文使用。
在回调中,操作是动态执行的:回调会接收原本准备发送的报文对象作为参数,并且可以修改它。返回值可以是修改后的对象,也可以只是一个字节序列(bytes),随后将使用该返回值替代原始对象。如果回调返回 None,则不会发送任何网络报文。
示例如下:
import ...
class SimpleManipulation:
def __call__(self, packet: PacketClass) -> Optional[Union[PacketClass, bytes]]:
packet.SetSomeField(123)
return packet
def EvenSimplerManipulation(packet: PacketClass) -> Optional[Union[PacketClass, bytes]]:
return b'that is easy'
def DoNotSendAnything(packet: PacketClass) -> Optional[Union[PacketClass, bytes]]:
return None
如果回调用作操作对象,则必须将其存放在 user libraries(用户库) 已定义子目录中的某个 python 模块内。
使用操作对象启动操作后,对该对象所做的更改将不再影响当前操作,因为对象会在启动时被复制。不过,可以结合相应的jobs 来启动和停止操作,从而实现变更。
为确保操作对象可跨进程和跨网络使用,系统会通过 Python pickle 序列化复制该对象。在边界场景下,需要考虑 pickle 模块的限制和特殊行为。
MKA Manipulation(MKA 操作)¶
用于启动和停止 MKA 操作的 Jobs: StartMkaManipulation 和 StopMkaManipulation
报文对象: PacketMka
子目录:
MkaManipulations示例:
from typing import Optional, Union
from tts.lib.ethernet.PacketMka import PacketMka # api.Ethernet not available here
def MyMkaManipulation(packet: PacketMka) -> Optional[Union[PacketMka, bytes]]:
packet.SetKeyServerPriority(42)
packet.SetMemberIdentifier(ByteStream('11:22:33:44:55:66:77:88:99:AA:BB:CC'))
return packet
IKE Manipulation(IKE 操作)¶
用于启动和停止 IKE 操作的 Jobs: StartIkeManipulation 和 StopIkeManipulation
报文对象: PacketIke
子目录:
IkeManipulations示例:
from typing import Optional, Union
from tts.lib.ethernet.PacketIke import PacketIke # api.Ethernet not available here
def MyIkeManipulation(packet: PacketIke) -> Optional[Union[PacketIke, bytes]]:
packet.minorVersion = 12
return packet
SOME/IP-SD Manipulation(SOME/IP-SD 操作)¶
用于启动和停止 SOME/IP-SD 操作的 Jobs: StartSomeIpSdManipulation 和 StopSomeIpSdManipulation
报文对象: PacketSomeIpSd
子目录:
SomeIpSdManipulations示例:
from typing import Optional, Union
from tts.lib.ethernet.PacketSomeIpSd import PacketSomeIpSd # api.Ethernet not available here
def MySomeIpSdManipulation(packet: PacketSomeIpSd) -> Optional[Union[PacketSomeIpSd, bytes]]:
entries = packet.GetEntryList()
for entry in entries:
entry.SetMajorVersion(0xAB)
return packet
SOME/IP Manipulation(SOME/IP 操作)¶
用于启动和停止 SOME/IP 操作的 Jobs: StartSomeIpManipulation 和 StopSomeIpManipulation
报文对象: PacketSomeIp
子目录:
SomeIpManipulations示例:
from typing import Optional, Union
from tts.lib.ethernet.PacketSomeIp import PacketSomeIp # api.Ethernet not available here
def MySomeIpManipulation(packet: PacketSomeIp) -> Optional[Union[PacketSomeIp, bytes]]:
if packet.GetMessageId() == 0x35018002:
packet.SetSessionId(0x0C)
return packet
Using jobs to manipulate the protocol headers(使用 jobs 操作协议头)¶
通过 MKA 端口或 IKEv2 端口启动连接后,待发送的报文(例如 UDP 报文)会额外包含可通过 jobs 操作的 MACsec 或 IPsec 认证头。这不会影响内部协议处理流程,但可以有针对性地修改待发送报文。所有要修改的内容都作为参数传递给相应 job(例如 StartMacSecManipulation),并持续生效,直到调用对应的停止 job(例如 StopMacSecManipulation)为止。除序列号和 ICV 会变化外,每个 Packet 的修改内容保持不变。
参见 StartMacSecManipulation、StopMacSecManipulation、StartAhManipulation、StopAhManipulation
注意:当前用于启动和停止操作的 jobs 调用为异步方式。操作效果生效需要一定时间。