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 调用为异步方式。操作效果生效需要一定时间。