Contents
Suricata
SURICATA IDS/IPS is an open source IDS that monitors communications on the network and detects suspicious traffic.
The basic mechanism is signature-based, so it can detect predefined unauthorized communications. Suricata is also characterized by its ability to provide protection as well as detection.
1.advance preparation
①Activate the EPEL Repository
|
1 |
# dnf -y install epel-release |
②System updates
|
1 |
# dnf update -y |
2.Suricata Installation and Configuration
①Suricata Install
|
1 2 3 4 5 |
# dnf -y install suricata Check Version # suricata -V This is Suricata version 6.0.20 RELEASE |
②Determine interface and IP address where Suricata will inspect network packets
|
1 2 3 |
# ip --brief add lo UNKNOWN 127.0.0.1/8 ::1/128 ens160 UP 192.168.11.83/24 |
③Edit configuration file
|
1 2 3 4 5 6 7 8 9 |
# vi /etc/suricata/suricata.yaml # Line 15 : In the "vars" section, define the network HOME_NET: "[192.168.11.0/24]" EXTRNAL_NET: "!$HOME_NET" # Line 595 : Set interface name in "af-packet" section af-packet: - interface: ens160 |
|
1 2 3 4 5 |
# vi /etc/sysconfig/suricata # Line 8 :Specify interface # Add options to be passed to the daemon OPTIONS="-i ens160 --user suricata " |
④Suricata rules update
|
1 2 3 4 5 6 7 |
# suricata-update ---------------------------------------------- 15/10/2024 -- 10:57:46 - <Info> -- Writing rules to /var/lib/suricata/rules/suricata.rules: total: 53357; enabled: 39871; added: 53357; removed 0; modified: 0 15/10/2024 -- 10:57:47 - <Info> -- Writing /var/lib/suricata/rules/classification.config 15/10/2024 -- 10:57:47 - <Info> -- Testing with suricata -T. 15/10/2024 -- 10:58:15 - <Info> -- Done. |
⑤Activate Suricata
|
1 2 |
# systemctl enable --now suricata Created symlink /etc/systemd/system/multiuser.target.wants/suricata.service → /usr/lib/systemd/system/suricata.service. |
⑥Confirm Suricata startup
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
# systemctl status suricata ● suricata.service - Suricata Intrusion Detection Service Loaded: loaded (/usr/lib/systemd/system/suricata.service; enabled; vendor preset: disabled) Active: active (running) since Tue 2024-10-15 10:59:04 JST; 10s ago Docs: man:suricata(1) Process: 11078 ExecStartPre=/bin/rm -f /var/run/suricata.pid (code=exited, status=0/SUCCESS) Main PID: 11080 (Suricata-Main) Tasks: 1 (limit: 16915) Memory: 237.1M CGroup: /system.slice/suricata.service └─11080 /sbin/suricata -c /etc/suricata/suricata.yaml --pidfile /var/run/suricata.pid -i ens160 --user suricata Oct 15 10:59:04 Lepard systemd[1]: Starting Suricata Intrusion Detection Service... Oct 15 10:59:04 Lepard systemd[1]: Started Suricata Intrusion Detection Service. Oct 15 10:59:04 Lepard suricata[11080]: 15/10/2024 -- 10:59:04 - <Notice> - This is Suricata version 6.0.20 RELEASE running in SYSTEM mode |
Check Log
|
1 2 3 4 5 6 7 8 9 10 11 |
# tail /var/log/suricata/suricata.log 15/10/2024 -- 10:59:04 - <Info> - stats output device (regular) initialized: stats.log 15/10/2024 -- 10:59:04 - <Info> - Running in live mode, activating unix socket 15/10/2024 -- 10:59:18 - <Info> - 1 rule files processed. 39871 rules successfully loaded, 0 rules failed 15/10/2024 -- 10:59:18 - <Info> - Threshold config parsed: 0 rule(s) found 15/10/2024 -- 10:59:19 - <Info> - 39874 signatures processed. 1237 are IP-only rules, 4871 are inspecting packet payload, 33562 inspect application layer, 108 are decoder event only 15/10/2024 -- 10:59:34 - <Info> - Going to use 2 thread(s) 15/10/2024 -- 10:59:34 - <Info> - Running in live mode, activating unix socket 15/10/2024 -- 10:59:34 - <Info> - Using unix socket file '/var/run/suricata/suricata-command.socket' 15/10/2024 -- 10:59:34 - <Notice> - all 2 packet processing threads, 4 management threads initialized, engine started. 15/10/2024 -- 10:59:34 - <Info> - All AFP capture threads are running. |
Check the stats.log file for statistics (updated every 8 seconds by default)
|
1 |
# tail -f /var/log/suricata/stats.log |
A more advanced output, EVE JSON, can be generated with the following command
|
1 |
# tail -f /var/log/suricata/eve.json |
3.Suricata Testing
①Run ping test with curl utility
|
1 2 |
# curl http://testmynids.org/uid/index.html uid=0(root) gid=0(root) groups=0(root) |
②Check the alert log to see if it has been logged
|
1 2 |
# cat /var/log/suricata/fast.log 10/15/2024-11:02:12.761797 [**] [1:2100498:7] GPL ATTACK_RESPONSE id check returned root [**] [Classification: Potentially Bad Traffic] [Priority: 2] {TCP} 18.65.159.104:80 -> 192.168.11.83:39722 |
4.Setting Suricata Rules
①Display of rule sets packaged in Suricata
|
1 2 3 4 5 6 |
# ls -al /var/lib/suricata/rules/ total 30716 drwxr-s--- 2 root suricata 57 Oct 15 10:57 . drwxrws--- 4 suricata suricata 33 Oct 15 10:57 .. -rw-r--r-- 1 root suricata 3228 Oct 15 10:57 classification.config -rw-r--r-- 1 root suricata 31447250 Oct 15 10:57 suricata.rules |
②Index list of sources providing rule sets
|
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 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 |
# suricata-update list-sources Name: et/open Vendor: Proofpoint Summary: Emerging Threats Open Ruleset License: MIT Name: et/pro Vendor: Proofpoint Summary: Emerging Threats Pro Ruleset License: Commercial Replaces: et/open Parameters: secret-code Subscription: https://www.proofpoint.com/us/threat-insight/et-pro-ruleset Name: oisf/trafficid Vendor: OISF Summary: Suricata Traffic ID ruleset License: MIT Name: scwx/enhanced Vendor: Secureworks Summary: Secureworks suricata-enhanced ruleset License: Commercial Parameters: secret-code Subscription: https://www.secureworks.com/contact/ (Please reference CTU Countermeasures) Name: scwx/malware Vendor: Secureworks Summary: Secureworks suricata-malware ruleset License: Commercial Parameters: secret-code Subscription: https://www.secureworks.com/contact/ (Please reference CTU Countermeasures) Name: scwx/security Vendor: Secureworks Summary: Secureworks suricata-security ruleset License: Commercial Parameters: secret-code Subscription: https://www.secureworks.com/contact/ (Please reference CTU Countermeasures) Name: abuse.ch/sslbl-blacklist Vendor: Abuse.ch Summary: Abuse.ch SSL Blacklist License: CC0-1.0 Replaces: s, s, l, b, l, /, s, s, l, -, f, p, -, b, l, a, c, k, l, i, s, t Name: abuse.ch/sslbl-ja3 Vendor: Abuse.ch Summary: Abuse.ch Suricata JA3 Fingerprint Ruleset License: CC0-1.0 Replaces: s, s, l, b, l, /, j, a, 3, -, f, i, n, g, e, r, p, r, i, n, t, s Name: abuse.ch/sslbl-c2 Vendor: Abuse.ch Summary: Abuse.ch Suricata Botnet C2 IP Ruleset License: CC0-1.0 Name: abuse.ch/feodotracker Vendor: Abuse.ch Summary: Abuse.ch Feodo Tracker Botnet C2 IP ruleset License: CC0-1.0 Name: abuse.ch/urlhaus Vendor: abuse.ch Summary: Abuse.ch URLhaus Suricata Rules License: CC0-1.0 Name: etnetera/aggressive Vendor: Etnetera a.s. Summary: Etnetera aggressive IP blacklist License: MIT Name: tgreen/hunting Vendor: tgreen Summary: Threat hunting rules License: GPLv3 Name: malsilo/win-malware Vendor: malsilo Summary: Commodity malware rules License: MIT Name: stamus/lateral Vendor: Stamus Networks Summary: Lateral movement rules License: GPL-3.0-only Name: stamus/nrd-30-open Vendor: Stamus Networks Summary: Newly Registered Domains Open only - 30 day list, complete License: Commercial Parameters: secret-code Subscription: https://www.stamus-networks.com/stamus-labs/subscribe-to-threat-intel-feed Name: stamus/nrd-14-open Vendor: Stamus Networks Summary: Newly Registered Domains Open only - 14 day list, complete License: Commercial Parameters: secret-code Subscription: https://www.stamus-networks.com/stamus-labs/subscribe-to-threat-intel-feed Name: stamus/nrd-entropy-30-open Vendor: Stamus Networks Summary: Newly Registered Domains Open only - 30 day list, high entropy License: Commercial Parameters: secret-code Subscription: https://www.stamus-networks.com/stamus-labs/subscribe-to-threat-intel-feed Name: stamus/nrd-entropy-14-open Vendor: Stamus Networks Summary: Newly Registered Domains Open only - 14 day list, high entropy License: Commercial Parameters: secret-code Subscription: https://www.stamus-networks.com/stamus-labs/subscribe-to-threat-intel-feed Name: stamus/nrd-phishing-30-open Vendor: Stamus Networks Summary: Newly Registered Domains Open only - 30 day list, phishing License: Commercial Parameters: secret-code Subscription: https://www.stamus-networks.com/stamus-labs/subscribe-to-threat-intel-feed Name: stamus/nrd-phishing-14-open Vendor: Stamus Networks Summary: Newly Registered Domains Open only - 14 day list, phishing License: Commercial Parameters: secret-code Subscription: https://www.stamus-networks.com/stamus-labs/subscribe-to-threat-intel-feed Name: pawpatrules Vendor: pawpatrules Summary: PAW Patrules is a collection of rules for IDPS / NSM Suricata engine License: CC-BY-SA-4.0 Name: ptrules/open Vendor: Positive Technologies Summary: Positive Technologies Open Ruleset License: Custom Name: aleksibovellan/nmap Vendor: aleksibovellan Summary: Suricata IDS/IPS Detection Rules Against NMAP Scans License: MIT |
③Enable source (if et/open is enabled)
|
1 2 3 4 5 6 7 |
# suricata-update enable-source et/open 15/10/2024 -- 11:05:03 - <Info> -- Using data-directory /var/lib/suricata. 15/10/2024 -- 11:05:03 - <Info> -- Using Suricata configuration /etc/suricata/suricata.yaml 15/10/2024 -- 11:05:03 - <Info> -- Using /usr/share/suricata/rules for Suricata provided rules. 15/10/2024 -- 11:05:03 - <Info> -- Found Suricata version 6.0.20 at /usr/sbin/suricata. 15/10/2024 -- 11:05:03 - <Info> -- Creating directory /var/lib/suricata/update/sources 15/10/2024 -- 11:05:03 - <Info> -- Source et/open enabled |
Perform update
|
1 |
# suricata-update |
Restart Suricata service
|
1 |
# systemctl restart suricata |
5.Creating Suricata Custom Rules
①Create files containing customer rules
|
1 2 3 |
# vi /etc/suricata/rules/local.rules Include the following information alert icmp any any -> $HOME_NET any (msg:"ICMP Ping"; sid:1; rev:1;) |
②Edit configuration file (define new rule paths)
|
1 2 3 4 5 6 7 8 |
# vi /etc/suricata/suricata.yaml # Added around line 1969 default-rule-path: /var/lib/suricata/rules rule-files: - suricata.rules - /etc/suricata/rules/local.rules |
③Testing the configuration file
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
# suricata -T -c /etc/suricata/suricata.yaml -v 15/10/2024 -- 11:07:20 - <Info> - Running suricata under test mode 15/10/2024 -- 11:07:20 - <Notice> - This is Suricata version 6.0.20 RELEASE running in SYSTEM mode 15/10/2024 -- 11:07:20 - <Info> - CPUs/cores online: 2 15/10/2024 -- 11:07:20 - <Info> - Setting engine mode to IDS mode by default 15/10/2024 -- 11:07:20 - <Info> - master exception-policy set to: auto 15/10/2024 -- 11:07:20 - <Info> - fast output device (regular) initialized: fast.log 15/10/2024 -- 11:07:20 - <Info> - eve-log output device (regular) initialized: eve.json 15/10/2024 -- 11:07:20 - <Info> - stats output device (regular) initialized: stats.log 15/10/2024 -- 11:07:33 - <Info> - 2 rule files processed. 39872 rules successfully loaded, 0 rules failed 15/10/2024 -- 11:07:33 - <Info> - Threshold config parsed: 0 rule(s) found 15/10/2024 -- 11:07:34 - <Info> - 39875 signatures processed. 1238 are IP-only rules, 4871 are inspecting packet payload, 33562 inspect application layer, 108 are decoder event only 15/10/2024 -- 11:07:47 - <Notice> - Configuration provided was successfully loaded. Exiting. 15/10/2024 -- 11:07:47 - <Info> - cleaning up signature grouping structure... complete |
Restart Suricata service
|
1 |
# systemctl restart suricata |
④Testing the application of Custom Rules
Ping another device on the same local network to see if it was logged
|
1 2 3 4 |
# cat /var/log/suricata/fast.log 10/15/2024-11:09:12.780011 [**] [1:1:1] ICMP Ping [**] [Classification: (null)] [Priority: 3] {ICMP} 192.168.11.100:8 -> 192.168.11.83:0 10/15/2024-11:09:12.781097 [**] [1:1:1] ICMP Ping [**] [Classification: (null)] [Priority: 3] {ICMP} 192.168.11.83:0 -> 192.168.11.100:0 |
To get logs in JSON format, install jq on your system
|
1 |
# dnf install jq |
|
1 |
# systemctl restart suricata |
Execute the following command to ping another device on the same local network
|
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 55 56 57 58 59 60 |
# tail -f /var/log/suricata/eve.json | jq 'select(.event_type=="alert")' When ping is executed, the following is displayed in the console { "timestamp": "2024-10-15T11:11:38.446282+0900", "flow_id": 960946576740170, "in_iface": "ens160", "event_type": "alert", "src_ip": "192.168.11.100", "src_port": 0, "dest_ip": "192.168.11.83", "dest_port": 0, "proto": "ICMP", "icmp_type": 8, "icmp_code": 0, "alert": { "action": "allowed", "gid": 1, "signature_id": 1, "rev": 1, "signature": "ICMP Ping", "category": "", "severity": 3 }, "flow": { "pkts_toserver": 1, "pkts_toclient": 0, "bytes_toserver": 98, "bytes_toclient": 0, "start": "2024-10-15T11:11:38.446282+0900" } } { "timestamp": "2024-10-15T11:11:38.446368+0900", "flow_id": 960946576740170, "in_iface": "ens160", "event_type": "alert", "src_ip": "192.168.11.83", "src_port": 0, "dest_ip": "192.168.11.100", "dest_port": 0, "proto": "ICMP", "icmp_type": 0, "icmp_code": 0, "alert": { "action": "allowed", "gid": 1, "signature_id": 1, "rev": 1, "signature": "ICMP Ping", "category": "", "severity": 3 }, "flow": { "pkts_toserver": 1, "pkts_toclient": 1, "bytes_toserver": 98, "bytes_toclient": 98, "start": "2024-10-15T11:11:38.446282+0900" } } |