summaryrefslogtreecommitdiffstats
path: root/doc/userguide/rules/quic-keywords.rst
blob: ffeb0be65254a6a42757e4f505050de52e57b584 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
Quic Keywords
=============

Suricata implements initial support for Quic by parsing the Quic version.

Suricata also derives a CYU hash for earlier versions of Quic.

Quic app-layer parsing must be enabled in the Suricata config file (set 'app-layer.protocols.quic.enabled' to 'yes').

quic.cyu.hash
---------------

Match on the CYU hash

Examples::

  alert quic any any -> any any (msg:"QUIC CYU HASH"; \
    quic.cyu.hash; content:"7b3ceb1adc974ad360cfa634e8d0a730"; \
    sid:1;)

``quic.cyu.hash`` supports multiple buffer matching, see :doc:`multi-buffer-matching`.

quic.cyu.string
---------------

Match on the CYU string

Examples::

  alert quic any any -> any any (msg:"QUIC CYU STRING"; \
    quic.cyu.string; content:"46,PAD-SNI-VER-CCS-UAID-TCID-PDMD-SMHL-ICSL-NONP-MIDS-SCLS-CSCT-COPT-IRTT-CFCW-SFCW"; \
    sid:2;)

``quic.cyu.string`` supports multiple buffer matching, see :doc:`multi-buffer-matching`.

quic.version
------------

Sticky buffer for matching on the Quic header version in long headers.

Examples::

  alert quic any any -> any any (msg:"QUIC VERSION"; \
    quic.version; content:"Q046"; \
    sid:3;)

Additional information
----------------------

More information on CYU Hash can be found here:
`<https://engineering.salesforce.com/gquic-protocol-analysis-and-fingerprinting-in-zeek-a4178855d75f>`_

More information on the protocol can be found here:
`<https://datatracker.ietf.org/doc/html/draft-ietf-quic-transport-17>`_