]> git.ipfire.org Git - ipfire-2.x.git/blob - html/cgi-bin/ids.cgi
ids.cgi: Format and show date of the current ruleset again
[ipfire-2.x.git] / html / cgi-bin / ids.cgi
1 #!/usr/bin/perl
2 ###############################################################################
3 # #
4 # IPFire.org - A linux based firewall #
5 # Copyright (C) 2007-2018 IPFire Team <info@ipfire.org> #
6 # #
7 # This program is free software: you can redistribute it and/or modify #
8 # it under the terms of the GNU General Public License as published by #
9 # the Free Software Foundation, either version 3 of the License, or #
10 # (at your option) any later version. #
11 # #
12 # This program is distributed in the hope that it will be useful, #
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of #
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
15 # GNU General Public License for more details. #
16 # #
17 # You should have received a copy of the GNU General Public License #
18 # along with this program. If not, see <http://www.gnu.org/licenses/>. #
19 # #
20 ###############################################################################
21
22 use strict;
23
24 # enable only the following on debugging purpose
25 #use warnings;
26 #use CGI::Carp 'fatalsToBrowser';
27
28 require '/var/ipfire/general-functions.pl';
29 require "${General::swroot}/lang.pl";
30 require "${General::swroot}/header.pl";
31 require "${General::swroot}/ids-functions.pl";
32
33 my %color = ();
34 my %mainsettings = ();
35 my %idsrules = ();
36 my %idssettings=();
37 my %rulessettings=();
38 my %rulesetsources = ();
39 my %cgiparams=();
40 my %checked=();
41 my %selected=();
42 my %ignored=();
43
44 # Read-in main settings, for language, theme and colors.
45 &General::readhash("${General::swroot}/main/settings", \%mainsettings);
46 &General::readhash("/srv/web/ipfire/html/themes/".$mainsettings{'THEME'}."/include/colors.txt", \%color);
47
48 # Get the available network zones, based on the config type of the system and store
49 # the list of zones in an array.
50 my @network_zones = &IDS::get_available_network_zones();
51
52 my $errormessage;
53
54 # Create files if they does not exist yet.
55 &IDS::check_and_create_filelayout();
56
57 # Hash which contains the colour code of a network zone.
58 my %colourhash = (
59 'red' => $Header::colourred,
60 'green' => $Header::colourgreen,
61 'blue' => $Header::colourblue,
62 'orange' => $Header::colourorange
63 );
64
65 &Header::showhttpheaders();
66
67 #Get GUI values
68 &Header::getcgihash(\%cgiparams);
69
70 ## Add/edit an entry to the ignore file.
71 #
72 if (($cgiparams{'WHITELIST'} eq $Lang::tr{'add'}) || ($cgiparams{'WHITELIST'} eq $Lang::tr{'update'})) {
73
74 # Check if any input has been performed.
75 if ($cgiparams{'IGNORE_ENTRY_ADDRESS'} ne '') {
76
77 # Check if the given input is no valid IP-address or IP-address with subnet, display an error message.
78 if ((!&General::validip($cgiparams{'IGNORE_ENTRY_ADDRESS'})) && (!&General::validipandmask($cgiparams{'IGNORE_ENTRY_ADDRESS'}))) {
79 $errormessage = "$Lang::tr{'guardian invalid address or subnet'}";
80 }
81 } else {
82 $errormessage = "$Lang::tr{'guardian empty input'}";
83 }
84
85 # Go further if there was no error.
86 if ($errormessage eq '') {
87 my %ignored = ();
88 my $id;
89 my $status;
90
91 # Assign hash values.
92 my $new_entry_address = $cgiparams{'IGNORE_ENTRY_ADDRESS'};
93 my $new_entry_remark = $cgiparams{'IGNORE_ENTRY_REMARK'};
94
95 # Read-in ignoredfile.
96 &General::readhasharray($IDS::ignored_file, \%ignored);
97
98 # Check if we should edit an existing entry and got an ID.
99 if (($cgiparams{'WHITELIST'} eq $Lang::tr{'update'}) && ($cgiparams{'ID'})) {
100 # Assin the provided id.
101 $id = $cgiparams{'ID'};
102
103 # Undef the given ID.
104 undef($cgiparams{'ID'});
105
106 # Grab the configured status of the corresponding entry.
107 $status = $ignored{$id}[2];
108 } else {
109 # Each newly added entry automatically should be enabled.
110 $status = "enabled";
111
112 # Generate the ID for the new entry.
113 #
114 # Sort the keys by their ID and store them in an array.
115 my @keys = sort { $a <=> $b } keys %ignored;
116
117 # Reverse the key array.
118 my @reversed = reverse(@keys);
119
120 # Obtain the last used id.
121 my $last_id = @reversed[0];
122
123 # Increase the last id by one and use it as id for the new entry.
124 $id = ++$last_id;
125 }
126
127 # Add/Modify the entry to/in the ignored hash.
128 $ignored{$id} = ["$new_entry_address", "$new_entry_remark", "$status"];
129
130 # Write the changed ignored hash to the ignored file.
131 &General::writehasharray($IDS::ignored_file, \%ignored);
132
133 # Regenerate the ignore file.
134 &IDS::generate_ignore_file();
135 }
136
137 # Check if the IDS is running.
138 if(&IDS::ids_is_running()) {
139 # Call suricatactrl to perform a reload.
140 &IDS::call_suricatactrl("reload");
141 }
142
143 ## Toggle Enabled/Disabled for an existing entry on the ignore list.
144 #
145
146 } elsif ($cgiparams{'WHITELIST'} eq $Lang::tr{'toggle enable disable'}) {
147 my %ignored = ();
148
149 # Only go further, if an ID has been passed.
150 if ($cgiparams{'ID'}) {
151 # Assign the given ID.
152 my $id = $cgiparams{'ID'};
153
154 # Undef the given ID.
155 undef($cgiparams{'ID'});
156
157 # Read-in ignoredfile.
158 &General::readhasharray($IDS::ignored_file, \%ignored);
159
160 # Grab the configured status of the corresponding entry.
161 my $status = $ignored{$id}[2];
162
163 # Switch the status.
164 if ($status eq "disabled") {
165 $status = "enabled";
166 } else {
167 $status = "disabled";
168 }
169
170 # Modify the status of the existing entry.
171 $ignored{$id} = ["$ignored{$id}[0]", "$ignored{$id}[1]", "$status"];
172
173 # Write the changed ignored hash to the ignored file.
174 &General::writehasharray($IDS::ignored_file, \%ignored);
175
176 # Regenerate the ignore file.
177 &IDS::generate_ignore_file();
178
179 # Check if the IDS is running.
180 if(&IDS::ids_is_running()) {
181 # Call suricatactrl to perform a reload.
182 &IDS::call_suricatactrl("reload");
183 }
184 }
185
186 ## Remove entry from ignore list.
187 #
188 } elsif ($cgiparams{'WHITELIST'} eq $Lang::tr{'remove'}) {
189 my %ignored = ();
190
191 # Read-in ignoredfile.
192 &General::readhasharray($IDS::ignored_file, \%ignored);
193
194 # Drop entry from the hash.
195 delete($ignored{$cgiparams{'ID'}});
196
197 # Undef the given ID.
198 undef($cgiparams{'ID'});
199
200 # Write the changed ignored hash to the ignored file.
201 &General::writehasharray($IDS::ignored_file, \%ignored);
202
203 # Regenerate the ignore file.
204 &IDS::generate_ignore_file();
205
206 # Check if the IDS is running.
207 if(&IDS::ids_is_running()) {
208 # Call suricatactrl to perform a reload.
209 &IDS::call_suricatactrl("reload");
210 }
211 }
212
213 # Check if the page is locked, in this case, the ids_page_lock_file exists.
214 if (-e $IDS::ids_page_lock_file) {
215 # Lock the webpage and print notice about autoupgrade of the ruleset
216 # is in progess.
217 &working_notice("$Lang::tr{'ids ruleset autoupdate in progress'}");
218
219 # Loop and check if the file still exists.
220 while(-e $IDS::ids_page_lock_file) {
221 # Sleep for a second and re-check.
222 sleep 1;
223 }
224
225 # Page has been unlocked, perform a reload.
226 &reload();
227 }
228
229 # Check if any error has been stored.
230 if (-e $IDS::storederrorfile) {
231 # Open file to read in the stored error message.
232 open(FILE, "<$IDS::storederrorfile") or die "Could not open $IDS::storederrorfile. $!\n";
233
234 # Read the stored error message.
235 $errormessage = <FILE>;
236
237 # Close file.
238 close (FILE);
239
240 # Delete the file, which is now not longer required.
241 unlink($IDS::storederrorfile);
242 }
243
244 ## Grab all available rules and store them in the idsrules hash.
245 #
246 # Open rules directory and do a directory listing.
247 opendir(DIR, $IDS::rulespath) or die $!;
248 # Loop through the direcory.
249 while (my $file = readdir(DIR)) {
250
251 # We only want files.
252 next unless (-f "$IDS::rulespath/$file");
253
254 # Ignore empty files.
255 next if (-z "$IDS::rulespath/$file");
256
257 # Use a regular expression to find files ending in .rules
258 next unless ($file =~ m/\.rules$/);
259
260 # Ignore files which are not read-able.
261 next unless (-R "$IDS::rulespath/$file");
262
263 # Skip whitelist rules file.
264 next if( $file eq "whitelist.rules");
265
266 # Call subfunction to read-in rulefile and add rules to
267 # the idsrules hash.
268 &readrulesfile("$file");
269 }
270
271 closedir(DIR);
272
273 # Gather used rulefiles.
274 #
275 # Check if the file for activated rulefiles is not empty.
276 if(-f $IDS::used_rulefiles_file) {
277 # Open the file for used rulefile and read-in content.
278 open(FILE, $IDS::used_rulefiles_file) or die "Could not open $IDS::used_rulefiles_file. $!\n";
279
280 # Read-in content.
281 my @lines = <FILE>;
282
283 # Close file.
284 close(FILE);
285
286 # Loop through the array.
287 foreach my $line (@lines) {
288 # Remove newlines.
289 chomp($line);
290
291 # Skip comments.
292 next if ($line =~ /\#/);
293
294 # Skip blank lines.
295 next if ($line =~ /^\s*$/);
296
297 # Gather rule sid and message from the ruleline.
298 if ($line =~ /.*- (.*)/) {
299 my $rulefile = $1;
300
301 # Check if the current rulefile exists in the %idsrules hash.
302 # If not, the file probably does not exist anymore or contains
303 # no rules.
304 if($idsrules{$rulefile}) {
305 # Add the rulefile state to the %idsrules hash.
306 $idsrules{$rulefile}{'Rulefile'}{'State'} = "on";
307 }
308 }
309 }
310 }
311
312 # Save ruleset configuration.
313 if ($cgiparams{'RULESET'} eq $Lang::tr{'save'}) {
314 my %oldsettings;
315 my %rulesetsources;
316
317 # Read-in current (old) IDS settings.
318 &General::readhash("$IDS::rules_settings_file", \%oldsettings);
319
320 # Get all available ruleset locations.
321 &General::readhash("$IDS::rulesetsourcesfile", \%rulesetsources);
322
323 # Prevent form name from been stored in conf file.
324 delete $cgiparams{'RULESET'};
325
326 # Grab the URL based on the choosen vendor.
327 my $url = $rulesetsources{$cgiparams{'RULES'}};
328
329 # Check if the choosen vendor (URL) requires an subscription/oinkcode.
330 if ($url =~ /\<oinkcode\>/ ) {
331 # Check if an subscription/oinkcode has been provided.
332 if ($cgiparams{'OINKCODE'}) {
333 # Check if the oinkcode contains unallowed chars.
334 unless ($cgiparams{'OINKCODE'} =~ /^[a-z0-9]+$/) {
335 $errormessage = $Lang::tr{'invalid input for oink code'};
336 }
337 } else {
338 # Print an error message, that an subsription/oinkcode is required for this
339 # vendor.
340 $errormessage = $Lang::tr{'ids oinkcode required'};
341 }
342 }
343
344 # Go on if there are no error messages.
345 if (!$errormessage) {
346 # Store settings into settings file.
347 &General::writehash("$IDS::rules_settings_file", \%cgiparams);
348
349 # Check if the the automatic rule update hass been touched.
350 if($cgiparams{'AUTOUPDATE_INTERVAL'} ne $oldsettings{'AUTOUPDATE_INTERVAL'}) {
351 # Call suricatactrl to set the new interval.
352 &IDS::call_suricatactrl("cron", $cgiparams{'AUTOUPDATE_INTERVAL'});
353 }
354
355 # Check if a ruleset is present - if not or the source has been changed download it.
356 if((! %idsrules) || ($oldsettings{'RULES'} ne $cgiparams{'RULES'})) {
357 # Check if the red device is active.
358 unless (-e "${General::swroot}/red/active") {
359 $errormessage = "$Lang::tr{'could not download latest updates'} - $Lang::tr{'system is offline'}";
360 }
361
362 # Check if enought free disk space is availabe.
363 if(&IDS::checkdiskspace()) {
364 $errormessage = "$Lang::tr{'not enough disk space'}";
365 }
366
367 # Check if any errors happend.
368 unless ($errormessage) {
369 # Lock the webpage and print notice about downloading
370 # a new ruleset.
371 &working_notice("$Lang::tr{'ids working'}");
372
373 # Call subfunction to download the ruleset.
374 if(&IDS::downloadruleset()) {
375 $errormessage = $Lang::tr{'could not download latest updates'};
376
377 # Call function to store the errormessage.
378 &IDS::_store_error_message($errormessage);
379 } else {
380 # Call subfunction to launch oinkmaster.
381 &IDS::oinkmaster();
382 }
383
384 # Check if the IDS is running.
385 if(&IDS::ids_is_running()) {
386 # Call suricatactrl to stop the IDS - because of the changed
387 # ruleset - the use has to configure it before suricata can be
388 # used again.
389 &IDS::call_suricatactrl("stop");
390 }
391
392 # Perform a reload of the page.
393 &reload();
394 }
395 }
396 }
397
398 # Save ruleset.
399 } elsif ($cgiparams{'RULESET'} eq $Lang::tr{'ids apply'}) {
400 # Arrays to store which rulefiles have been enabled and will be used.
401 my @enabled_rulefiles;
402
403 # Hash to store the user-enabled and disabled sids.
404 my %enabled_disabled_sids;
405
406 # Loop through the hash of idsrules.
407 foreach my $rulefile(keys %idsrules) {
408 # Check if the rulefile is enabled.
409 if ($cgiparams{$rulefile} eq "on") {
410 # Add rulefile to the array of enabled rulefiles.
411 push(@enabled_rulefiles, $rulefile);
412
413 # Drop item from cgiparams hash.
414 delete $cgiparams{$rulefile};
415 }
416 }
417
418 # Read-in the files for enabled/disabled sids.
419 # This will be done by calling the read_enabled_disabled_sids_file function two times
420 # and merge the returned hashes together into the enabled_disabled_sids hash.
421 %enabled_disabled_sids = (
422 &read_enabled_disabled_sids_file($IDS::disabled_sids_file),
423 &read_enabled_disabled_sids_file($IDS::enabled_sids_file));
424
425 # Loop through the hash of idsrules.
426 foreach my $rulefile (keys %idsrules) {
427 # Loop through the single rules of the rulefile.
428 foreach my $sid (keys %{$idsrules{$rulefile}}) {
429 # Skip the current sid if it is not numeric.
430 next unless ($sid =~ /\d+/ );
431
432 # Check if there exists a key in the cgiparams hash for this sid.
433 if (exists($cgiparams{$sid})) {
434 # Look if the rule is disabled.
435 if ($idsrules{$rulefile}{$sid}{'State'} eq "off") {
436 # Check if the state has been set to 'on'.
437 if ($cgiparams{$sid} eq "on") {
438 # Add/Modify the sid to/in the enabled_disabled_sids hash.
439 $enabled_disabled_sids{$sid} = "enabled";
440
441 # Drop item from cgiparams hash.
442 delete $cgiparams{$rulefile}{$sid};
443 }
444 }
445 } else {
446 # Look if the rule is enabled.
447 if ($idsrules{$rulefile}{$sid}{'State'} eq "on") {
448 # Check if the state is 'on' and should be disabled.
449 # In this case there is no entry
450 # for the sid in the cgiparams hash.
451 # Add/Modify it to/in the enabled_disabled_sids hash.
452 $enabled_disabled_sids{$sid} = "disabled";
453
454 # Drop item from cgiparams hash.
455 delete $cgiparams{$rulefile}{$sid};
456 }
457 }
458 }
459 }
460
461 # Open enabled sid's file for writing.
462 open(ENABLED_FILE, ">$IDS::enabled_sids_file") or die "Could not write to $IDS::enabled_sids_file. $!\n";
463
464 # Open disabled sid's file for writing.
465 open(DISABLED_FILE, ">$IDS::disabled_sids_file") or die "Could not write to $IDS::disabled_sids_file. $!\n";
466
467 # Write header to the files.
468 print ENABLED_FILE "#Autogenerated file. Any custom changes will be overwritten!\n";
469 print DISABLED_FILE "#Autogenerated file. Any custom changes will be overwritten!\n";
470
471 # Check if the hash for enabled/disabled files contains any entries.
472 if (%enabled_disabled_sids) {
473 # Loop through the hash.
474 foreach my $sid (keys %enabled_disabled_sids) {
475 # Check if the sid is enabled.
476 if ($enabled_disabled_sids{$sid} eq "enabled") {
477 # Print the sid to the enabled_sids file.
478 print ENABLED_FILE "enablesid $sid\n";
479 # Check if the sid is disabled.
480 } elsif ($enabled_disabled_sids{$sid} eq "disabled") {
481 # Print the sid to the disabled_sids file.
482 print DISABLED_FILE "disablesid $sid\n";
483 # Something strange happende - skip the current sid.
484 } else {
485 next;
486 }
487 }
488 }
489
490 # Close file for enabled_sids after writing.
491 close(ENABLED_FILE);
492
493 # Close file for disabled_sids after writing.
494 close(DISABLED_FILE);
495
496 # Call function to generate and write the used rulefiles file.
497 &IDS::write_used_rulefiles_file(@enabled_rulefiles);
498
499 # Lock the webpage and print message.
500 &working_notice("$Lang::tr{'ids apply ruleset changes'}");
501
502 # Call oinkmaster to alter the ruleset.
503 &IDS::oinkmaster();
504
505 # Check if the IDS is running.
506 if(&IDS::ids_is_running()) {
507 # Call suricatactrl to perform a reload.
508 &IDS::call_suricatactrl("reload");
509 }
510
511 # Reload page.
512 &reload();
513
514 # Download new ruleset.
515 } elsif ($cgiparams{'RULESET'} eq $Lang::tr{'update ruleset'}) {
516 # Check if the red device is active.
517 unless (-e "${General::swroot}/red/active") {
518 $errormessage = "$Lang::tr{'could not download latest updates'} - $Lang::tr{'system is offline'}";
519 }
520
521 # Check if enought free disk space is availabe.
522 if(&IDS::checkdiskspace()) {
523 $errormessage = "$Lang::tr{'not enough disk space'}";
524 }
525
526 # Check if any errors happend.
527 unless ($errormessage) {
528 # Lock the webpage and print notice about downloading
529 # a new ruleset.
530 &working_notice("$Lang::tr{'ids download new ruleset'}");
531
532 # Call subfunction to download the ruleset.
533 if(&IDS::downloadruleset()) {
534 $errormessage = $Lang::tr{'could not download latest updates'};
535
536 # Call function to store the errormessage.
537 &IDS::_store_error_message($errormessage);
538
539 # Preform a reload of the page.
540 &reload();
541 } else {
542 # Call subfunction to launch oinkmaster.
543 &IDS::oinkmaster();
544
545 # Check if the IDS is running.
546 if(&IDS::ids_is_running()) {
547 # Call suricatactrl to perform a reload.
548 &IDS::call_suricatactrl("reload");
549 }
550
551 # Perform a reload of the page.
552 &reload();
553 }
554 }
555 # Save IDS settings.
556 } elsif ($cgiparams{'IDS'} eq $Lang::tr{'save'}) {
557 my %oldidssettings;
558 my $reload_page;
559 my $monitored_zones = 0;
560
561 # Read-in current (old) IDS settings.
562 &General::readhash("$IDS::ids_settings_file", \%oldidssettings);
563
564 # Prevent form name from been stored in conf file.
565 delete $cgiparams{'IDS'};
566
567 # Check if the IDS should be enabled.
568 if ($cgiparams{'ENABLE_IDS'} eq "on") {
569 # Check if any ruleset is available. Otherwise abort and display an error.
570 unless(%idsrules) {
571 $errormessage = $Lang::tr{'ids no ruleset available'};
572 }
573
574 # Loop through the array of available interfaces.
575 foreach my $zone (@network_zones) {
576 # Convert interface name into upper case.
577 my $zone_upper = uc($zone);
578
579 # Check if the IDS is enabled for this interaces.
580 if ($cgiparams{"ENABLE_IDS_$zone_upper"}) {
581 # Increase count.
582 $monitored_zones++;
583 }
584 }
585
586 # Check if at least one zone should be monitored, or show an error.
587 unless ($monitored_zones >= 1) {
588 $errormessage = $Lang::tr{'ids no network zone'};
589 }
590 }
591
592 # Go on if there are no error messages.
593 if (!$errormessage) {
594 # Store settings into settings file.
595 &General::writehash("$IDS::ids_settings_file", \%cgiparams);
596 }
597
598 # Generate file to store the home net.
599 &IDS::generate_home_net_file();
600
601 # Temporary variable to set the ruleaction.
602 # Default is "drop" to use suricata as IPS.
603 my $ruleaction="drop";
604
605 # Check if the traffic only should be monitored.
606 if($cgiparams{'MONITOR_TRAFFIC_ONLY'} eq 'on') {
607 # Switch the ruleaction to "alert".
608 # Suricata acts as an IDS only.
609 $ruleaction="alert";
610 }
611
612 # Write the modify sid's file and pass the taken ruleaction.
613 &IDS::write_modify_sids_file($ruleaction);
614
615 # Check if "MONITOR_TRAFFIC_ONLY" has been changed.
616 if($cgiparams{'MONITOR_TRAFFIC_ONLY'} ne $oldidssettings{'MONITOR_TRAFFIC_ONLY'}) {
617 # Check if a ruleset exists.
618 if (%idsrules) {
619 # Lock the webpage and print message.
620 &working_notice("$Lang::tr{'ids working'}");
621
622 # Call oinkmaster to alter the ruleset.
623 &IDS::oinkmaster();
624
625 # Set reload_page to "True".
626 $reload_page="True";
627 }
628 }
629
630 # Check if the IDS currently is running.
631 if(&IDS::ids_is_running()) {
632 # Check if ENABLE_IDS is set to on.
633 if($cgiparams{'ENABLE_IDS'} eq "on") {
634 # Call suricatactrl to perform a reload of suricata.
635 &IDS::call_suricatactrl("reload");
636 } else {
637 # Call suricatactrl to stop suricata.
638 &IDS::call_suricatactrl("stop");
639 }
640 } else {
641 # Call suricatactrl to start suricata.
642 &IDS::call_suricatactrl("start");
643 }
644
645 # Check if the page should be reloaded.
646 if ($reload_page) {
647 # Perform a reload of the page.
648 &reload();
649 }
650 }
651
652 # Read-in idssettings and rulesetsettings
653 &General::readhash("$IDS::ids_settings_file", \%idssettings);
654 &General::readhash("$IDS::rules_settings_file", \%rulessettings);
655
656 # If no autoupdate intervall has been configured yet, set default value.
657 unless(exists($rulessettings{'AUTOUPDATE_INTERVAL'})) {
658 # Set default to "weekly".
659 $rulessettings{'AUTOUPDATE_INTERVAL'} = 'weekly';
660 }
661
662 # Read-in ignored hosts.
663 &General::readhasharray("$IDS::settingsdir/ignored", \%ignored);
664
665 $checked{'ENABLE_IDS'}{'off'} = '';
666 $checked{'ENABLE_IDS'}{'on'} = '';
667 $checked{'ENABLE_IDS'}{$idssettings{'ENABLE_IDS'}} = "checked='checked'";
668 $checked{'MONITOR_TRAFFIC_ONLY'}{'off'} = '';
669 $checked{'MONITOR_TRAFFIC_ONLY'}{'on'} = '';
670 $checked{'MONITOR_TRAFFIC_ONLY'}{$idssettings{'MONITOR_TRAFFIC_ONLY'}} = "checked='checked'";
671 $selected{'RULES'}{'nothing'} = '';
672 $selected{'RULES'}{'community'} = '';
673 $selected{'RULES'}{'emerging'} = '';
674 $selected{'RULES'}{'registered'} = '';
675 $selected{'RULES'}{'subscripted'} = '';
676 $selected{'RULES'}{$rulessettings{'RULES'}} = "selected='selected'";
677 $selected{'AUTOUPDATE_INTERVAL'}{'off'} = '';
678 $selected{'AUTOUPDATE_INTERVAL'}{'daily'} = '';
679 $selected{'AUTOUPDATE_INTERVAL'}{'weekly'} = '';
680 $selected{'AUTOUPDATE_INTERVAL'}{$rulessettings{'AUTOUPDATE_INTERVAL'}} = "selected='selected'";
681
682 &Header::openpage($Lang::tr{'intrusion detection system'}, 1, '');
683
684 ### Java Script ###
685 print"<script>\n";
686
687 # Java script variable declaration for show and hide.
688 print"var show = \"$Lang::tr{'ids show'}\"\;\n";
689 print"var hide = \"$Lang::tr{'ids hide'}\"\;\n";
690
691 print <<END
692 // JQuery function to show/hide the text input field for
693 // Oinkcode/Subscription code.
694 \$(function() {
695 \$('#RULES').change(function(){
696 if(\$('#RULES').val() == 'registered') {
697 \$('#code').show();
698 } else if(\$('#RULES').val() == 'subscripted') {
699 \$('#code').show();
700 } else if(\$('#RULES').val() == 'emerging_pro') {
701 \$('#code').show();
702 } else {
703 \$('#code').hide();
704 }
705 });
706 });
707
708 // Tiny java script function to show/hide the rules
709 // of a given category.
710 function showhide(tblname) {
711 \$("#" + tblname).toggle();
712
713 // Get current content of the span element.
714 var content = document.getElementById("span_" + tblname);
715
716 if (content.innerHTML === show) {
717 content.innerHTML = hide;
718 } else {
719 content.innerHTML = show;
720 }
721 }
722 </script>
723 END
724 ;
725
726 &Header::openbigbox('100%', 'left', '', $errormessage);
727
728 if ($errormessage) {
729 &Header::openbox('100%', 'left', $Lang::tr{'error messages'});
730 print "<class name='base'>$errormessage\n";
731 print "&nbsp;</class>\n";
732 &Header::closebox();
733 }
734
735 # Draw current state of the IDS
736 &Header::openbox('100%', 'left', $Lang::tr{'intrusion detection system'});
737
738 # Check if the IDS is running and obtain the process-id.
739 my $pid = &IDS::ids_is_running();
740
741 # Display some useful information, if suricata daemon is running.
742 if ($pid) {
743 # Gather used memory.
744 my $memory = &get_memory_usage($pid);
745
746 print <<END;
747 <table width='95%' cellspacing='0' class='tbl'>
748 <tr>
749 <th bgcolor='$color{'color20'}' colspan='3' align='left'><strong>$Lang::tr{'intrusion detection'}</strong></th>
750 </tr>
751
752 <tr>
753 <td class='base'>$Lang::tr{'guardian daemon'}</td>
754 <td align='center' colspan='2' width='75%' bgcolor='${Header::colourgreen}'><font color='white'><strong>$Lang::tr{'running'}</strong></font></td>
755 </tr>
756
757 <tr>
758 <td class='base'></td>
759 <td bgcolor='$color{'color20'}' align='center'><strong>PID</strong></td>
760 <td bgcolor='$color{'color20'}' align='center'><strong>$Lang::tr{'memory'}</strong></td>
761 </tr>
762
763 <tr>
764 <td class='base'></td>
765 <td bgcolor='$color{'color22'}' align='center'>$pid</td>
766 <td bgcolor='$color{'color22'}' align='center'>$memory KB</td>
767 </tr>
768 </table>
769 END
770 } else {
771 # Otherwise display a hint that the service is not launched.
772 print <<END;
773 <table width='95%' cellspacing='0' class='tbl'>
774 <tr>
775 <th bgcolor='$color{'color20'}' colspan='3' align='left'><strong>$Lang::tr{'intrusion detection'}</strong></th>
776 </tr>
777
778 <tr>
779 <td class='base'>$Lang::tr{'guardian daemon'}</td>
780 <td align='center' width='75%' bgcolor='${Header::colourred}'><font color='white'><strong>$Lang::tr{'stopped'}</strong></font></td>
781 </tr>
782 </table>
783 END
784 }
785
786 # Only show this area, if a ruleset is present.
787 if (%idsrules) {
788
789 print <<END
790
791 <br><br><h2>$Lang::tr{'settings'}</h2>
792
793 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
794 <table width='100%' border='0'>
795 <tr>
796 <td class='base' colspan='2'>
797 <input type='checkbox' name='ENABLE_IDS' $checked{'ENABLE_IDS'}{'on'}>&nbsp;$Lang::tr{'ids enable'}
798 </td>
799
800 <td class='base' colspan='2'>
801 <input type='checkbox' name='MONITOR_TRAFFIC_ONLY' $checked{'MONITOR_TRAFFIC_ONLY'}{'on'}>&nbsp;$Lang::tr{'ids monitor traffic only'}
802 </td>
803 </tr>
804
805 <tr>
806 <td><br><br></td>
807 <td><br><br></td>
808 <td><br><br></td>
809 <td><br><br></td>
810 </tr>
811
812 <tr>
813 <td colspan='4'><b>$Lang::tr{'ids monitored interfaces'}</b><br></td>
814 </tr>
815
816 <tr>
817 END
818 ;
819
820 # Loop through the array of available networks and print config options.
821 foreach my $zone (@network_zones) {
822 my $checked_input;
823 my $checked_forward;
824
825 # Convert current zone name to upper case.
826 my $zone_upper = uc($zone);
827
828 # Set zone name.
829 my $zone_name = $zone;
830
831 # Dirty hack to get the correct language string for the red zone.
832 if ($zone eq "red") {
833 $zone_name = "red1";
834 }
835
836 # Grab checkbox status from settings hash.
837 if ($idssettings{"ENABLE_IDS_$zone_upper"} eq "on") {
838 $checked_input = "checked = 'checked'";
839 }
840
841 print "<td class='base' width='25%'>\n";
842 print "<input type='checkbox' name='ENABLE_IDS_$zone_upper' $checked_input>\n";
843 print "&nbsp;$Lang::tr{'enabled on'}<font color='$colourhash{$zone}'> $Lang::tr{$zone_name}</font>\n";
844 print "</td>\n";
845 }
846
847 print <<END
848 </tr>
849 </table>
850
851 <br><br>
852
853 <table width='100%'>
854 <tr>
855 <td align='right'><input type='submit' name='IDS' value='$Lang::tr{'save'}' /></td>
856 </tr>
857 </table>
858 </form>
859 END
860 ;
861
862 }
863
864 &Header::closebox();
865
866 # Draw elements for ruleset configuration.
867 &Header::openbox('100%', 'center', $Lang::tr{'ids ruleset settings'});
868
869 print <<END
870 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
871 <table width='100%' border='0'>
872 <tr>
873 <td><b>$Lang::tr{'ids rules update'}</b></td>
874 <td><b>$Lang::tr{'ids automatic rules update'}</b></td>
875 </tr>
876
877 <tr>
878 <td><select name='RULES' id='RULES'>
879 <option value='emerging' $selected{'RULES'}{'emerging'} >$Lang::tr{'emerging rules'}</option>
880 <option value='emerging_pro' $selected{'RULES'}{'emerging_pro'} >$Lang::tr{'emerging pro rules'}</option>
881 <option value='community' $selected{'RULES'}{'community'} >$Lang::tr{'community rules'}</option>
882 <option value='registered' $selected{'RULES'}{'registered'} >$Lang::tr{'registered user rules'}</option>
883 <option value='subscripted' $selected{'RULES'}{'subscripted'} >$Lang::tr{'subscripted user rules'}</option>
884 </select>
885 </td>
886
887 <td>
888 <select name='AUTOUPDATE_INTERVAL'>
889 <option value='off' $selected{'AUTOUPDATE_INTERVAL'}{'off'} >- $Lang::tr{'Disabled'} -</option>
890 <option value='daily' $selected{'AUTOUPDATE_INTERVAL'}{'daily'} >$Lang::tr{'Daily'}</option>
891 <option value='weekly' $selected{'AUTOUPDATE_INTERVAL'}{'weekly'} >$Lang::tr{'Weekly'}</option>
892 </select>
893 </td>
894 </tr>
895
896 <tr>
897 <td colspan='2'><br><br></td>
898 </tr>
899
900 <tr style='display:none' id='code'>
901 <td colspan='2'>Oinkcode:&nbsp;<input type='text' size='40' name='OINKCODE' value='$rulessettings{'OINKCODE'}'></td>
902 </tr>
903
904 <tr>
905 <td>&nbsp;</td>
906
907 <td align='right'>
908 END
909 ;
910 # Show the "Update Ruleset"-Button only if a ruleset has been downloaded yet and automatic updates are disabled.
911 if ((%idsrules) && ($rulessettings{'AUTOUPDATE_INTERVAL'} eq "off")) {
912 # Display button to update the ruleset.
913 print"<input type='submit' name='RULESET' value='$Lang::tr{'update ruleset'}'>\n";
914 }
915 print <<END;
916 <input type='submit' name='RULESET' value='$Lang::tr{'save'}'>
917 </td>
918
919 </tr>
920 </table>
921 </form>
922 END
923 ;
924
925 &Header::closebox();
926
927 #
928 # Whitelist / Ignorelist
929 #
930 &Header::openbox('100%', 'center', $Lang::tr{'guardian ignored hosts'});
931
932 print <<END;
933 <table width='100%'>
934 <tr>
935 <td class='base' bgcolor='$color{'color20'}'><b>$Lang::tr{'ip address'}</b></td>
936 <td class='base' bgcolor='$color{'color20'}'><b>$Lang::tr{'remark'}</b></td>
937 <td class='base' colspan='3' bgcolor='$color{'color20'}'></td>
938 </tr>
939 END
940 # Check if some hosts have been added to be ignored.
941 if (keys (%ignored)) {
942 my $col = "";
943
944 # Loop through all entries of the hash.
945 while( (my $key) = each %ignored) {
946 # Assign data array positions to some nice variable names.
947 my $address = $ignored{$key}[0];
948 my $remark = $ignored{$key}[1];
949 my $status = $ignored{$key}[2];
950
951 # Check if the key (id) number is even or not.
952 if ($cgiparams{'ID'} eq $key) {
953 $col="bgcolor='${Header::colouryellow}'";
954 } elsif ($key % 2) {
955 $col="bgcolor='$color{'color22'}'";
956 } else {
957 $col="bgcolor='$color{'color20'}'";
958 }
959
960 # Choose icon for the checkbox.
961 my $gif;
962 my $gdesc;
963
964 # Check if the status is enabled and select the correct image and description.
965 if ($status eq 'enabled' ) {
966 $gif = 'on.gif';
967 $gdesc = $Lang::tr{'click to disable'};
968 } else {
969 $gif = 'off.gif';
970 $gdesc = $Lang::tr{'click to enable'};
971 }
972
973 print <<END;
974 <tr>
975 <td width='20%' class='base' $col>$address</td>
976 <td width='65%' class='base' $col>$remark</td>
977
978 <td align='center' $col>
979 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
980 <input type='hidden' name='WHITELIST' value='$Lang::tr{'toggle enable disable'}' />
981 <input type='image' name='$Lang::tr{'toggle enable disable'}' src='/images/$gif' alt='$gdesc' title='$gdesc' />
982 <input type='hidden' name='ID' value='$key' />
983 </form>
984 </td>
985
986 <td align='center' $col>
987 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
988 <input type='hidden' name='WHITELIST' value='$Lang::tr{'edit'}' />
989 <input type='image' name='$Lang::tr{'edit'}' src='/images/edit.gif' alt='$Lang::tr{'edit'}' title='$Lang::tr{'edit'}' />
990 <input type='hidden' name='ID' value='$key' />
991 </form>
992 </td>
993
994 <td align='center' $col>
995 <form method='post' name='$key' action='$ENV{'SCRIPT_NAME'}'>
996 <input type='image' name='$Lang::tr{'remove'}' src='/images/delete.gif' title='$Lang::tr{'remove'}' alt='$Lang::tr{'remove'}'>
997 <input type='hidden' name='ID' value='$key'>
998 <input type='hidden' name='WHITELIST' value='$Lang::tr{'remove'}'>
999 </form>
1000 </td>
1001 </tr>
1002 END
1003 }
1004 } else {
1005 # Print notice that currently no hosts are ignored.
1006 print "<tr>\n";
1007 print "<td class='base' colspan='2'>$Lang::tr{'guardian no entries'}</td>\n";
1008 print "</tr>\n";
1009 }
1010
1011 print "</table>\n";
1012
1013 # Section to add new elements or edit existing ones.
1014 print <<END;
1015 <br>
1016 <hr>
1017 <br>
1018
1019 <div align='center'>
1020 <table width='100%'>
1021 END
1022
1023 # Assign correct headline and button text.
1024 my $buttontext;
1025 my $entry_address;
1026 my $entry_remark;
1027
1028 # Check if an ID (key) has been given, in this case an existing entry should be edited.
1029 if ($cgiparams{'ID'} ne '') {
1030 $buttontext = $Lang::tr{'update'};
1031 print "<tr><td class='boldbase' colspan='3'><b>$Lang::tr{'update'}</b></td></tr>\n";
1032
1033 # Grab address and remark for the given key.
1034 $entry_address = $ignored{$cgiparams{'ID'}}[0];
1035 $entry_remark = $ignored{$cgiparams{'ID'}}[1];
1036 } else {
1037 $buttontext = $Lang::tr{'add'};
1038 print "<tr><td class='boldbase' colspan='3'><b>$Lang::tr{'dnsforward add a new entry'}</b></td></tr>\n";
1039 }
1040
1041 print <<END;
1042 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
1043 <input type='hidden' name='ID' value='$cgiparams{'ID'}'>
1044 <tr>
1045 <td width='30%'>$Lang::tr{'ip address'}: </td>
1046 <td width='50%'><input type='text' name='IGNORE_ENTRY_ADDRESS' value='$entry_address' size='24' /></td>
1047
1048 <td width='30%'>$Lang::tr{'remark'}: </td>
1049 <td wicth='50%'><input type='text' name=IGNORE_ENTRY_REMARK value='$entry_remark' size='24' /></td>
1050 <td align='center' width='20%'><input type='submit' name='WHITELIST' value='$buttontext' /></td>
1051 </tr>
1052 </form>
1053 </table>
1054 </div>
1055 END
1056
1057 &Header::closebox();
1058
1059 # Only show the section for configuring the ruleset if one is present.
1060 if (%idsrules) {
1061 # Load neccessary perl modules for file stat and to format the timestamp.
1062 use File::stat;
1063 use POSIX qw( strftime );
1064
1065 # Call stat on the rulestarball.
1066 my $stat = stat("$IDS::rulestarball");
1067
1068 # Get timestamp the file creation.
1069 my $mtime = $stat->mtime;
1070
1071 # Convert into human read-able format.
1072 my $rulesdate = strftime('%Y-%m-%d %H:%M:%S', localtime($mtime));
1073
1074 &Header::openbox('100%', 'LEFT', "$Lang::tr{'intrusion detection system rules'} ($rulesdate)" );
1075
1076 print"<form method='POST' action='$ENV{'SCRIPT_NAME'}'>\n";
1077
1078 # Output display table for rule files
1079 print "<table width='100%'>\n";
1080
1081 # Loop over each rule file
1082 foreach my $rulefile (sort keys(%idsrules)) {
1083 my $rulechecked = '';
1084
1085 # Check if rule file is enabled
1086 if ($idsrules{$rulefile}{'Rulefile'}{'State'} eq 'on') {
1087 $rulechecked = 'CHECKED';
1088 }
1089
1090 # Convert rulefile name into category name.
1091 my $categoryname = &_rulefile_to_category($rulefile);
1092
1093 # Table and rows for the rule files.
1094 print"<tr>\n";
1095 print"<td class='base' width='5%'>\n";
1096 print"<input type='checkbox' name='$rulefile' $rulechecked>\n";
1097 print"</td>\n";
1098 print"<td class='base' width='90%'><b>$rulefile</b></td>\n";
1099 print"<td class='base' width='5%' align='right'>\n";
1100 print"<a href=\"javascript:showhide('$categoryname')\"><span id='span_$categoryname'>$Lang::tr{'ids show'}</span></a>\n";
1101 print"</td>\n";
1102 print"</tr>\n";
1103
1104 # Rows which will be hidden per default and will contain the single rules.
1105 print"<tr style='display:none' id='$categoryname'>\n";
1106 print"<td colspan='3'>\n";
1107
1108 # Local vars
1109 my $lines;
1110 my $rows;
1111 my $col;
1112
1113 # New table for the single rules.
1114 print "<table width='100%'>\n";
1115
1116 # Loop over rule file rules
1117 foreach my $sid (sort {$a <=> $b} keys(%{$idsrules{$rulefile}})) {
1118 # Local vars
1119 my $ruledefchecked = '';
1120
1121 # Skip rulefile itself.
1122 next if ($sid eq "Rulefile");
1123
1124 # If 2 rules have been displayed, start a new row
1125 if (($lines % 2) == 0) {
1126 print "</tr><tr>\n";
1127
1128 # Increase rows by once.
1129 $rows++;
1130 }
1131
1132 # Colour lines.
1133 if ($rows % 2) {
1134 $col="bgcolor='$color{'color20'}'";
1135 } else {
1136 $col="bgcolor='$color{'color22'}'";
1137 }
1138
1139 # Set rule state
1140 if ($idsrules{$rulefile}{$sid}{'State'} eq 'on') {
1141 $ruledefchecked = 'CHECKED';
1142 }
1143
1144 # Create rule checkbox and display rule description
1145 print "<td class='base' width='5%' align='right' $col>\n";
1146 print "<input type='checkbox' NAME='$sid' $ruledefchecked>\n";
1147 print "</td>\n";
1148 print "<td class='base' width='45%' $col>$idsrules{$rulefile}{$sid}{'Description'}</td>";
1149
1150 # Increment rule count
1151 $lines++;
1152 }
1153
1154 # If do not have a second rule for row, create empty cell
1155 if (($lines % 2) != 0) {
1156 print "<td class='base'></td>";
1157 }
1158
1159 # Close display table
1160 print "</tr></table></td></tr>";
1161 }
1162
1163 # Close display table
1164 print "</table>";
1165
1166 print <<END
1167 <table width='100%'>
1168 <tr>
1169 <td width='100%' align='right'><input type='submit' name='RULESET' value='$Lang::tr{'ids apply'}'></td>
1170 </tr>
1171 </table>
1172 </form>
1173 END
1174 ;
1175 &Header::closebox();
1176 }
1177
1178 &Header::closebigbox();
1179 &Header::closepage();
1180
1181 #
1182 ## A function to display a notice, to lock the webpage and
1183 ## tell the user which action currently will be performed.
1184 #
1185 sub working_notice ($) {
1186 my ($message) = @_;
1187
1188 &Header::openpage($Lang::tr{'intrusion detection system'}, 1, '');
1189 &Header::openbigbox('100%', 'left', '', $errormessage);
1190 &Header::openbox( 'Waiting', 1,);
1191 print <<END;
1192 <table>
1193 <tr>
1194 <td><img src='/images/indicator.gif' alt='$Lang::tr{'aktiv'}' /></td>
1195 <td>$message</td>
1196 </tr>
1197 </table>
1198 END
1199 &Header::closebox();
1200 &Header::closebigbox();
1201 &Header::closepage();
1202 }
1203
1204 #
1205 ## A tiny function to perform a reload of the webpage after one second.
1206 #
1207 sub reload () {
1208 print "<meta http-equiv='refresh' content='1'>\n";
1209
1210 # Stop the script.
1211 exit;
1212 }
1213
1214 #
1215 ## Private function to read-in and parse rules of a given rulefile.
1216 #
1217 ## The given file will be read, parsed and all valid rules will be stored by ID,
1218 ## message/description and it's state in the idsrules hash.
1219 #
1220 sub readrulesfile ($) {
1221 my $rulefile = shift;
1222
1223 # Open rule file and read in contents
1224 open(RULEFILE, "$IDS::rulespath/$rulefile") or die "Unable to read $rulefile!";
1225
1226 # Store file content in an array.
1227 my @lines = <RULEFILE>;
1228
1229 # Close file.
1230 close(RULEFILE);
1231
1232 # Loop over rule file contents
1233 foreach my $line (@lines) {
1234 # Remove whitespaces.
1235 chomp $line;
1236
1237 # Skip blank lines.
1238 next if ($line =~ /^\s*$/);
1239
1240 # Local vars.
1241 my $sid;
1242 my $msg;
1243
1244 # Gather rule sid and message from the ruleline.
1245 if ($line =~ m/.*msg:\"(.*?)\"\; .* sid:(.*?); /) {
1246 $msg = $1;
1247 $sid = $2;
1248
1249 # Check if a rule has been found.
1250 if ($sid && $msg) {
1251 # Add rule to the idsrules hash.
1252 $idsrules{$rulefile}{$sid}{'Description'} = $msg;
1253
1254 # Grab status of the rule. Check if ruleline starts with a "dash".
1255 if ($line =~ /^\#/) {
1256 # If yes, the rule is disabled.
1257 $idsrules{$rulefile}{$sid}{'State'} = "off";
1258 } else {
1259 # Otherwise the rule is enabled.
1260 $idsrules{$rulefile}{$sid}{'State'} = "on";
1261 }
1262 }
1263 }
1264 }
1265 }
1266
1267 #
1268 ## Function to get the used memory of a given process-id.
1269 #
1270 sub get_memory_usage($) {
1271 my ($pid) = @_;
1272
1273 my $memory = 0;
1274
1275 # Try to open the status file for the given process-id on the pseudo
1276 # file system proc.
1277 if (open(FILE, "/proc/$pid/status")) {
1278 # Loop through the entire file.
1279 while (<FILE>) {
1280 # Splitt current line content and store them into variables.
1281 my ($key, $value) = split(":", $_, 2);
1282
1283 # Check if the current key is the one which contains the memory usage.
1284 # The wanted one is VmRSS which contains the Real-memory (resident set)
1285 # of the entire process.
1286 if ($key eq "VmRSS") {
1287 # Found the memory usage add it to the memory variable.
1288 $memory += $value;
1289
1290 # Break the loop.
1291 last;
1292 }
1293 }
1294
1295 # Close file handle.
1296 close(FILE);
1297
1298 # Return memory usage.
1299 return $memory;
1300 }
1301
1302 # If the file could not be open, return nothing.
1303 return;
1304 }
1305
1306 #
1307 ## Function to read-in the given enabled or disables sids file.
1308 #
1309 sub read_enabled_disabled_sids_file($) {
1310 my ($file) = @_;
1311
1312 # Temporary hash to store the sids and their state. It will be
1313 # returned at the end of this function.
1314 my %temphash;
1315
1316 # Open the given filename.
1317 open(FILE, "$file") or die "Could not open $file. $!\n";
1318
1319 # Loop through the file.
1320 while(<FILE>) {
1321 # Remove newlines.
1322 chomp $_;
1323
1324 # Skip blank lines.
1325 next if ($_ =~ /^\s*$/);
1326
1327 # Skip coments.
1328 next if ($_ =~ /^\#/);
1329
1330 # Splitt line into sid and state part.
1331 my ($state, $sid) = split(" ", $_);
1332
1333 # Skip line if the sid is not numeric.
1334 next unless ($sid =~ /\d+/ );
1335
1336 # Check if the sid was enabled.
1337 if ($state eq "enablesid") {
1338 # Add the sid and its state as enabled to the temporary hash.
1339 $temphash{$sid} = "enabled";
1340 # Check if the sid was disabled.
1341 } elsif ($state eq "disablesid") {
1342 # Add the sid and its state as disabled to the temporary hash.
1343 $temphash{$sid} = "disabled";
1344 # Invalid state - skip the current sid and state.
1345 } else {
1346 next;
1347 }
1348 }
1349
1350 # Close filehandle.
1351 close(FILE);
1352
1353 # Return the hash.
1354 return %temphash;
1355 }
1356
1357 #
1358 ## Private function to convert a given rulefile to a category name.
1359 ## ( No file extension anymore and if the name contained a dot, it
1360 ## would be replaced by a underline sign.)
1361 #
1362 sub _rulefile_to_category($) {
1363 my ($filename) = @_;
1364
1365 # Splitt the filename into single chunks and store them in a
1366 # temorary array.
1367 my @parts = split(/\./, $filename);
1368
1369 # Return / Remove last element of the temporary array.
1370 # This removes the file extension.
1371 pop @parts;
1372
1373 # Join together the single elements of the temporary array.
1374 # If these are more than one, use a "underline" for joining.
1375 my $category = join '_', @parts;
1376
1377 # Return the converted filename.
1378 return $category;
1379 }