Learn / Field guide

TLS: encryption for connections

TLS is the S in HTTPS. Before any data is sent, client and server agree on a version and cipher and check the server's certificate. After the handshake, an observer sees sizes and timing but not content.

47 TLS fields, explained

Field names are the ones Wireshark and TShark use, so you can search for them or use them in display filters.

tls.record.content_type

What this TLS record contains: handshake messages, an alert, or encrypted application data.

tls.record.version

A version number in the record header. Modern TLS keeps this fixed for compatibility.

Why it matters: The real negotiated version is in the Server Hello.

tls.record.length

How many bytes this TLS record carries.

tls.handshake.type

Which step of the TLS handshake this is.

Why it matters: Client Hello opens the negotiation; Server Hello answers it.

tls.handshake.length

The size of this handshake message.

tls.handshake.version

A legacy version field kept for compatibility. Real versions are offered in an extension.

tls.handshake.random

Random bytes that make each session's keys unique.

tls.handshake.ciphersuites

The encryption methods the client is willing to use, in order of preference.

Why it matters: If the server supports none of them, the handshake fails.

tls.handshake.ciphersuite

The encryption method the server picked from the client's list.

tls.handshake.extensions_server_name

Server Name Indication: the website name the client wants.

Why it matters: It's sent before encryption starts, so it's visible in captures even for HTTPS.

tls.handshake.extensions.supported_versions

The TLS versions the client can use.

Why it matters: If the server only accepts versions not in this list, the handshake fails.

tls.handshake.extensions.supported_version

The TLS version the server chose.

tls.alert_message.level

How serious the alert is. Fatal alerts end the connection immediately.

tls.alert_message.desc

Why the TLS connection is being stopped.

Why it matters: Handshake failure usually means the two sides share no TLS version or cipher.

tls.change_cipher_spec

Signals the switch to encrypted records.

Why it matters: In TLS 1.3 it's kept only for compatibility with older network equipment.

tls.app_data

Encrypted data. It can't be read without the session keys.

Why it matters: The capture shows its size and timing, but not its contents.

tls.record

A TLS record: the unit TLS uses to carry handshake messages, alerts, or encrypted data.

tls.stream

A number Wireshark gives each TLS session in the capture.

tls.record.opaque_type

The record type shown on the outside of encrypted TLS 1.3 records. It's always application data (23); the real type is hidden inside.

Why it matters: Hiding the real type makes traffic harder to fingerprint.

tls.app_data_proto

Wireshark's guess at the protocol inside the encryption, from the agreed application protocol.

tls.handshake

A TLS handshake message: the steps where both sides agree how to encrypt.

tls.handshake.legacy_version

A version field kept for compatibility with old software. Real versions are in an extension.

tls.handshake.session_id_length

The length of an identifier used to resume earlier sessions.

tls.handshake.comp_method

The compression method chosen. Always none in modern TLS.

Why it matters: Compression was removed because it enabled attacks.

tls.handshake.comp_methods

Compression methods offered. Modern clients offer only none.

tls.handshake.comp_methods_length

The length of the compression methods list.

tls.handshake.cipher_suites_length

The length of the cipher suites list.

tls.handshake.extensions_length

The total length of all extensions.

tls.handshake.extension

A TLS extension: an optional feature or setting offered in the handshake.

tls.handshake.extension.type

Which extension this is, such as server name or supported versions.

tls.handshake.extension.len

The length of this extension.

tls.handshake.random_time

Part of the random value. Older TLS put the time here; modern TLS uses random bytes.

tls.handshake.random_bytes

Random bytes that make each session's keys unique.

tls.handshake.extensions_server_name_list_len

The length of the server name list.

tls.handshake.extensions_server_name_type

The kind of server name. Always a host name.

tls.handshake.extensions_server_name_len

The length of the server name.

tls.handshake.extensions.supported_versions_len

The length of the supported versions list.

tls.handshake.extensions_padding_data

Filler that makes the Client Hello a fixed size.

Why it matters: Some older network equipment mishandles hellos of certain sizes.

tls.handshake.extensions_alpn_str

The application protocol requested inside TLS, such as h2 (HTTP/2) or http/1.1.

tls.handshake.ja3

A fingerprint of the client's TLS settings (JA3 hash).

Why it matters: Security tools use fingerprints to recognize software; many apps share the same one.

tls.handshake.ja3_full

The TLS settings the JA3 fingerprint is computed from.

tls.handshake.ja3s

A fingerprint of the server's TLS reply (JA3S hash).

tls.handshake.ja3s_full

The TLS settings the JA3S fingerprint is computed from.

tls.handshake.ja4

A newer, more readable fingerprint of the client's TLS settings (JA4).

tls.handshake.ja4_r

The raw values behind the JA4 fingerprint.

tls.handshake.certificate

A certificate the server presents to prove its identity.

Why it matters: Certificates can be read in TLS 1.2 captures; in TLS 1.3 they're encrypted.

tls.alert_message

A TLS alert: a warning or error that one side sends to the other.

Why it matters: Fatal alerts end the connection.