frameassembly 1.4.2

Offline, rootless PCAP generator & Packets-as-Code DSL: generate deterministic .pcap/.pcapng from text across 81 protocols for Wireshark, tcpreplay & IDS.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

//! Transport Layer Security (TLS 1.2 / TLS 1.3) (RFC 8446 (TLS 1.3) / RFC 5246 (TLS 1.2) / RFC 6066 (SNI) / RFC 7301 (ALPN)) Layer 7 AST definitions.
//!
//! This module defines the abstract syntax tree (AST) configuration parameters for synthesizing
//! Transport Layer Security (TLS 1.2 / TLS 1.3) packets over TCP port 443. On the wire, the protocol uses a 5-byte TLS Record Layer header (8-bit ContentType: `21` Alert, `22` Handshake, `23` ApplicationData; 16-bit Legacy Record Version e.g. `0x0303`; 16-bit Length) encapsulating a 4-byte Handshake header (8-bit HandshakeType: `1` ClientHello, `2` ServerHello, `11` Certificate, `20` Finished; 24-bit Length), 32-byte Random nonce, CipherSuite list (`0x1301` TLS_AES_128_GCM_SHA256, `0x1302` TLS_AES_256_GCM_SHA384), and SNI (`0x0000`) / ALPN (`0x0010`) extensions.
//! Every field in [`TlsSpec`] is optional so authors can emit zero-configuration default
//! frames or override specific protocol header fields and attributes.
//!
//! Canonical `.fasm` syntax:
//! `a -> b TLS [CLIENT_HELLO | SERVER_HELLO | CERTIFICATE | FINISHED | APP_DATA | ALERT] [RECORD_VERSION <u16>] [HANDSHAKE_VERSION <u16>] [SNI <str>] [CIPHERSUITE <u16>] [ALPN <str>]`

/// RFC 8446 Transport Layer Security specification.
///
/// Syntax mapping: `TLS [CLIENT_HELLO | SERVER_HELLO | CERTIFICATE | FINISHED | APP_DATA | ALERT] [RECORD_VERSION <u16>] [HANDSHAKE_VERSION <u16>] [SNI <str>] [CIPHERSUITE <u16>] [ALPN <str>]`
#[doc(alias = "TLS")]
#[doc(alias = "TLS13")]
#[doc(alias = "RFC 8446")]
#[doc(alias = "RFC8446")]
#[doc(alias = "RFC 5246")]
#[doc(alias = "CLIENT_HELLO")]
#[doc(alias = "SERVER_HELLO")]
#[doc(alias = "CERTIFICATE")]
#[doc(alias = "FINISHED")]
#[doc(alias = "APP_DATA")]
#[doc(alias = "ALERT")]
#[doc(alias = "RECORD_VERSION")]
#[doc(alias = "HANDSHAKE_VERSION")]
#[doc(alias = "SNI")]
#[doc(alias = "ALPN")]
#[doc(alias = "CIPHERSUITE")]
#[derive(Debug, Clone, PartialEq, Eq, Default)]
pub struct TlsSpec<'a> {
    /// ClientHello handshake flag.
    pub is_client_hello: bool,
    /// ServerHello handshake flag.
    pub is_server_hello: bool,
    /// Certificate handshake flag.
    pub is_certificate: bool,
    /// Finished handshake flag.
    pub is_finished: bool,
    /// ApplicationData record flag.
    pub is_app_data: bool,
    /// Alert record flag.
    pub is_alert: bool,
    /// Record layer version.
    pub record_version: Option<u16>,
    /// Handshake protocol version.
    pub handshake_version: Option<u16>,
    /// Server Name Indication hostname.
    pub sni: Option<&'a str>,
    /// Cipher suite identifier.
    pub ciphersuite: Option<u16>,
    /// Application-Layer Protocol Negotiation string.
    pub alpn: Option<&'a str>,
}