Security Onion
Security Onion is a intrusion detection and network monitoring tool.
Before You Begin
Security Onion has Snort built in and therefore runs in the same instance. You need to configure Security Onion to send syslog so that InsightIDR can ingest it.
To configure syslog for Security Onion:
- Stop the Security Onion service.
- Find the
syslog-ng conf file
. - Change the
destination d_net
and log lines in the configuration file to look like following:
text
1# Send the messages to an other host2#3destination d_net { udp("_collector_ip_address_" port(_listening_port_defined_in_InsightPlatform)); };45....67# All messages send to a remote site8#9log { source(s_syslog); destination(d_net); };
You can read additional documentation about Security Onion here: https://github.com/Security-Onion-Solutions/security-onion/wiki/ThirdPartyIntegration.
If you have Security Onion V2 you will also need to:
- Create a new custom configuration file on the manager in
/opt/so/saltstack/local/salt/logstash/pipelines/config/custom/
to clone the events and match the cloned events in the output. We recommend using either thehttp
,tcp
,udp
, orsyslog
output plugin. - Copy
/opt/so/saltstack/default/pillar/logstash/manager.sls
to/opt/so/saltstack/local/pillar/logstash/manager.sls
- Append your newly created file to the list of config files used for the
manager
pipeline:- custom/myfile.conf
- Restart Logstash on the manager with
so-logstash-restart
- Monitor events flowing through the output with
curl -s localhost:9600/_node/stats | jq .pipelines.manager
You can read additional documentation about Security Onion V2 here: https://docs.securityonion.net/en/2.3/logstash.html#forwarding-events-to-an-external-destination
How to Configure This Event Source in InsightIDR
- From your dashboard, select Data Collection on the left hand menu.
- When the Data Collection page appears, click the Setup Event Source dropdown and choose Add Event Source.
- From the “Security Data” section, click the IDS icon. The “Add Event Source” panel appears.
- Choose your collector and event source. You can also name your event source if you want.
- Choose the timezone that matches the location of your event source logs.
- Optionally choose to send unparsed logs.
- Select Listen on Network Port and enter the port you used in the configuration file. Specify a protocol.
- Optionally choose to Encrypt the event source if choosing TCP by downloading the Rapid7 Certificate.
- Click Save.
Did this page help you?