]> git.ipfire.org Git - people/pmueller/ipfire-2.x.git/blob - config/suricata/suricata.yaml
Bump PAK_VER for all packages that use SERVICES
[people/pmueller/ipfire-2.x.git] / config / suricata / suricata.yaml
1 %YAML 1.1
2 ---
3
4 ##
5 ## IPFire specific configuration file - an untouched example configuration
6 ## can be found in suricata-example.yaml.
7 ##
8
9 vars:
10 address-groups:
11 # Include HOME_NET declaration from external file.
12 include: /var/ipfire/suricata/suricata-homenet.yaml
13
14 # Include DNS_SERVERS declaration from external file.
15 include: /var/ipfire/suricata/suricata-dns-servers.yaml
16
17 EXTERNAL_NET: "any"
18
19 HTTP_SERVERS: "$HOME_NET"
20 SMTP_SERVERS: "$HOME_NET"
21 SQL_SERVERS: "$HOME_NET"
22 TELNET_SERVERS: "$HOME_NET"
23 AIM_SERVERS: "$EXTERNAL_NET"
24 DC_SERVERS: "$HOME_NET"
25 DNP3_SERVER: "$HOME_NET"
26 DNP3_CLIENT: "$HOME_NET"
27 MODBUS_CLIENT: "$HOME_NET"
28 MODBUS_SERVER: "$HOME_NET"
29 ENIP_CLIENT: "$HOME_NET"
30 ENIP_SERVER: "$HOME_NET"
31
32 port-groups:
33 # Incluse HTTP_PORTS declaration from external file.
34 include: /var/ipfire/suricata/suricata-http-ports.yaml
35
36 SHELLCODE_PORTS: "!80"
37 ORACLE_PORTS: 1521
38 SSH_PORTS: "[22,222]"
39 DNP3_PORTS: 20000
40 MODBUS_PORTS: 502
41 FILE_DATA_PORTS: "[$HTTP_PORTS,110,143]"
42 FTP_PORTS: 21
43
44 ##
45 ## Ruleset specific options.
46 ##
47 default-rule-path: /var/lib/suricata
48 rule-files:
49 # Include enabled ruleset files from external file.
50 include: /var/ipfire/suricata/suricata-used-rulesfiles.yaml
51
52 classification-file: /usr/share/suricata/classification.config
53 reference-config-file: /usr/share/suricata/reference.config
54 threshold-file: /usr/share/suricata/threshold.config
55
56 ##
57 ## Logging options.
58 ##
59 default-log-dir: /var/log/suricata/
60
61 # global stats configuration
62 stats:
63 enabled: no
64 # The interval field (in seconds) controls at what interval
65 # the loggers are invoked.
66 interval: 8
67
68 # Add decode events as stats.
69 #decoder-events: true
70 # Decoder event prefix in stats. Has been 'decoder' before, but that leads
71 # to missing events in the eve.stats records. See issue #2225.
72 decoder-events-prefix: "decoder.event"
73 # Add stream events as stats.
74 #stream-events: false
75
76 # Configure the type of alert (and other) logging you would like.
77 outputs:
78 # a line based alerts log similar to Snort's fast.log
79 - fast:
80 enabled: yes
81 filename: fast.log
82 append: yes
83 #filetype: regular # 'regular', 'unix_stream' or 'unix_dgram'
84
85 # Stats.log contains data from various counters of the suricata engine.
86 - stats:
87 enabled: no
88 filename: stats.log
89 append: no # append to file (yes) or overwrite it (no)
90 totals: yes # stats for all threads merged together
91 threads: no # per thread stats
92 #null-values: yes # print counters that have value 0
93
94 # Extensible Event Format (nicknamed EVE) event log in JSON format
95 - eve-log:
96 enabled: no
97 filetype: regular #regular|syslog|unix_dgram|unix_stream|redis
98 filename: eve.json
99 #prefix: "@cee: " # prefix to prepend to each log entry
100 # the following are valid when type: syslog above
101 #identity: "suricata"
102 #facility: local5
103 #level: Info ## possible levels: Emergency, Alert, Critical,
104 ## Error, Warning, Notice, Info, Debug
105 #redis:
106 # server: 127.0.0.1
107 # port: 6379
108 # async: true ## if redis replies are read asynchronously
109 # mode: list ## possible values: list|lpush (default), rpush, channel|publish
110 # ## lpush and rpush are using a Redis list. "list" is an alias for lpush
111 # ## publish is using a Redis channel. "channel" is an alias for publish
112 # key: suricata ## key or channel to use (default to suricata)
113 # Redis pipelining set up. This will enable to only do a query every
114 # 'batch-size' events. This should lower the latency induced by network
115 # connection at the cost of some memory. There is no flushing implemented
116 # so this setting as to be reserved to high traffic suricata.
117 # pipelining:
118 # enabled: yes ## set enable to yes to enable query pipelining
119 # batch-size: 10 ## number of entry to keep in buffer
120
121 # Include top level metadata. Default yes.
122 #metadata: no
123
124 # include the name of the input pcap file in pcap file processing mode
125 pcap-file: false
126
127 # Community Flow ID
128 # Adds a 'community_id' field to EVE records. These are meant to give
129 # a records a predictable flow id that can be used to match records to
130 # output of other tools such as Bro.
131 #
132 # Takes a 'seed' that needs to be same across sensors and tools
133 # to make the id less predictable.
134
135 # enable/disable the community id feature.
136 community-id: false
137 # Seed value for the ID output. Valid values are 0-65535.
138 community-id-seed: 0
139
140 # HTTP X-Forwarded-For support by adding an extra field or overwriting
141 # the source or destination IP address (depending on flow direction)
142 # with the one reported in the X-Forwarded-For HTTP header. This is
143 # helpful when reviewing alerts for traffic that is being reverse
144 # or forward proxied.
145 xff:
146 enabled: no
147 # Two operation modes are available, "extra-data" and "overwrite".
148 mode: extra-data
149 # Two proxy deployments are supported, "reverse" and "forward". In
150 # a "reverse" deployment the IP address used is the last one, in a
151 # "forward" deployment the first IP address is used.
152 deployment: reverse
153 # Header name where the actual IP address will be reported, if more
154 # than one IP address is present, the last IP address will be the
155 # one taken into consideration.
156 header: X-Forwarded-For
157
158 types:
159 - alert:
160 # payload: yes # enable dumping payload in Base64
161 # payload-buffer-size: 4kb # max size of payload buffer to output in eve-log
162 # payload-printable: yes # enable dumping payload in printable (lossy) format
163 # packet: yes # enable dumping of packet (without stream segments)
164 # metadata: no # enable inclusion of app layer metadata with alert. Default yes
165 # http-body: yes # Requires metadata; enable dumping of http body in Base64
166 # http-body-printable: yes # Requires metadata; enable dumping of http body in printable format
167
168 # Enable the logging of tagged packets for rules using the
169 # "tag" keyword.
170 tagged-packets: yes
171 - anomaly:
172 # Anomaly log records describe unexpected conditions such
173 # as truncated packets, packets with invalid IP/UDP/TCP
174 # length values, and other events that render the packet
175 # invalid for further processing or describe unexpected
176 # behavior on an established stream. Networks which
177 # experience high occurrences of anomalies may experience
178 # packet processing degradation.
179 #
180 # Anomalies are reported for the following:
181 # 1. Decode: Values and conditions that are detected while
182 # decoding individual packets. This includes invalid or
183 # unexpected values for low-level protocol lengths as well
184 # as stream related events (TCP 3-way handshake issues,
185 # unexpected sequence number, etc).
186 # 2. Stream: This includes stream related events (TCP
187 # 3-way handshake issues, unexpected sequence number,
188 # etc).
189 # 3. Application layer: These denote application layer
190 # specific conditions that are unexpected, invalid or are
191 # unexpected given the application monitoring state.
192 #
193 # By default, anomaly logging is disabled. When anomaly
194 # logging is enabled, applayer anomaly reporting is
195 # enabled.
196 enabled: yes
197 #
198 # Choose one or more types of anomaly logging and whether to enable
199 # logging of the packet header for packet anomalies.
200 types:
201 # decode: no
202 # stream: no
203 # applayer: yes
204 #packethdr: no
205 - http:
206 extended: yes # enable this for extended logging information
207 # custom allows additional http fields to be included in eve-log
208 # the example below adds three additional fields when uncommented
209 #custom: [Accept-Encoding, Accept-Language, Authorization]
210 # set this value to one and only one among {both, request, response}
211 # to dump all http headers for every http request and/or response
212 # dump-all-headers: none
213 - dns:
214 # This configuration uses the new DNS logging format,
215 # the old configuration is still available:
216 # https://suricata.readthedocs.io/en/latest/output/eve/eve-json-output.html#dns-v1-format
217
218 # As of Suricata 5.0, version 2 of the eve dns output
219 # format is the default.
220 #version: 2
221
222 # Enable/disable this logger. Default: enabled.
223 #enabled: yes
224
225 # Control logging of requests and responses:
226 # - requests: enable logging of DNS queries
227 # - responses: enable logging of DNS answers
228 # By default both requests and responses are logged.
229 #requests: no
230 #responses: no
231
232 # Format of answer logging:
233 # - detailed: array item per answer
234 # - grouped: answers aggregated by type
235 # Default: all
236 #formats: [detailed, grouped]
237
238 # Types to log, based on the query type.
239 # Default: all.
240 #types: [a, aaaa, cname, mx, ns, ptr, txt]
241 - tls:
242 extended: yes # enable this for extended logging information
243 # output TLS transaction where the session is resumed using a
244 # session id
245 #session-resumption: no
246 # custom allows to control which tls fields that are included
247 # in eve-log
248 #custom: [subject, issuer, session_resumed, serial, fingerprint, sni, version, not_before, not_after, certificate, chain, ja3, ja3s]
249 - files:
250 force-magic: no # force logging magic on all logged files
251 # force logging of checksums, available hash functions are md5,
252 # sha1 and sha256
253 #force-hash: [md5]
254 #- drop:
255 # alerts: yes # log alerts that caused drops
256 # flows: all # start or all: 'start' logs only a single drop
257 # # per flow direction. All logs each dropped pkt.
258 - smtp:
259 #extended: yes # enable this for extended logging information
260 # this includes: bcc, message-id, subject, x_mailer, user-agent
261 # custom fields logging from the list:
262 # reply-to, bcc, message-id, subject, x-mailer, user-agent, received,
263 # x-originating-ip, in-reply-to, references, importance, priority,
264 # sensitivity, organization, content-md5, date
265 #custom: [received, x-mailer, x-originating-ip, relays, reply-to, bcc]
266 # output md5 of fields: body, subject
267 # for the body you need to set app-layer.protocols.smtp.mime.body-md5
268 # to yes
269 #md5: [body, subject]
270
271 #- dnp3
272 - ftp
273 - rdp
274 - nfs
275 - smb
276 - tftp
277 - ikev2
278 - dcerpc
279 - krb5
280 - snmp
281 - rfb
282 - sip
283 - dhcp:
284 enabled: yes
285 # When extended mode is on, all DHCP messages are logged
286 # with full detail. When extended mode is off (the
287 # default), just enough information to map a MAC address
288 # to an IP address is logged.
289 extended: no
290 - ssh
291 - mqtt:
292 # passwords: yes # enable output of passwords
293 # HTTP2 logging. HTTP2 support is currently experimental and
294 # disabled by default. To enable, uncomment the following line
295 # and be sure to enable http2 in the app-layer section.
296 #- http2
297 - stats:
298 totals: yes # stats for all threads merged together
299 threads: no # per thread stats
300 deltas: no # include delta values
301 # bi-directional flows
302 - flow
303 # uni-directional flows
304 #- netflow
305
306 # Metadata event type. Triggered whenever a pktvar is saved
307 # and will include the pktvars, flowvars, flowbits and
308 # flowints.
309 #- metadata
310
311 logging:
312 # The default log level, can be overridden in an output section.
313 # Note that debug level logging will only be emitted if Suricata was
314 # compiled with the --enable-debug configure option.
315 #
316 # This value is overriden by the SC_LOG_LEVEL env var.
317 default-log-level: Info
318
319 # A regex to filter output. Can be overridden in an output section.
320 # Defaults to empty (no filter).
321 #
322 # This value is overriden by the SC_LOG_OP_FILTER env var.
323 default-output-filter:
324
325 # Define your logging outputs. If none are defined, or they are all
326 # disabled you will get the default - console output.
327 outputs:
328 - console:
329 enabled: no
330 # type: json
331 - file:
332 enabled: no
333 level: info
334 filename: /var/log/suricata/suricata.log
335 # type: json
336 - syslog:
337 enabled: yes
338 facility: local5
339 format: ""
340 # type: json
341
342 ##
343 ## Netfilter configuration
344 ##
345
346 nfq:
347 mode: repeat
348 repeat-mark: 2147483648
349 repeat-mask: 2147483648
350 bypass-mark: 1073741824
351 bypass-mask: 1073741824
352 # route-queue: 2
353 # batchcount: 20
354 fail-open: yes
355
356 ##
357 ## Step 5: App Layer Protocol Configuration
358 ##
359
360 # Configure the app-layer parsers. The protocols section details each
361 # protocol.
362 #
363 # The option "enabled" takes 3 values - "yes", "no", "detection-only".
364 # "yes" enables both detection and the parser, "no" disables both, and
365 # "detection-only" enables protocol detection only (parser disabled).
366 app-layer:
367 protocols:
368 rfb:
369 enabled: yes
370 detection-ports:
371 dp: 5900, 5901, 5902, 5903, 5904, 5905, 5906, 5907, 5908, 5909
372 # MQTT, disabled by default.
373 mqtt:
374 # enabled: no
375 # max-msg-length: 1mb
376 krb5:
377 enabled: yes
378 snmp:
379 enabled: yes
380 ikev2:
381 enabled: yes
382 tls:
383 enabled: yes
384 detection-ports:
385 dp: "[443,444,465,853,993,995]"
386
387 # Generate JA3 fingerprint from client hello. If not specified it
388 # will be disabled by default, but enabled if rules require it.
389 ja3-fingerprints: auto
390
391 # What to do when the encrypted communications start:
392 # - default: keep tracking TLS session, check for protocol anomalies,
393 # inspect tls_* keywords. Disables inspection of unmodified
394 # 'content' signatures.
395 # - bypass: stop processing this flow as much as possible. No further
396 # TLS parsing and inspection. Offload flow bypass to kernel
397 # or hardware if possible.
398 # - full: keep tracking and inspection as normal. Unmodified content
399 # keyword signatures are inspected as well.
400 #
401 # For best performance, select 'bypass'.
402 #
403 encryption-handling: bypass
404 dcerpc:
405 enabled: yes
406 ftp:
407 enabled: yes
408 rdp:
409 enabled: yes
410 ssh:
411 enabled: yes
412 #hassh: yes
413 # HTTP2: Experimental HTTP 2 support. Disabled by default.
414 http2:
415 enabled: no
416 smtp:
417 enabled: yes
418 # Configure SMTP-MIME Decoder
419 mime:
420 # Decode MIME messages from SMTP transactions
421 # (may be resource intensive)
422 # This field supercedes all others because it turns the entire
423 # process on or off
424 decode-mime: yes
425
426 # Decode MIME entity bodies (ie. base64, quoted-printable, etc.)
427 decode-base64: yes
428 decode-quoted-printable: yes
429
430 # Maximum bytes per header data value stored in the data structure
431 # (default is 2000)
432 header-value-depth: 2000
433
434 # Extract URLs and save in state data structure
435 extract-urls: yes
436 # Set to yes to compute the md5 of the mail body. You will then
437 # be able to journalize it.
438 body-md5: no
439 # Configure inspected-tracker for file_data keyword
440 inspected-tracker:
441 content-limit: 100000
442 content-inspect-min-size: 32768
443 content-inspect-window: 4096
444 imap:
445 enabled: yes
446 msn:
447 enabled: yes
448 smb:
449 enabled: yes
450 detection-ports:
451 dp: 139, 445
452 nfs:
453 enabled: yes
454 tftp:
455 enabled: yes
456 dns:
457 # memcaps. Globally and per flow/state.
458 global-memcap: 32mb
459 state-memcap: 512kb
460
461 # How many unreplied DNS requests are considered a flood.
462 # If the limit is reached, app-layer-event:dns.flooded; will match.
463 #request-flood: 512
464
465 tcp:
466 enabled: yes
467 detection-ports:
468 dp: 53
469 udp:
470 enabled: yes
471 detection-ports:
472 dp: 53
473 http:
474 enabled: yes
475 memcap: 256mb
476
477 # default-config: Used when no server-config matches
478 # personality: List of personalities used by default
479 # request-body-limit: Limit reassembly of request body for inspection
480 # by http_client_body & pcre /P option.
481 # response-body-limit: Limit reassembly of response body for inspection
482 # by file_data, http_server_body & pcre /Q option.
483 # double-decode-path: Double decode path section of the URI
484 # double-decode-query: Double decode query section of the URI
485 # response-body-decompress-layer-limit:
486 # Limit to how many layers of compression will be
487 # decompressed. Defaults to 2.
488 #
489 # Currently Available Personalities:
490 # Minimal, Generic, IDS (default), IIS_4_0, IIS_5_0, IIS_5_1, IIS_6_0,
491 # IIS_7_0, IIS_7_5, Apache_2
492 libhtp:
493 default-config:
494 personality: IDS
495
496 # Can be specified in kb, mb, gb. Just a number indicates
497 # it's in bytes.
498 request-body-limit: 0
499 response-body-limit: 0
500
501 # response body decompression (0 disables)
502 response-body-decompress-layer-limit: 2
503
504 # auto will use http-body-inline mode in IPS mode, yes or no set it statically
505 http-body-inline: auto
506
507 # Take a random value for inspection sizes around the specified value.
508 # This lower the risk of some evasion technics but could lead
509 # detection change between runs. It is set to 'yes' by default.
510 randomize-inspection-sizes: yes
511 # If randomize-inspection-sizes is active, the value of various
512 # inspection size will be choosen in the [1 - range%, 1 + range%]
513 # range
514 # Default value of randomize-inspection-range is 10.
515 randomize-inspection-range: 10
516
517 # decoding
518 double-decode-path: no
519 double-decode-query: no
520
521 # Note: Modbus probe parser is minimalist due to the poor significant field
522 # Only Modbus message length (greater than Modbus header length)
523 # And Protocol ID (equal to 0) are checked in probing parser
524 # It is important to enable detection port and define Modbus port
525 # to avoid false positive
526 modbus:
527 # How many unreplied Modbus requests are considered a flood.
528 # If the limit is reached, app-layer-event:modbus.flooded; will match.
529 #request-flood: 500
530
531 enabled: no
532 detection-ports:
533 dp: 502
534 # According to MODBUS Messaging on TCP/IP Implementation Guide V1.0b, it
535 # is recommended to keep the TCP connection opened with a remote device
536 # and not to open and close it for each MODBUS/TCP transaction. In that
537 # case, it is important to set the depth of the stream reassembling as
538 # unlimited (stream.reassembly.depth: 0)
539
540 # Stream reassembly size for modbus. By default track it completely.
541 stream-depth: 0
542
543 # DNP3
544 dnp3:
545 enabled: no
546 detection-ports:
547 dp: 20000
548
549 # SCADA EtherNet/IP and CIP protocol support
550 enip:
551 enabled: no
552 detection-ports:
553 dp: 44818
554 sp: 44818
555
556 ntp:
557 enabled: yes
558 dhcp:
559 enabled: yes
560 sip:
561 enabled: yes
562
563 # Limit for the maximum number of asn1 frames to decode (default 256)
564 asn1-max-frames: 256
565
566
567 ##############################################################################
568 ##
569 ## Advanced settings below
570 ##
571 ##############################################################################
572
573 ##
574 ## Run Options
575 ##
576
577 # Run suricata as user and group.
578 run-as:
579 user: suricata
580 group: suricata
581
582 # Suricata core dump configuration. Limits the size of the core dump file to
583 # approximately max-dump. The actual core dump size will be a multiple of the
584 # page size. Core dumps that would be larger than max-dump are truncated. On
585 # Linux, the actual core dump size may be a few pages larger than max-dump.
586 # Setting max-dump to 0 disables core dumping.
587 # Setting max-dump to 'unlimited' will give the full core dump file.
588 # On 32-bit Linux, a max-dump value >= ULONG_MAX may cause the core dump size
589 # to be 'unlimited'.
590
591 coredump:
592 max-dump: unlimited
593
594 # If suricata box is a router for the sniffed networks, set it to 'router'. If
595 # it is a pure sniffing setup, set it to 'sniffer-only'.
596 # If set to auto, the variable is internally switch to 'router' in IPS mode
597 # and 'sniffer-only' in IDS mode.
598 # This feature is currently only used by the reject* keywords.
599 host-mode: auto
600
601 # Number of packets preallocated per thread. The default is 1024. A higher number
602 # will make sure each CPU will be more easily kept busy, but may negatively
603 # impact caching.
604 max-pending-packets: 1024
605
606 # Runmode the engine should use. Please check --list-runmodes to get the available
607 # runmodes for each packet acquisition method. Defaults to "autofp" (auto flow pinned
608 # load balancing).
609 runmode: workers
610
611 # Specifies the kind of flow load balancer used by the flow pinned autofp mode.
612 #
613 # Supported schedulers are:
614 #
615 # round-robin - Flows assigned to threads in a round robin fashion.
616 # active-packets - Flows assigned to threads that have the lowest number of
617 # unprocessed packets (default).
618 # hash - Flow alloted usihng the address hash. More of a random
619 # technique. Was the default in Suricata 1.2.1 and older.
620 #
621 #autofp-scheduler: active-packets
622
623 # Preallocated size for packet. Default is 1514 which is the classical
624 # size for pcap on ethernet. You should adjust this value to the highest
625 # packet size (MTU + hardware header) on your system.
626 default-packet-size: 1514
627
628 # Unix command socket can be used to pass commands to suricata.
629 # An external tool can then connect to get information from suricata
630 # or trigger some modifications of the engine. Set enabled to yes
631 # to activate the feature. In auto mode, the feature will only be
632 # activated in live capture mode. You can use the filename variable to set
633 # the file name of the socket.
634 unix-command:
635 enabled: no
636 #filename: custom.socket
637
638 # Magic file
639 magic-file: /usr/share/misc/magic.mgc
640
641 legacy:
642 uricontent: enabled
643
644 ##
645 ## Detection settings
646 ##
647
648 # Set the order of alerts bassed on actions
649 # The default order is pass, drop, reject, alert
650 # action-order:
651 # - pass
652 # - drop
653 # - reject
654 # - alert
655
656 # When run with the option --engine-analysis, the engine will read each of
657 # the parameters below, and print reports for each of the enabled sections
658 # and exit. The reports are printed to a file in the default log dir
659 # given by the parameter "default-log-dir", with engine reporting
660 # subsection below printing reports in its own report file.
661 engine-analysis:
662 # enables printing reports for fast-pattern for every rule.
663 rules-fast-pattern: yes
664 # enables printing reports for each rule
665 rules: yes
666
667 #recursion and match limits for PCRE where supported
668 pcre:
669 match-limit: 3500
670 match-limit-recursion: 1500
671
672 ##
673 ## Advanced Traffic Tracking and Reconstruction Settings
674 ##
675
676 # Host specific policies for defragmentation and TCP stream
677 # reassembly. The host OS lookup is done using a radix tree, just
678 # like a routing table so the most specific entry matches.
679 host-os-policy:
680 # Make the default policy windows.
681 windows: [0.0.0.0/0]
682 bsd: []
683 bsd-right: []
684 old-linux: []
685 linux: []
686 old-solaris: []
687 solaris: []
688 hpux10: []
689 hpux11: []
690 irix: []
691 macos: []
692 vista: []
693 windows2k3: []
694
695 # Defrag settings:
696
697 defrag:
698 memcap: 64mb
699 hash-size: 65536
700 trackers: 65535 # number of defragmented flows to follow
701 max-frags: 65535 # number of fragments to keep (higher than trackers)
702 prealloc: yes
703 timeout: 60
704
705 # Flow settings:
706 # By default, the reserved memory (memcap) for flows is 32MB. This is the limit
707 # for flow allocation inside the engine. You can change this value to allow
708 # more memory usage for flows.
709 # The hash-size determine the size of the hash used to identify flows inside
710 # the engine, and by default the value is 65536.
711 # At the startup, the engine can preallocate a number of flows, to get a better
712 # performance. The number of flows preallocated is 10000 by default.
713 # emergency-recovery is the percentage of flows that the engine need to
714 # prune before unsetting the emergency state. The emergency state is activated
715 # when the memcap limit is reached, allowing to create new flows, but
716 # prunning them with the emergency timeouts (they are defined below).
717 # If the memcap is reached, the engine will try to prune flows
718 # with the default timeouts. If it doens't find a flow to prune, it will set
719 # the emergency bit and it will try again with more agressive timeouts.
720 # If that doesn't work, then it will try to kill the last time seen flows
721 # not in use.
722 # The memcap can be specified in kb, mb, gb. Just a number indicates it's
723 # in bytes.
724
725 flow:
726 memcap: 256mb
727 hash-size: 65536
728 prealloc: 10000
729 emergency-recovery: 30
730 managers: 1
731 recyclers: 1
732
733 # This option controls the use of vlan ids in the flow (and defrag)
734 # hashing. Normally this should be enabled, but in some (broken)
735 # setups where both sides of a flow are not tagged with the same vlan
736 # tag, we can ignore the vlan id's in the flow hashing.
737 vlan:
738 use-for-tracking: true
739
740 # Specific timeouts for flows. Here you can specify the timeouts that the
741 # active flows will wait to transit from the current state to another, on each
742 # protocol. The value of "new" determine the seconds to wait after a hanshake or
743 # stream startup before the engine free the data of that flow it doesn't
744 # change the state to established (usually if we don't receive more packets
745 # of that flow). The value of "established" is the amount of
746 # seconds that the engine will wait to free the flow if it spend that amount
747 # without receiving new packets or closing the connection. "closed" is the
748 # amount of time to wait after a flow is closed (usually zero). "bypassed"
749 # timeout controls locally bypassed flows. For these flows we don't do any other
750 # tracking. If no packets have been seen after this timeout, the flow is discarded.
751 #
752 # There's an emergency mode that will become active under attack circumstances,
753 # making the engine to check flow status faster. This configuration variables
754 # use the prefix "emergency-" and work similar as the normal ones.
755 # Some timeouts doesn't apply to all the protocols, like "closed", for udp and
756 # icmp.
757
758 flow-timeouts:
759
760 default:
761 new: 30
762 established: 300
763 closed: 0
764 bypassed: 100
765 emergency-new: 10
766 emergency-established: 100
767 emergency-closed: 0
768 emergency-bypassed: 50
769 tcp:
770 new: 60
771 established: 600
772 closed: 60
773 bypassed: 100
774 emergency-new: 5
775 emergency-established: 100
776 emergency-closed: 10
777 emergency-bypassed: 50
778 udp:
779 new: 30
780 established: 300
781 bypassed: 100
782 emergency-new: 10
783 emergency-established: 100
784 emergency-bypassed: 50
785 icmp:
786 new: 30
787 established: 300
788 bypassed: 100
789 emergency-new: 10
790 emergency-established: 100
791 emergency-bypassed: 50
792
793 # Stream engine settings. Here the TCP stream tracking and reassembly
794 # engine is configured.
795 #
796 # stream:
797 # memcap: 32mb # Can be specified in kb, mb, gb. Just a
798 # # number indicates it's in bytes.
799 # checksum-validation: yes # To validate the checksum of received
800 # # packet. If csum validation is specified as
801 # # "yes", then packet with invalid csum will not
802 # # be processed by the engine stream/app layer.
803 # # Warning: locally generated trafic can be
804 # # generated without checksum due to hardware offload
805 # # of checksum. You can control the handling of checksum
806 # # on a per-interface basis via the 'checksum-checks'
807 # # option
808 # prealloc-sessions: 2k # 2k sessions prealloc'd per stream thread
809 # midstream: false # don't allow midstream session pickups
810 # async-oneside: false # don't enable async stream handling
811 # inline: no # stream inline mode
812 # drop-invalid: yes # in inline mode, drop packets that are invalid with regards to streaming engine
813 # max-synack-queued: 5 # Max different SYN/ACKs to queue
814 # bypass: no # Bypass packets when stream.depth is reached
815 #
816 # reassembly:
817 # memcap: 64mb # Can be specified in kb, mb, gb. Just a number
818 # # indicates it's in bytes.
819 # depth: 1mb # Can be specified in kb, mb, gb. Just a number
820 # # indicates it's in bytes.
821 # toserver-chunk-size: 2560 # inspect raw stream in chunks of at least
822 # # this size. Can be specified in kb, mb,
823 # # gb. Just a number indicates it's in bytes.
824 # toclient-chunk-size: 2560 # inspect raw stream in chunks of at least
825 # # this size. Can be specified in kb, mb,
826 # # gb. Just a number indicates it's in bytes.
827 # randomize-chunk-size: yes # Take a random value for chunk size around the specified value.
828 # # This lower the risk of some evasion technics but could lead
829 # # detection change between runs. It is set to 'yes' by default.
830 # randomize-chunk-range: 10 # If randomize-chunk-size is active, the value of chunk-size is
831 # # a random value between (1 - randomize-chunk-range/100)*toserver-chunk-size
832 # # and (1 + randomize-chunk-range/100)*toserver-chunk-size and the same
833 # # calculation for toclient-chunk-size.
834 # # Default value of randomize-chunk-range is 10.
835 #
836 # raw: yes # 'Raw' reassembly enabled or disabled.
837 # # raw is for content inspection by detection
838 # # engine.
839 #
840 # segment-prealloc: 2048 # number of segments preallocated per thread
841 #
842 # check-overlap-different-data: true|false
843 # # check if a segment contains different data
844 # # than what we've already seen for that
845 # # position in the stream.
846 # # This is enabled automatically if inline mode
847 # # is used or when stream-event:reassembly_overlap_different_data;
848 # # is used in a rule.
849 #
850 stream:
851 memcap: 256mb
852 prealloc-sessions: 4096
853 checksum-validation: yes # reject wrong csums
854 inline: auto # auto will use inline mode in IPS mode, yes or no set it statically
855 bypass: yes # Bypass packets when stream.reassembly.depth is reached.
856 reassembly:
857 memcap: 256mb
858 depth: 1mb # reassemble 1mb into a stream
859 toserver-chunk-size: 2560
860 toclient-chunk-size: 2560
861 randomize-chunk-size: yes
862 raw: yes
863 segment-prealloc: 2048
864 check-overlap-different-data: true
865
866 # Host table:
867 #
868 # Host table is used by tagging and per host thresholding subsystems.
869 #
870 host:
871 hash-size: 4096
872 prealloc: 1000
873 memcap: 32mb
874
875 # IP Pair table:
876 #
877 # Used by xbits 'ippair' tracking.
878 #
879 #ippair:
880 # hash-size: 4096
881 # prealloc: 1000
882 # memcap: 32mb
883
884 # Decoder settings
885
886 decoder:
887 # Teredo decoder is known to not be completely accurate
888 # it will sometimes detect non-teredo as teredo.
889 teredo:
890 enabled: false
891
892
893 ##
894 ## Performance tuning and profiling
895 ##
896
897 # The detection engine builds internal groups of signatures. The engine
898 # allow us to specify the profile to use for them, to manage memory on an
899 # efficient way keeping a good performance. For the profile keyword you
900 # can use the words "low", "medium", "high" or "custom". If you use custom
901 # make sure to define the values at "- custom-values" as your convenience.
902 # Usually you would prefer medium/high/low.
903 #
904 # "sgh mpm-context", indicates how the staging should allot mpm contexts for
905 # the signature groups. "single" indicates the use of a single context for
906 # all the signature group heads. "full" indicates a mpm-context for each
907 # group head. "auto" lets the engine decide the distribution of contexts
908 # based on the information the engine gathers on the patterns from each
909 # group head.
910 #
911 # The option inspection-recursion-limit is used to limit the recursive calls
912 # in the content inspection code. For certain payload-sig combinations, we
913 # might end up taking too much time in the content inspection code.
914 # If the argument specified is 0, the engine uses an internally defined
915 # default limit. On not specifying a value, we use no limits on the recursion.
916 detect:
917 profile: custom
918 custom-values:
919 toclient-groups: 200
920 toserver-groups: 200
921 sgh-mpm-context: auto
922 inspection-recursion-limit: 3000
923
924 # If set to yes, the loading of signatures will be made after the capture
925 # is started. This will limit the downtime in IPS mode.
926 delayed-detect: yes
927
928 prefilter:
929 # default prefiltering setting. "mpm" only creates MPM/fast_pattern
930 # engines. "auto" also sets up prefilter engines for other keywords.
931 # Use --list-keywords=all to see which keywords support prefiltering.
932 default: mpm
933
934 # the grouping values above control how many groups are created per
935 # direction. Port whitelisting forces that port to get it's own group.
936 # Very common ports will benefit, as well as ports with many expensive
937 # rules.
938 grouping:
939 #tcp-whitelist: 53, 80, 139, 443, 445, 1433, 3306, 3389, 6666, 6667, 8080
940 #udp-whitelist: 53, 135, 5060
941
942 profiling:
943 # Log the rules that made it past the prefilter stage, per packet
944 # default is off. The threshold setting determines how many rules
945 # must have made it past pre-filter for that rule to trigger the
946 # logging.
947 #inspect-logging-threshold: 200
948 grouping:
949 dump-to-disk: false
950 include-rules: false # very verbose
951 include-mpm-stats: false
952
953 # Select the multi pattern algorithm you want to run for scan/search the
954 # in the engine.
955 #
956 # The supported algorithms are:
957 # "ac" - Aho-Corasick, default implementation
958 # "ac-bs" - Aho-Corasick, reduced memory implementation
959 # "ac-cuda" - Aho-Corasick, CUDA implementation
960 # "ac-ks" - Aho-Corasick, "Ken Steele" variant
961 # "hs" - Hyperscan, available when built with Hyperscan support
962 #
963 # The default mpm-algo value of "auto" will use "hs" if Hyperscan is
964 # available, "ac" otherwise.
965 #
966 # The mpm you choose also decides the distribution of mpm contexts for
967 # signature groups, specified by the conf - "detect.sgh-mpm-context".
968 # Selecting "ac" as the mpm would require "detect.sgh-mpm-context"
969 # to be set to "single", because of ac's memory requirements, unless the
970 # ruleset is small enough to fit in one's memory, in which case one can
971 # use "full" with "ac". Rest of the mpms can be run in "full" mode.
972 #
973 # There is also a CUDA pattern matcher (only available if Suricata was
974 # compiled with --enable-cuda: b2g_cuda. Make sure to update your
975 # max-pending-packets setting above as well if you use b2g_cuda.
976
977 mpm-algo: auto
978
979 # Select the matching algorithm you want to use for single-pattern searches.
980 #
981 # Supported algorithms are "bm" (Boyer-Moore) and "hs" (Hyperscan, only
982 # available if Suricata has been built with Hyperscan support).
983 #
984 # The default of "auto" will use "hs" if available, otherwise "bm".
985
986 spm-algo: auto
987
988 # Suricata is multi-threaded. Here the threading can be influenced.
989 threading:
990 set-cpu-affinity: no
991 # Tune cpu affinity of threads. Each family of threads can be bound
992 # on specific CPUs.
993 #
994 # These 2 apply to the all runmodes:
995 # management-cpu-set is used for flow timeout handling, counters
996 # worker-cpu-set is used for 'worker' threads
997 #
998 # Additionally, for autofp these apply:
999 # receive-cpu-set is used for capture threads
1000 # verdict-cpu-set is used for IPS verdict threads
1001 #
1002 cpu-affinity:
1003 - management-cpu-set:
1004 cpu: [ 0 ] # include only these cpus in affinity settings
1005 - receive-cpu-set:
1006 cpu: [ 0 ] # include only these cpus in affinity settings
1007 - worker-cpu-set:
1008 cpu: [ "all" ]
1009 mode: "exclusive"
1010 prio:
1011 low: [ 0 ]
1012 medium: [ "1-2" ]
1013 high: [ 3 ]
1014 default: "medium"
1015 - verdict-cpu-set:
1016 cpu: [ 0 ]
1017 prio:
1018 default: "high"
1019 #
1020 # By default Suricata creates one "detect" thread per available CPU/CPU core.
1021 # This setting allows controlling this behaviour. A ratio setting of 2 will
1022 # create 2 detect threads for each CPU/CPU core. So for a dual core CPU this
1023 # will result in 4 detect threads. If values below 1 are used, less threads
1024 # are created. So on a dual core CPU a setting of 0.5 results in 1 detect
1025 # thread being created. Regardless of the setting at a minimum 1 detect
1026 # thread will always be created.
1027 #
1028 detect-thread-ratio: 1.0