#packet-parser #dns #parser #layer #payload #tls #protocols

parse_layer7

一个用于解析来自UDP或TCP负载的第七层数据包的crate

10个版本

0.3.2 2024年7月19日
0.3.1 2024年7月19日
0.1.6 2024年7月5日

#1006 in 网络编程

Download history 294/week @ 2024-06-29 298/week @ 2024-07-06 175/week @ 2024-07-13 81/week @ 2024-07-20 5/week @ 2024-07-27

270 每月下载量

MIT/Apache

75KB
1.5K SLoC

第七层数据包分析器

Crates.io Documentation

概述

layer7_packet_analyzer 是一个Rust crate,用于解析和分析各种第七层(应用层)网络协议。它支持DNS、TLS、DHCP、HTTP、Modbus、NTP和Bitcoin等协议。

特性

  • 解析和分析第七层网络协议。
  • 支持多种协议:DNS、TLS、DHCP、HTTP、Modbus、NTP和Bitcoin。
  • 提供数据结构和函数,方便数据包分析。

使用方法

layer7_packet_analyzer 添加到您的 Cargo.toml

[dependencies]
layer7_packet_analyzer = "0.1.0"

示例

以下是一个使用此crate解析第七层数据包信息的简单示例

use layer7_packet_analyzer::parse_layer_7_infos;

let packet: &[u8] = &[/* raw packet data */];
match parse_layer_7_infos(packet) {
    Some(info) => println!("Parsed Layer 7 Info: {}", info),
    None => println!("Unable to parse the packet."),
}

解析特定协议

您也可以直接使用相应模块来解析特定协议。以下是一个解析TLS数据包的示例

use layer7_packet_analyzer::packet::tls::{parse_tls_packet, TlsPacket};

let tls_packet_data: &[u8] = &[/* raw TLS packet data */];
match parse_tls_packet(tls_packet_data) {
    Ok(tls_packet) => println!("Parsed TLS Packet: {:?}", tls_packet),
    Err(e) => println!("Failed to parse TLS packet: {}", e),
}

模块

packet

packet 模块包含对每个支持协议的子模块。每个子模块提供解析协议数据包及其表示解析数据的结构所需的函数。

示例模块

  • dns:解析DNS数据包的函数和结构。
  • tls:解析TLS数据包的函数和结构。
  • dhcp:解析DHCP数据包的函数和结构。
  • http:解析HTTP请求的函数和结构。
  • modbus:解析Modbus数据包的函数和结构。
  • ntp:解析NTP数据包的函数和结构。
  • bitcoin:解析Bitcoin数据包的函数和结构。

结构和枚举

Layer7Info

表示可以解析的可能的第七层信息。

use layer7_packet_analyzer::packet::{
   bitcoin::{parse_bitcoin_packet, BitcoinPacket},
   dhcp::{parse_dhcp_packet, DhcpPacket},
   dns::{parse_dns_packet, DnsPacket},
   http::{parse_http_request, HttpRequest},
   modbus::{parse_modbus_packet, ModbusPacket},
   ntp::{parse_ntp_packet, NtpPacket},
   tls::{parse_tls_packet, TlsPacket},
};

#[derive(Debug)]
pub enum Layer7Info {
    DnsPacket(DnsPacket),
    TlsPacket(TlsPacket),
    DhcpPacket(DhcpPacket),
    HttpRequest(HttpRequest),
    ModbusPacket(ModbusPacket),
    NtpPacket(NtpPacket),
    BitcoinPacket(BitcoinPacket),
    None,
}

Layer7Infos

包含关于第七层协议及其解析数据的详细信息。

示例

解析TLS数据包

use layer7_packet_analyzer::parse_layer_7_infos;

let tls_payload = vec![22, 3, 3, 0, 5, 1, 2, 3, 4, 5]; // Example TLS payload
let result = parse_layer_7_infos(&tls_payload);

match result {
    Some(layer_7_infos) => println!("Parsed Info: {}", layer_7_infos),
    None => println!("Failed to parse the packet."),
}

解析DNS数据包

use layer7_packet_analyzer::parse_layer_7_infos;

let dns_payload = vec![
    0xdd, 0xc7, 0x01, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x77, 0x77, 0x77,
    0x06, 0x67, 0x6f, 0x6f, 0x67, 0x6c, 0x65, 0x03, 0x63, 0x6f, 0x6d, 0x00, 0x00, 0x01, 0x00, 0x01
]; // Example DNS payload
let result = parse_layer_7_infos(&dns_payload);

match result {
    Some(layer_7_infos) => println!("Parsed Info: {}", layer_7_infos),
    None => println!("Failed to parse the packet."),
}

许可证

本项目使用MIT许可证。有关详细信息,请参阅LICENSE文件。

依赖项

~0.8–1.7MB
~37K SLoC