Add built-in Dashboard Widget for Suricata and make it persistent.

1 files changed, 213 insertions, 0 deletions

diff --git a/config/suricata/suricata_alerts.widget.php b/config/suricata/suricata_alerts.widget.php
new file mode 100644
index 00000000..fabb9314
--- /dev/null
+++ b/config/suricata/suricata_alerts.widget.php
@@ -0,0 +1,213 @@
+<?php
+/*
+    suricata_alerts.widget.php
+    Copyright (C) 2009 Jim Pingle
+    mod 24-07-2012
+    mod 28-02-2014 for use with Suricata by Bill Meeks
+
+    Redistribution and use in source and binary forms, with or without
+    modification, are permitted provided that the following conditions are met:
+
+    1. Redistributions of source code must retain the above copyright notice,
+       this list of conditions and the following disclaimer.
+
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+    THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+    INClUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+    AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+    AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+    OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+    SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+    INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+    CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+    ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+    POSSIBILITY OF SUCH DAMAGE.
+*/
+
+$nocsrf = true;
+
+require_once("guiconfig.inc");
+require_once("/usr/local/www/widgets/include/widget-suricata.inc");
+
+global $config, $g;
+
+/* Retrieve Suricata configuration */
+if (!is_array($config['installedpackages']['suricata']['rule']))
+	$config['installedpackages']['suricata']['rule'] = array();
+$a_instance = &$config['installedpackages']['suricata']['rule'];
+
+/* array sorting */
+function sksort(&$array, $subkey="id", $sort_ascending=false) {
+        /* an empty array causes sksort to fail - this test alleviates the error */
+	if(empty($array))
+	        return false;
+	if (count($array)){
+		$temp_array[key($array)] = array_shift($array);
+	};
+	foreach ($array as $key => $val){
+		$offset = 0;
+		$found = false;
+		foreach ($temp_array as $tmp_key => $tmp_val) {
+			if (!$found and strtolower($val[$subkey]) > strtolower($tmp_val[$subkey])) {
+				$temp_array = array_merge((array)array_slice($temp_array,0,$offset), array($key => $val), array_slice($temp_array,$offset));
+				$found = true;
+			};
+			$offset++;
+		};
+		if (!$found) $temp_array = array_merge($temp_array, array($key => $val));
+	};
+
+	if ($sort_ascending) {
+		$array = array_reverse($temp_array);
+	} else $array = $temp_array;
+        /* below is the complement for empty array test */
+        return true; 
+};
+
+/* check if firewall widget variable is set */
+$nentries = $config['widgets']['widget_suricata_display_lines'];
+if (!isset($nentries) || $nentries < 0)
+	$nentries = 5;
+
+// Called by Ajax to update alerts table contents
+if (isset($_GET['getNewAlerts'])) {
+	$response = "";
+	$suri_alerts = suricata_widget_get_alerts();
+	$counter = 0;
+	foreach ($suri_alerts as $a) {
+		$response .= $a['instanceid'] . " " . $a['dateonly'] . "||" . $a['timeonly'] . "||" . $a['src'] . ":" . $a['srcport'] . "||";
+		$response .= $a['dst'] . ":" . $a['dstport'] . "||" . $a['priority'] . "||" . $a['category'] . "\n";
+		$counter++;
+		if($counter >= $nentries)
+			break;
+	}
+	echo $response;
+	return;
+}
+
+if(isset($_POST['widget_suricata_display_lines'])) {
+	$config['widgets']['widget_suricata_display_lines'] = $_POST['widget_suricata_display_lines'];
+	write_config("Saved Suricata Alerts Widget Displayed Lines Parameter via Dashboard");
+	header("Location: ../../index.php");
+}
+
+// Read "$nentries" worth of alerts from the top of the alerts.log file
+function suricata_widget_get_alerts() {
+
+	global $config, $a_instance, $nentries;
+	$suricata_alerts = array();
+
+	/* read log file(s) */
+	$counter=0;
+	foreach ($a_instance as $instanceid => $instance) {
+		$suricata_uuid = $a_instance[$instanceid]['uuid'];
+		$if_real = get_real_interface($a_instance[$instanceid]['interface']);
+
+		// make sure alert file exists, then grab the most recent {$nentries} from it
+		// and write them to a temp file.
+		if (file_exists("/var/log/suricata/suricata_{$if_real}{$suricata_uuid}/alerts.log")) {
+			exec("tail -{$nentries} -r /var/log/suricata/suricata_{$if_real}{$suricata_uuid}/alerts.log > /tmp/surialerts_{$suricata_uuid}");
+			if (file_exists("/tmp/surialerts_{$suricata_uuid}")) {
+
+				/*              0         1      2             3      4       5   6              7        8     9   10      11  12      */
+				/* File format: timestamp,action,sig_generator,sig_id,sig_rev,msg,classification,priority,proto,src,srcport,dst,dstport */
+				$fd = fopen("/tmp/surialerts_{$suricata_uuid}", "r");
+				while (($fields = fgetcsv($fd, 1000, ',', '"')) !== FALSE) {
+					if(count($fields) < 12)
+						continue;
+
+					// Create a DateTime object from the event timestamp that
+					// we can use to easily manipulate output formats.
+					$event_tm = date_create_from_format("m/d/Y-H:i:s.u", $fields[0]);
+
+					// Check the 'CATEGORY' field for the text "(null)" and
+					// substitute "No classtype defined".
+					if ($fields[6] == "(null)")
+						$fields[6] = "No classtype assigned";
+
+					$suricata_alerts[$counter]['instanceid'] = strtoupper($a_instance[$instanceid]['interface']);
+					$suricata_alerts[$counter]['timestamp'] = strval(date_timestamp_get($event_tm));
+					$suricata_alerts[$counter]['timeonly'] = date_format($event_tm, "H:i:s");
+					$suricata_alerts[$counter]['dateonly'] = date_format($event_tm, "M d");
+					$suricata_alerts[$counter]['src'] = inet_ntop(inet_pton($fields[9]));
+					$suricata_alerts[$counter]['srcport'] = $fields[10];
+					$suricata_alerts[$counter]['dst'] = inet_ntop(inet_pton($fields[11]));
+					$suricata_alerts[$counter]['dstport'] = $fields[12];
+					$suricata_alerts[$counter]['priority'] = $fields[7];
+					$suricata_alerts[$counter]['category'] = $fields[6];
+					$counter++;
+				};
+				fclose($fd);
+				@unlink("/tmp/surialerts_{$suricata_uuid}");
+			};
+		};
+	};
+
+	// Sort the alerts in descending order
+	sksort($suricata_alerts, 'timestamp', false);
+
+	return $suricata_alerts;
+}
+
+/* display the result */
+?>
+
+<script type="text/javascript">
+//<![CDATA[
+var suricataupdateDelay = 20000;
+var isBusy = false;
+var isPaused = false;
+var nentries = <?php echo $nentries; ?>;
+//]]>
+</script>
+
+<input type="hidden" id="suricata_alerts-config" name="suricata_alerts-config" value=""/>
+<div id="suricata_alerts-settings" class="widgetconfigdiv" style="display:none;">
+	<form action="/widgets/widgets/suricata_alerts.widget.php" method="post" name="iformd">
+		Enter number of recent alerts to display (default is 5)<br/>
+		<input type="text" size="5" name="widget_suricata_display_lines" class="formfld unknown" id="widget_suricata_display_lines" value="<?= $config['widgets']['widget_suricata_display_lines'] ?>" />
+		&nbsp;&nbsp;<input id="submitd" name="submitd" type="submit" class="formbtn" value="Save" />
+    </form>
+</div>
+
+<table width="100%" border="0" cellspacing="0" cellpadding="0">
+	<thead>
+		<tr class="suricata-alert-header">
+			<td width="22%" class="widgetsubheader" align="center">IF/Date</td>
+			<td width="39%" class="widgetsubheader" align="center">Src/Dst</td>
+			<td width="39%" class="widgetsubheader" align="center">Details</td>
+		</tr>
+	</thead>
+	<tbody id="suricata-alert-entries">
+	<?php
+		$suricata_alerts = suricata_widget_get_alerts($nentries);
+		$counter=0;
+		if (is_array($suricata_alerts)) {
+			foreach ($suricata_alerts as $alert) {
+				$evenRowClass = $counter % 2 ? " listMReven" : " listMRodd";
+				echo("	<tr class='" . $evenRowClass . "'>
+				<td width='22%' class='listMRr' nowrap>" . $alert['instanceid'] . " " . $alert['dateonly'] . "<br/>" . $alert['timeonly'] . "</td>		
+				<td width='39%' class='listMRr'>" . $alert['src'] . ":" . $alert['srcport'] . "<br>" . $alert['dst'] . ":" . $alert['dstport'] . "</td>
+				<td width='39%' class='listMRr'>Priority: " . $alert['priority'] . "<br/>" . $alert['category'] . "</td></tr>");
+				$counter++;
+				if($counter >= $nentries)
+					break;
+			}
+		}
+	?>
+	</tbody>
+</table>
+
+<!-- needed to display the widget settings menu -->
+<script type="text/javascript">
+//<![CDATA[
+	selectIntLink = "suricata_alerts-configure";
+	textlink = document.getElementById(selectIntLink);
+	textlink.style.display = "inline";
+//]]>
+
+</script>
+