-
Notifications
You must be signed in to change notification settings - Fork 70
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add a section on quic to the ssl.rst file
Align code block with indenting in this section Add bold typeface to emphasize server name in TLS 1.3 Modified conclusion for ldap.log Add quic.rst Add quic.log to TOC Add missing char to ssl.log Add Arne's feedback
- Loading branch information
Matti Bispham
committed
Dec 29, 2023
1 parent
e86e8ee
commit 1969a87
Showing
3 changed files
with
102 additions
and
7 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -21,6 +21,7 @@ Zeek Logs | |
irc | ||
rdp | ||
ldap | ||
quic | ||
traceroute | ||
tunnel | ||
dpd | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,97 @@ | ||
==== | ||
QUIC | ||
==== | ||
|
||
.. versionadded:: 6.1 | ||
|
||
The QUIC protocol integrates encryption, stream multiplexing and flow control at | ||
the transport layer. QUIC uses TLS 1.3 by default. Zeek's QUIC analyzer | ||
provides greater observability into the protocols TLS handshake. | ||
|
||
|
||
quic.log | ||
======== | ||
|
||
An example of a :file:`quic.log`. | ||
|
||
.. code-block:: console | ||
[email protected]:~ zeek -C LogAscii::use_json=T -r chromium-115.0.5790.110-api-cirrus-com.pcap | ||
[email protected]:~ jq . quic.log | ||
:: | ||
|
||
{ | ||
"ts": 1692198386.837988, | ||
"uid": "CA482y1XJVd3d0RYI7", | ||
"id.orig_h": "82.239.54.117", | ||
"id.orig_p": 53727, | ||
"id.resp_h": "110.213.53.115", | ||
"id.resp_p": 443, | ||
"version": "1", | ||
"client_initial_dcid": "95412c47018cdfe8", | ||
"server_scid": "d5412c47018cdfe8", | ||
"server_name": "api.cirrus-ci.com", | ||
"client_protocol": "h3", | ||
"history": "ISisH" | ||
} | ||
|
||
|
||
QUIC Info | ||
========= | ||
|
||
:zeek:see:`QUIC::Info` provides further details on the current output of the | ||
:file:`quic.log`. Current fields include: | ||
|
||
- **version**: The version of QUIC that was identified. Note, QUICv2 has not | ||
been widely tested. | ||
|
||
|
||
- **client_initial_dcid**: When QUIC initiates a connection it uses Random | ||
Number Generators to create the first Destination Connection ID (DCID). This | ||
DCID is subsequently used for routing and packet protection by client and | ||
server. | ||
|
||
|
||
- **server_scid**: A QUIC supported server responds to a DCID by | ||
selecting a Source Connection ID (SCID). This usually occurs within the | ||
server’s first INITIAL packet. This is typically used by the client in | ||
subsequent packets, although the SCID can change to adapt to new network | ||
conditions. | ||
|
||
|
||
- **client_protocol**: If the ClientHello packet is successfully extracted | ||
and contains the ALPN extension, the extension's first entry is placed in | ||
client_protocol. | ||
|
||
|
||
- **history**: An experimental feature provides a history of the QUIC | ||
protocol usage. In the example above the history outlines: | ||
|
||
+ An initial packet from the client (I) - a new connection | ||
|
||
|
||
+ An TLS ClientHello from the client (S) - the start of a | ||
TLS handshake | ||
|
||
|
||
+ An initial packet response from the server (i) - an acknowledgement | ||
from the server of the new connection | ||
|
||
|
||
+ A TLS ServerHello response from the server (s) - the | ||
selection of a cipher suite from the options provided by the | ||
client | ||
|
||
+ A handshake packet from the client (H) | ||
|
||
|
||
|
||
Conclusion | ||
========== | ||
|
||
The QUIC analyzer is an initial attempt to provide observability into QUIC | ||
network traffic. In Zeek 6.1, although included by default, the QUIC analyzer is | ||
still considered experimental. Contributions, feedback and issues can be reported | ||
via [Github, Slack or the forum] (https://zeek.org/community/). | ||
|