guise-echo: local TLS+H2+TCP echo service for wire fingerprinting
guise-echo terminates local TLS 1.3 connections, parses raw TLS ClientHello messages, captures HTTP/2 control frames (preface, SETTINGS, WINDOW_UPDATE, PRIORITY), and reads host TCP/IP stack configuration. It echoes the captured fingerprint metadata as JSON over HTTP/1.1.
guise-echo allows the Santh stealth stack (guise, scanclient, stealth-core) to inspect and diff its emitted Layer-2/3/4 bytes locally without external network dependencies or third-party reflection endpoints.
What it does
-
TLS ClientHello Capture
- Intercepts raw TLS record headers before handshake completion.
- Parses cipher suites, extension IDs, supported elliptic curves/groups, EC point formats, ALPN values, signature algorithms, and
supported_versions. - Computes canonical JA3 and JA4 fingerprint strings via
guise::fingerprint::ja3.
-
HTTP/2 Frame Capture
- Evaluates negotiated ALPN (
h2). - Validates client magic connection preface (
PRI * HTTP/2.0\r\n\r\nSM\r\n\r\n). - Captures client
SETTINGSparameter ID/value pairs,WINDOW_UPDATEincrements, andPRIORITYframe parameters within a strict frame budget before tearing down the diagnostic loop.
- Evaluates negotiated ALPN (
-
Host TCP Stack Inspection
- Reads Linux TCP stack configuration (
/proc/sys/net/ipv4/*) for initial SYN TTL, TCP timestamps, SACK permission, and window scaling options to verify operating system signature coherence.
- Reads Linux TCP stack configuration (
-
Adversarial Resilience
- Fails closed against malformed, oversized, or truncated TLS records.
- Ensures hostile or malformed probes never panic the server or crash the background listener loop.
Quick start
As a Library
Add guise-echo to your Cargo.toml:
[]
= { = "software/browser/echo" }
Spin up the echo server:
use SocketAddr;
async
As a Standalone Binary
Run the echo service daemon:
Query with a TLS client:
Response Schema
The endpoint responds with HTTP 200 OK containing a JSON serialized ConnectionInfo object:
Testing
Run unit, adversarial, and property test suites:
License
Licensed under either of Apache-2.0 or MIT at your option.