TLS handshakes
tls_handshakesAnalyze TLS handshakes per connection from packet captures without decryption to compare client offers and server choices, identify failures, alerts, timing, and certificate details.
Instructions
TLS handshakes per connection, read from the clear part of the handshake. No
decryption and no key material. For TCP and QUIC: the client's offer (SNI, ALPN,
TLS versions, number of cipher suites without GREASE, fallback SCSV) against the
server's choice (version, cipher suite, ALPN when in clear), HelloRetryRequest,
time from SYN to ClientHello and from ClientHello to ServerHello, alerts with
level, name and who sent them (QUIC CONNECTION_CLOSE carrying a TLS alert too),
and for TLS 1.2 and older the leaf certificate (subject, issuer, SAN, notBefore,
notAfter, chain length). outcome is established, alert, no_server_hello,
reset_by_server, closed_by_server, client_gave_up, client_rejected_likely (TLS
1.3: the client sent one encrypted alert-sized record instead of Finished,
usually a certificate it would not accept), unreadable (the server answered but
tshark could not read a ServerHello), incomplete, one_sided (only one direction
captured: not a failure), or server_hello for QUIC (the rest is encrypted). server_name keeps that SNI and the names under it;
filter is ANDed with the base filter. Problem connections come first.
More detail: resource schema://tools/tls_handshakes.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "tls_handshakes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| path | Yes | Capture file (absolute, in an allowed dir) or open_capture handle | |
| limit | No | Most rows per page | |
| start | No | ISO 8601, epoch s, +Ns from start, -Ns from end | |
| filter | No | Extra display filter, ANDed | |
| offset | No | Rows to skip (next_offset) | |
| output | No | summary: all but rows, plus 3 rows (<8 KB) | rows |
| redact | No | Replace subscriber identifiers in this result with tokens; ids+ips hides every IP too | off |
| columns | No | Row keys to keep (frame keys stay) | |
| server_name | No | TLS SNI (server name), or part of it | |
| max_output_kb | No | Lower output cap, KB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| error | No | ||
| issues | No | ||
| offset | No | ||
| window | No | ||
| dropped | No | ||
| summary | No | ||
| has_more | No | ||
| returned | No | ||
| connections | No | rows with keys: transport, stream, client, server, frame, time, sni, offered, client_hellos, client_hello_missing, hello_retry_request, chosen, tcp_to_hello_ms, server_hello_ms, alerts, certificate, outcome, note, closed, duplicate_copies, issues | |
| next_offset | No | ||
| total_found | No | ||
| total_matched | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| total_is_lower_bound | No |