Suricata User Guide

This is the documentation for Suricata 8.0.5.

• 1. What is Suricata
  • 1.1. About the Open Information Security Foundation
• 2. Quickstart guide
  • 2.1. Installation
  • 2.2. Basic setup
  • 2.3. Signatures
  • 2.4. Running Suricata
  • 2.5. Alerting
  • 2.6. EVE Json
• 3. Installation
  • 3.1. Source
  • 3.2. Binary packages
  • 3.3. Advanced Installation
• 4. Upgrading
  • 4.1. General instructions
  • 4.2. Upgrading to 8.0.5
  • 4.3. Upgrading to 8.0.3
  • 4.4. Upgrading to 8.0.2
  • 4.5. Upgrading to 8.0.1
  • 4.6. Upgrading 7.0 to 8.0
  • 4.7. Upgrading 6.0 to 7.0
  • 4.8. Upgrading 5.0 to 6.0
  • 4.9. Upgrading 4.1 to 5.0
• 5. Security Considerations
  • 5.1. Running as a User Other Than Root
  • 5.2. Containers
• 6. Support Status
  • 6.1. Levels of Support
  • 6.2. Distributions
  • 6.3. Architecture Support
• 7. Command Line Options
  • 7.1. Unit Tests
• 8. Suricata Rules
  • 8.1. Rules Format
  • 8.2. Meta Keywords
  • 8.3. IP Keywords
  • 8.4. TCP keywords
  • 8.5. UDP keywords
  • 8.6. ICMP keywords
  • 8.7. Payload Keywords
  • 8.8. Integer Keywords
  • 8.9. Transformations
  • 8.10. Prefiltering Keywords
  • 8.11. Flow Keywords
  • 8.12. Bypass Keyword
  • 8.13. HTTP Keywords
  • 8.14. File Keywords
  • 8.15. DNS Keywords
  • 8.16. mDNS Keywords
  • 8.17. SSL/TLS Keywords
  • 8.18. SSH Keywords
  • 8.19. JA3/JA4 Keywords
  • 8.20. Modbus Keyword
  • 8.21. DCERPC Keywords
  • 8.22. DHCP keywords
  • 8.23. DNP3 Keywords
  • 8.24. ENIP/CIP Keywords
  • 8.25. FTP/FTP-DATA Keywords
  • 8.26. Kerberos Keywords
  • 8.27. SMB Keywords
  • 8.28. SNMP keywords
  • 8.29. NTP Keywords
  • 8.30. Base64 keywords
  • 8.31. SIP Keywords
  • 8.32. SDP Keywords
  • 8.33. RFB Keywords
  • 8.34. MQTT Keywords
  • 8.35. IKE Keywords
  • 8.36. HTTP2 Keywords
  • 8.37. Quic Keywords
  • 8.38. NFS Keywords
  • 8.39. SMTP Keywords
  • 8.40. WebSocket Keywords
  • 8.41. Generic App Layer Keywords
  • 8.42. Generic Decode Layer Keywords
  • 8.43. Xbits Keyword
  • 8.44. Alert Keywords
  • 8.45. Thresholding Keywords
  • 8.46. IP Reputation Keyword
  • 8.47. IP Addresses Match
  • 8.48. Config Rules
  • 8.49. Datasets
  • 8.50. Lua Scripting for Detection
  • 8.51. Differences From Snort
  • 8.52. Multiple Buffer Matching
  • 8.53. Tag
  • 8.54. VLAN Keywords
  • 8.55. LDAP Keywords
  • 8.56. PGSQL Keywords
  • 8.57. Email Keywords
  • 8.58. Rule Types and Categorization
  • 8.59. Rule Processing
• 9. Rule Management
  • 9.1. Rule Management with Suricata-Update
  • 9.2. Adding Your Own Rules
  • 9.3. Rule Reloads
  • 9.4. Rules Profiling
• 10. Making sense out of Alerts
• 11. Performance
  • 11.1. Runmodes
  • 11.2. Packet Capture
  • 11.3. Tuning Considerations
  • 11.4. Hyperscan
  • 11.5. High Performance Configuration
  • 11.6. Statistics
  • 11.7. Ignoring Traffic
  • 11.8. Packet Profiling
  • 11.9. Rule Profiling
  • 11.10. Tcmalloc
  • 11.11. Performance Analysis
• 12. Configuration
  • 12.1. Suricata.yaml
  • 12.2. Global-Thresholds
  • 12.3. Exception Policies
  • 12.4. Snort.conf to Suricata.yaml
  • 12.5. Multi Tenancy
  • 12.6. Dropping Privileges After Startup
  • 12.7. Using Landlock LSM
  • 12.8. systemd notification
  • 12.9. Includes
• 13. Reputation
  • 13.1. IP Reputation
• 14. Init Scripts
• 15. Output
  • 15.1. EVE
  • 15.2. Lua Output
  • 15.3. Syslog Alerting Compatibility
  • 15.4. Custom http logging
  • 15.5. Custom tls logging
  • 15.6. Log Rotation
• 16. Lua support
  • 16.1. Lua usage in Suricata
  • 16.2. Lua functions
  • 16.3. Lua Libraries
• 17. File Extraction
  • 17.1. Architecture
  • 17.2. Settings
  • 17.3. Output
  • 17.4. Rules
  • 17.5. MD5
  • 17.6. Updating Filestore Configuration
• 18. Public Datasets (PCAPs)
• 19. Using Capture Hardware
  • 19.1. AF_PACKET
  • 19.2. Endace DAG
  • 19.3. Napatech
  • 19.4. Myricom
  • 19.5. eBPF and XDP
  • 19.6. Netmap
  • 19.7. AF_XDP
  • 19.8. DPDK
  • 19.9. PCAP File Reading
• 20. Interacting via Unix Socket
  • 20.1. Introduction
  • 20.2. Commands in standard running mode
  • 20.3. Commands on the cmd prompt
  • 20.4. PCAP processing mode
  • 20.5. Build your own client
• 21. Plugins
  • 21.1. nDPI
• 22. IPS Mode
  • 22.1. IPS Concept
  • 22.2. Setting up IPS/inline for Linux
  • 22.3. Setting up IPS/inline for Windows
• 23. Firewall Mode
  • 23.1. Firewall Mode Design
  • 23.2. Firewall Ruleset Examples
• 24. 3rd Party Integration
  • 24.1. Symantec SSL Visibility (BlueCoat)
• 25. Man Pages
  • 25.1. Suricata
  • 25.2. Suricata Socket Control
  • 25.3. Suricata Control
  • 25.4. Suricata Control Filestore
• 26. Acknowledgements
• 27. Licenses
  • 27.1. GNU General Public License
  • 27.2. Creative Commons Attribution-NonCommercial 4.0 International Public License
  • 27.3. Suricata Source Code
  • 27.4. Suricata Documentation
• 28. Suricata Developer Guide
  • 28.1. Working with the Codebase
  • 28.2. Contributing
  • 28.3. Suricata Internals
  • 28.4. Extending Suricata
  • 28.5. LibSuricata and Plugins
  • 28.6. Upgrading
• 29. Verifying Suricata Source Distribution Files
  • 29.1. Verification Steps
• 30. Appendix
  • 30.1. EVE JSON Schema
  • 30.2. EVE Index
• 31. Known Issues