Skip to main content

Crate guise_echo

Crate guise_echo 

Source
Expand description

Local TLS echo service for inspecting our own wire fingerprints.

guise-echo terminates TLS 1.3 locally, parses the client’s raw ClientHello with tls-parser, computes JA3/JA4 via guise::fingerprint::ja3, and returns the result as JSON over HTTP/1.1. It exists so the stealth stack can inspect its own Layer-2 bytes without relying on third-party reflectors.

Layers:

  • TLS ClientHello capture (JA3/JA4, ALPN, SNI, extensions)
  • HTTP/2 preface + SETTINGS/WINDOW_UPDATE/PRIORITY frame capture
  • TCP TTL/options read (tcp::read_host_tcp_info)

The service intentionally does not implement a full HTTP/2 server; it only reads the connection preface and the first control frames so the stealth stack can verify that its emitted H2 fingerprint matches a real browser.

Re-exports§

pub use tcp::read_host_tcp_info;
pub use tcp::TcpConnectionInfo;

Modules§

tcp
TCP-layer diagnostics for the local echo service.

Structs§

ClientHelloInfo
Parsed TLS ClientHello metadata + computed fingerprints.
ConnectionInfo
Combined fingerprint info returned by the echo endpoint.
H2ConnectionInfo
Captured HTTP/2 connection-level information from the client preface and first control frames.
H2Priority
A single HTTP/2 PRIORITY frame.
H2Setting
A single HTTP/2 SETTINGS parameter.

Enums§

JsonValue
Represents any valid JSON value.

Functions§

accept_one_for_test
Accept a single TCP connection, parse its TLS ClientHello, complete the handshake, and echo the parsed fingerprint as JSON. Exposed for tests that want to drive the server side without binding a listening socket.
serve
Run the echo server on bind until the process is killed.