html/cgi-bin/ids.cgi

   1 #!/usr/bin/perl
   2 ###############################################################################
   3 #                                                                             #
   4 # IPFire.org - A linux based firewall                                         #
   5 # Copyright (C) 2007-2020  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 require "${General::swroot}/network-functions.pl";
  33
  34 # Import ruleset providers file.
  35 require "$IDS::rulesetsourcesfile";
  36
  37 my %color = ();
  38 my %mainsettings = ();
  39 my %idsrules = ();
  40 my %idssettings=();
  41 my %used_providers=();
  42 my %cgiparams=();
  43 my %checked=();
  44 my %selected=();
  45 my %ignored=();
  46
  47 # Read-in main settings, for language, theme and colors.
  48 &General::readhash("${General::swroot}/main/settings", \%mainsettings);
  49 &General::readhash("/srv/web/ipfire/html/themes/ipfire/include/colors.txt", \%color);
  50
  51 # Get the available network zones, based on the config type of the system and store
  52 # the list of zones in an array.
  53 my @network_zones = &Network::get_available_network_zones();
  54
  55 # Check if openvpn is started and add it to the array of network zones.
  56 if ( -e "/var/run/openvpn.pid") {
  57         push(@network_zones, "ovpn");
  58 }
  59
  60 my $errormessage;
  61
  62 # Create files if they does not exist yet.
  63 &IDS::check_and_create_filelayout();
  64
  65 # Hash which contains the colour code of a network zone.
  66 my %colourhash = (
  67         'red' => $Header::colourred,
  68         'green' => $Header::colourgreen,
  69         'blue' => $Header::colourblue,
  70         'orange' => $Header::colourorange,
  71         'ovpn' => $Header::colourovpn
  72 );
  73
  74 &Header::showhttpheaders();
  75
  76 #Get GUI values
  77 &Header::getcgihash(\%cgiparams);
  78
  79 ## Add/edit an entry to the ignore file.
  80 #
  81 if (($cgiparams{'WHITELIST'} eq $Lang::tr{'add'}) || ($cgiparams{'WHITELIST'} eq $Lang::tr{'update'})) {
  82
  83         # Check if any input has been performed.
  84         if ($cgiparams{'IGNORE_ENTRY_ADDRESS'} ne '') {
  85
  86                 # Check if the given input is no valid IP-address or IP-address with subnet, display an error message.
  87                 if ((!&General::validip($cgiparams{'IGNORE_ENTRY_ADDRESS'})) && (!&General::validipandmask($cgiparams{'IGNORE_ENTRY_ADDRESS'}))) {
  88                         $errormessage = "$Lang::tr{'guardian invalid address or subnet'}";
  89                 }
  90         } else {
  91                 $errormessage = "$Lang::tr{'guardian empty input'}";
  92         }
  93
  94         # Go further if there was no error.
  95         if ($errormessage eq '') {
  96                 my %ignored = ();
  97                 my $id;
  98                 my $status;
  99
 100                 # Assign hash values.
 101                 my $new_entry_address = $cgiparams{'IGNORE_ENTRY_ADDRESS'};
 102                 my $new_entry_remark = $cgiparams{'IGNORE_ENTRY_REMARK'};
 103
 104                 # Read-in ignoredfile.
 105                 &General::readhasharray($IDS::ignored_file, \%ignored);
 106
 107                 # Check if we should edit an existing entry and got an ID.
 108                 if (($cgiparams{'WHITELIST'} eq $Lang::tr{'update'}) && ($cgiparams{'ID'})) {
 109                         # Assin the provided id.
 110                         $id = $cgiparams{'ID'};
 111
 112                         # Undef the given ID.
 113                         undef($cgiparams{'ID'});
 114
 115                         # Grab the configured status of the corresponding entry.
 116                         $status = $ignored{$id}[2];
 117                 } else {
 118                         # Each newly added entry automatically should be enabled.
 119                         $status = "enabled";
 120
 121                         # Generate the ID for the new entry.
 122                         #
 123                         # Sort the keys by their ID and store them in an array.
 124                         my @keys = sort { $a <=> $b } keys %ignored;
 125
 126                         # Reverse the key array.
 127                         my @reversed = reverse(@keys);
 128
 129                         # Obtain the last used id.
 130                         my $last_id = @reversed[0];
 131
 132                         # Increase the last id by one and use it as id for the new entry.
 133                         $id = ++$last_id;
 134                 }
 135
 136                 # Add/Modify the entry to/in the ignored hash.
 137                 $ignored{$id} = ["$new_entry_address", "$new_entry_remark", "$status"];
 138
 139                 # Write the changed ignored hash to the ignored file.
 140                 &General::writehasharray($IDS::ignored_file, \%ignored);
 141
 142                 # Regenerate the ignore file.
 143                 &IDS::generate_ignore_file();
 144         }
 145
 146         # Check if the IDS is running.
 147         if(&IDS::ids_is_running()) {
 148                 # Call suricatactrl to perform a reload.
 149                 &IDS::call_suricatactrl("reload");
 150         }
 151
 152 ## Toggle Enabled/Disabled for an existing entry on the ignore list.
 153 #
 154
 155 } elsif ($cgiparams{'WHITELIST'} eq $Lang::tr{'toggle enable disable'}) {
 156         my %ignored = ();
 157
 158         # Only go further, if an ID has been passed.
 159         if ($cgiparams{'ID'}) {
 160                 # Assign the given ID.
 161                 my $id = $cgiparams{'ID'};
 162
 163                 # Undef the given ID.
 164                 undef($cgiparams{'ID'});
 165
 166                 # Read-in ignoredfile.
 167                 &General::readhasharray($IDS::ignored_file, \%ignored);
 168
 169                 # Grab the configured status of the corresponding entry.
 170                 my $status = $ignored{$id}[2];
 171
 172                 # Switch the status.
 173                 if ($status eq "disabled") {
 174                         $status = "enabled";
 175                 } else {
 176                         $status = "disabled";
 177                 }
 178
 179                 # Modify the status of the existing entry.
 180                 $ignored{$id} = ["$ignored{$id}[0]", "$ignored{$id}[1]", "$status"];
 181
 182                 # Write the changed ignored hash to the ignored file.
 183                 &General::writehasharray($IDS::ignored_file, \%ignored);
 184
 185                 # Regenerate the ignore file.
 186                 &IDS::generate_ignore_file();
 187
 188                 # Check if the IDS is running.
 189                 if(&IDS::ids_is_running()) {
 190                         # Call suricatactrl to perform a reload.
 191                         &IDS::call_suricatactrl("reload");
 192                 }
 193         }
 194
 195 ## Remove entry from ignore list.
 196 #
 197 } elsif ($cgiparams{'WHITELIST'} eq $Lang::tr{'remove'}) {
 198         my %ignored = ();
 199
 200         # Read-in ignoredfile.
 201         &General::readhasharray($IDS::ignored_file, \%ignored);
 202
 203         # Drop entry from the hash.
 204         delete($ignored{$cgiparams{'ID'}});
 205
 206         # Undef the given ID.
 207         undef($cgiparams{'ID'});
 208
 209         # Write the changed ignored hash to the ignored file.
 210         &General::writehasharray($IDS::ignored_file, \%ignored);
 211
 212         # Regenerate the ignore file.
 213         &IDS::generate_ignore_file();
 214
 215         # Check if the IDS is running.
 216         if(&IDS::ids_is_running()) {
 217                 # Call suricatactrl to perform a reload.
 218                 &IDS::call_suricatactrl("reload");
 219         }
 220 }
 221
 222 # Check if the page is locked, in this case, the ids_page_lock_file exists.
 223 if (-e $IDS::ids_page_lock_file) {
 224         # Lock the webpage and print notice about autoupgrade of the ruleset
 225         # is in progess.
 226         &working_notice("$Lang::tr{'ids ruleset autoupdate in progress'}");
 227
 228         # Loop and check if the file still exists.
 229         while(-e $IDS::ids_page_lock_file) {
 230                 # Sleep for a second and re-check.
 231                 sleep 1;
 232         }
 233
 234         # Page has been unlocked, perform a reload.
 235         &reload();
 236 }
 237
 238 # Check if any error has been stored.
 239 if (-e $IDS::storederrorfile) {
 240         # Open file to read in the stored error message.
 241         open(FILE, "<$IDS::storederrorfile") or die "Could not open $IDS::storederrorfile. $!\n";
 242
 243         # Read the stored error message.
 244         $errormessage = <FILE>;
 245
 246         # Close file.
 247         close (FILE);
 248
 249         # Delete the file, which is now not longer required.
 250         unlink($IDS::storederrorfile);
 251 }
 252
 253 # Gather ruleset details.
 254 if ($cgiparams{'RULESET'}) {
 255         ## Grab all available rules and store them in the idsrules hash.
 256         #
 257
 258         # Get enabled providers.
 259         my @enabled_providers = &IDS::get_enabled_providers();
 260
 261         # Open rules directory and do a directory listing.
 262         opendir(DIR, $IDS::rulespath) or die $!;
 263                 # Loop through the direcory.
 264                 while (my $file = readdir(DIR)) {
 265
 266                         # We only want files.
 267                         next unless (-f "$IDS::rulespath/$file");
 268
 269                         # Ignore empty files.
 270                         next if (-z "$IDS::rulespath/$file");
 271
 272                         # Use a regular expression to find files ending in .rules
 273                         next unless ($file =~ m/\.rules$/);
 274
 275                         # Ignore files which are not read-able.
 276                         next unless (-R "$IDS::rulespath/$file");
 277
 278                         # Skip whitelist rules file.
 279                         next if( $file eq "whitelist.rules");
 280
 281                         # Splitt vendor from filename.
 282                         my @filename_parts = split(/-/, $file);
 283
 284                         # Assign vendor name for easy processing.
 285                         my $vendor = @filename_parts[0];
 286
 287                         # Skip rulefile if the provider is disabled.
 288                         next unless ($vendor ~~ @enabled_providers);
 289
 290                         # Call subfunction to read-in rulefile and add rules to
 291                         # the idsrules hash.
 292                         &readrulesfile("$file");
 293                 }
 294
 295         closedir(DIR);
 296
 297         # Loop through the array of used providers.
 298         foreach my $provider (@enabled_providers) {
 299                 # Gather used rulefiles.
 300                 my @used_rulesfiles = &IDS::read_used_provider_rulesfiles($provider);
 301
 302                 # Loop through the array of used rulesfiles.
 303                 foreach my $rulefile (@used_rulesfiles) {
 304                         # Check if the current rulefile exists in the %idsrules hash.
 305                         # If not, the file probably does not exist anymore or contains
 306                         # no rules.
 307                         if($idsrules{$rulefile}) {
 308                                 # Add the rulefile state to the %idsrules hash.
 309                                 $idsrules{$rulefile}{'Rulefile'}{'State'} = "on";
 310                         }
 311                 }
 312         }
 313 }
 314
 315 # Save ruleset.
 316 if ($cgiparams{'RULESET'} eq $Lang::tr{'ids apply'}) {
 317         # Arrays to store which rulefiles have been enabled and will be used.
 318         my @enabled_rulefiles;
 319
 320         # Hash to store the user-enabled and disabled sids.
 321         my %enabled_disabled_sids;
 322
 323         # Store if a restart of suricata is required.
 324         my $suricata_restart_required;
 325
 326         # Loop through the hash of idsrules.
 327         foreach my $rulefile(keys %idsrules) {
 328                 # Check if the state of the rulefile has been changed.
 329                 unless ($cgiparams{$rulefile} eq $idsrules{$rulefile}{'Rulefile'}{'State'}) {
 330                         # A restart of suricata is required to apply the changes of the used rulefiles.
 331                         $suricata_restart_required = 1;
 332                 }
 333
 334                 # Check if the rulefile is enabled.
 335                 if ($cgiparams{$rulefile} eq "on") {
 336                         # Add rulefile to the array of enabled rulefiles.
 337                         push(@enabled_rulefiles, $rulefile);
 338
 339                         # Drop item from cgiparams hash.
 340                         delete $cgiparams{$rulefile};
 341                 }
 342         }
 343
 344         # Read-in the files for enabled/disabled sids.
 345         # This will be done by calling the read_enabled_disabled_sids_file function two times
 346         # and merge the returned hashes together into the enabled_disabled_sids hash.
 347         %enabled_disabled_sids = (
 348                 &read_enabled_disabled_sids_file($IDS::disabled_sids_file),
 349                 &read_enabled_disabled_sids_file($IDS::enabled_sids_file));
 350
 351         # Loop through the hash of idsrules.
 352         foreach my $rulefile (keys %idsrules) {
 353                 # Loop through the single rules of the rulefile.
 354                 foreach my $sid (keys %{$idsrules{$rulefile}}) {
 355                         # Skip the current sid if it is not numeric.
 356                         next unless ($sid =~ /\d+/ );
 357
 358                         # Check if there exists a key in the cgiparams hash for this sid.
 359                         if (exists($cgiparams{$sid})) {
 360                                 # Look if the rule is disabled.
 361                                 if ($idsrules{$rulefile}{$sid}{'State'} eq "off") {
 362                                         # Check if the state has been set to 'on'.
 363                                         if ($cgiparams{$sid} eq "on") {
 364                                                 # Add/Modify the sid to/in the enabled_disabled_sids hash.
 365                                                 $enabled_disabled_sids{$sid} = "enabled";
 366
 367                                                 # Drop item from cgiparams hash.
 368                                                 delete $cgiparams{$rulefile}{$sid};
 369                                         }
 370                                 }
 371                         } else {
 372                                 # Look if the rule is enabled.
 373                                 if ($idsrules{$rulefile}{$sid}{'State'} eq "on") {
 374                                         # Check if the state is 'on' and should be disabled.
 375                                         # In this case there is no entry
 376                                         # for the sid in the cgiparams hash.
 377                                         # Add/Modify it to/in the enabled_disabled_sids hash.
 378                                         $enabled_disabled_sids{$sid} = "disabled";
 379
 380                                         # Drop item from cgiparams hash.
 381                                         delete $cgiparams{$rulefile}{$sid};
 382                                 }
 383                         }
 384                 }
 385         }
 386
 387         # Open enabled sid's file for writing.
 388         open(ENABLED_FILE, ">$IDS::enabled_sids_file") or die "Could not write to $IDS::enabled_sids_file. $!\n";
 389
 390         # Open disabled sid's file for writing.
 391         open(DISABLED_FILE, ">$IDS::disabled_sids_file") or die "Could not write to $IDS::disabled_sids_file. $!\n";
 392
 393         # Write header to the files.
 394         print ENABLED_FILE "#Autogenerated file. Any custom changes will be overwritten!\n";
 395         print DISABLED_FILE "#Autogenerated file. Any custom changes will be overwritten!\n";
 396
 397         # Check if the hash for enabled/disabled files contains any entries.
 398         if (%enabled_disabled_sids) {
 399                 # Loop through the hash.
 400                 foreach my $sid (keys %enabled_disabled_sids) {
 401                         # Check if the sid is enabled.
 402                         if ($enabled_disabled_sids{$sid} eq "enabled") {
 403                                 # Print the sid to the enabled_sids file.
 404                                 print ENABLED_FILE "enablesid $sid\n";
 405                         # Check if the sid is disabled.
 406                         } elsif ($enabled_disabled_sids{$sid} eq "disabled") {
 407                                 # Print the sid to the disabled_sids file.
 408                                 print DISABLED_FILE "disablesid $sid\n";
 409                         # Something strange happende - skip the current sid.
 410                         } else {
 411                                 next;
 412                         }
 413                 }
 414         }
 415
 416         # Close file for enabled_sids after writing.
 417         close(ENABLED_FILE);
 418
 419         # Close file for disabled_sids after writing.
 420         close(DISABLED_FILE);
 421
 422         # Handle enabled / disabled rulefiles.
 423         #
 424         # Get enabled providers.
 425         my @enabled_providers = &IDS::get_enabled_providers();
 426
 427         # Loop through the array of enabled providers.
 428         foreach my $provider(@enabled_providers) {
 429                 # Array to store the rulefiles which belong to the current processed provider.
 430                 my @provider_rulefiles = ();
 431
 432                 # Loop through the array of enabled rulefiles.
 433                 foreach my $rulesfile (@enabled_rulefiles) {
 434                         # Split the rulefile name.
 435                         my @filename_parts = split(/-/, "$rulesfile");
 436
 437                         # Assign vendor name for easy processings.
 438                         my $vendor = @filename_parts[0];
 439
 440                         # Check if the rulesvendor is our current processed enabled provider.
 441                         if ("$vendor" eq "$provider") {
 442                                 # Add the rulesfile to the array of provider rulesfiles.
 443                                 push(@provider_rulefiles, $rulesfile);
 444                         }
 445
 446                         # Check if any rulesfiles have been found for this provider.
 447                         if (@provider_rulefiles) {
 448                                 # Call function and write the providers used rulesfile file.
 449                                 &IDS::write_used_provider_rulefiles_file($provider, @provider_rulefiles);
 450                         }
 451                 }
 452         }
 453
 454         # Call function to generate and write the used rulefiles file.
 455         &IDS::write_main_used_rulefiles_file(@enabled_providers);
 456
 457         # Lock the webpage and print message.
 458         &working_notice("$Lang::tr{'ids apply ruleset changes'}");
 459
 460         # Call oinkmaster to alter the ruleset.
 461         &IDS::oinkmaster();
 462
 463         # Check if the IDS is running.
 464         if(&IDS::ids_is_running()) {
 465                 # Check if a restart of suricata is required.
 466                 if ($suricata_restart_required) {
 467                         # Call suricatactrl to perform the restart.
 468                         &IDS::call_suricatactrl("restart");
 469                 } else {
 470                         # Call suricatactrl to perform a reload.
 471                         &IDS::call_suricatactrl("reload");
 472                 }
 473         }
 474
 475         # Reload page.
 476         &reload();
 477
 478 # Download new ruleset.
 479 } elsif ($cgiparams{'RULESET'} eq $Lang::tr{'update ruleset'}) {
 480         # Check if the red device is active.
 481         unless (-e "${General::swroot}/red/active") {
 482                 $errormessage = "$Lang::tr{'could not download latest updates'} - $Lang::tr{'system is offline'}";
 483         }
 484
 485         # Check if enought free disk space is availabe.
 486         if(&IDS::checkdiskspace()) {
 487                 $errormessage = "$Lang::tr{'not enough disk space'}";
 488         }
 489
 490         # Check if any errors happend.
 491         unless ($errormessage) {
 492                 # Lock the webpage and print notice about downloading
 493                 # a new ruleset.
 494                 &working_notice("$Lang::tr{'ids download new ruleset'}");
 495
 496                 # Call subfunction to download the ruleset.
 497                 if(&IDS::downloadruleset()) {
 498                         $errormessage = $Lang::tr{'could not download latest updates'};
 499
 500                         # Call function to store the errormessage.
 501                         &IDS::_store_error_message($errormessage);
 502
 503                         # Preform a reload of the page.
 504                         &reload();
 505                 } else {
 506                         # Call subfunction to launch oinkmaster.
 507                         &IDS::oinkmaster();
 508
 509                         # Check if the IDS is running.
 510                         if(&IDS::ids_is_running()) {
 511                                 # Call suricatactrl to perform a reload.
 512                                 &IDS::call_suricatactrl("reload");
 513                         }
 514
 515                         # Perform a reload of the page.
 516                         &reload();
 517                 }
 518         }
 519 # Save IDS settings.
 520 } elsif ($cgiparams{'IDS'} eq $Lang::tr{'save'}) {
 521         my %oldidssettings;
 522         my $reload_page;
 523         my $monitored_zones = 0;
 524
 525         # Read-in current (old) IDS settings.
 526         &General::readhash("$IDS::ids_settings_file", \%oldidssettings);
 527
 528         # Prevent form name from been stored in conf file.
 529         delete $cgiparams{'IDS'};
 530
 531         # Check if the IDS should be enabled.
 532         if ($cgiparams{'ENABLE_IDS'} eq "on") {
 533                 # Check if any ruleset is available. Otherwise abort and display an error.
 534                 unless(%used_providers) {
 535                         $errormessage = $Lang::tr{'ids no ruleset available'};
 536                 }
 537
 538                 # Loop through the array of available interfaces.
 539                 foreach my $zone (@network_zones) {
 540                         # Convert interface name into upper case.
 541                         my $zone_upper = uc($zone);
 542
 543                         # Check if the IDS is enabled for this interaces.
 544                         if ($cgiparams{"ENABLE_IDS_$zone_upper"}) {
 545                                 # Increase count.
 546                                 $monitored_zones++;
 547                         }
 548                 }
 549
 550                 # Check if at least one zone should be monitored, or show an error.
 551                 unless ($monitored_zones >= 1) {
 552                         $errormessage = $Lang::tr{'ids no network zone'};
 553                 }
 554         }
 555
 556         # Go on if there are no error messages.
 557         if (!$errormessage) {
 558                 # Store settings into settings file.
 559                 &General::writehash("$IDS::ids_settings_file", \%cgiparams);
 560         }
 561
 562         # Check if the the automatic rule update hass been touched.
 563         if($cgiparams{'AUTOUPDATE_INTERVAL'} ne $oldidssettings{'AUTOUPDATE_INTERVAL'}) {
 564                 # Call suricatactrl to set the new interval.
 565                 &IDS::call_suricatactrl("cron", $cgiparams{'AUTOUPDATE_INTERVAL'});
 566         }
 567
 568         # Generate file to store the home net.
 569         &IDS::generate_home_net_file();
 570
 571         # Generate file to the store the DNS servers.
 572         &IDS::generate_dns_servers_file();
 573
 574         # Generate file to store the HTTP ports.
 575         &IDS::generate_http_ports_file();
 576
 577         # Write the modify sid's file and pass the taken ruleaction.
 578         &IDS::write_modify_sids_file();
 579
 580         # Check if "MONITOR_TRAFFIC_ONLY" has been changed.
 581         if($cgiparams{'MONITOR_TRAFFIC_ONLY'} ne $oldidssettings{'MONITOR_TRAFFIC_ONLY'}) {
 582                 # Check if a ruleset exists.
 583                 if (%used_providers) {
 584                         # Lock the webpage and print message.
 585                         &working_notice("$Lang::tr{'ids working'}");
 586
 587                         # Call oinkmaster to alter the ruleset.
 588                         &IDS::oinkmaster();
 589
 590                         # Set reload_page to "True".
 591                         $reload_page="True";
 592                 }
 593         }
 594
 595         # Check if the IDS currently is running.
 596         if(&IDS::ids_is_running()) {
 597                 # Check if ENABLE_IDS is set to on.
 598                 if($cgiparams{'ENABLE_IDS'} eq "on") {
 599                         # Call suricatactrl to perform a reload of suricata.
 600                         &IDS::call_suricatactrl("reload");
 601                 } else {
 602                         # Call suricatactrl to stop suricata.
 603                         &IDS::call_suricatactrl("stop");
 604                 }
 605         } else {
 606                 # Call suricatactrl to start suricata.
 607                 &IDS::call_suricatactrl("start");
 608         }
 609
 610         # Check if the page should be reloaded.
 611         if ($reload_page) {
 612                 # Perform a reload of the page.
 613                 &reload();
 614         }
 615
 616 # Toggle Enable/Disable autoupdate for a provider
 617 } elsif ($cgiparams{'AUTOUPDATE'} eq $Lang::tr{'toggle enable disable'}) {
 618         my %used_providers = ();
 619
 620         # Only go further, if an ID has been passed.
 621         if ($cgiparams{'ID'}) {
 622                 # Assign the given ID.
 623                 my $id = $cgiparams{'ID'};
 624
 625                 # Undef the given ID.
 626                 undef($cgiparams{'ID'});
 627
 628                 # Read-in providers settings file.
 629                 &General::readhasharray($IDS::providers_settings_file, \%used_providers);
 630
 631                 # Grab the configured status of the corresponding entry.
 632                 my $status_autoupdate = $used_providers{$id}[2];
 633
 634                 # Switch the status.
 635                 if ($status_autoupdate eq "disabled") {
 636                         $status_autoupdate = "enabled";
 637                 } else {
 638                         $status_autoupdate = "disabled";
 639                 }
 640
 641                 # Modify the status of the existing entry.
 642                 $used_providers{$id} = ["$used_providers{$id}[0]", "$used_providers{$id}[1]", "$status_autoupdate", "$used_providers{$id}[3]"];
 643
 644                 # Write the changed hash to the providers settings file.
 645                 &General::writehasharray($IDS::providers_settings_file, \%used_providers);
 646         }
 647
 648 # Add/Edit a provider to the list of used providers.
 649 #
 650 } elsif (($cgiparams{'PROVIDERS'} eq "$Lang::tr{'add'}") || ($cgiparams{'PROVIDERS'} eq "$Lang::tr{'update'}")) {
 651         my %used_providers = ();
 652
 653         # Read-in providers settings file.
 654         &General::readhasharray("$IDS::providers_settings_file", \%used_providers);
 655
 656         # Assign some nice human-readable values.
 657         my $provider = $cgiparams{'PROVIDER'};
 658         my $subscription_code = $cgiparams{'SUBSCRIPTION_CODE'};
 659         my $status_autoupdate;
 660
 661         # Handle autoupdate checkbox.
 662         if ($cgiparams{'ENABLE_AUTOUPDATE'} eq "on") {
 663                 $status_autoupdate = "enabled";
 664         } else {
 665                 $status_autoupdate = "disabled";
 666         }
 667
 668         # Check if we are going to add a new provider.
 669         if ($cgiparams{'PROVIDERS'} eq "$Lang::tr{'add'}") {
 670                 # Loop through the hash of used providers.
 671                 foreach my $id ( keys %used_providers) {
 672                         # Check if the choosen provider is already in use.
 673                         if ($used_providers{$id}[0] eq "$provider") {
 674                                 # XXX - add to language file.
 675                                 # Assign error message.
 676                                 $errormessage = "The choosen provider is already in use.";
 677                         }
 678                 }
 679         }
 680
 681         # Check if the provider requires a subscription code.
 682         if ($IDS::Ruleset::Providers{$provider}{'requires_subscription'} eq "True") {
 683                 # Check if an subscription code has been provided.
 684                 if ($subscription_code) {
 685                         # Check if the code contains unallowed chars.
 686                         unless ($subscription_code =~ /^[a-z0-9]+$/) {
 687                                 $errormessage = $Lang::tr{'invalid input for subscription code'};
 688                         }
 689                 } else {
 690                         # Print an error message, that an subsription code is required for this
 691                         # provider.
 692                         $errormessage = $Lang::tr{'ids subscription code required'};
 693                 }
 694         }
 695
 696         # Go further if there was no error.
 697         if ($errormessage eq '') {
 698                 my $id;
 699                 my $status;
 700
 701                 # Check if we should edit an existing entry and got an ID.
 702                 if (($cgiparams{'PROVIDERS'} eq $Lang::tr{'update'}) && ($cgiparams{'ID'})) {
 703                         # Assin the provided id.
 704                         $id = $cgiparams{'ID'};
 705
 706                         # Undef the given ID.
 707                         undef($cgiparams{'ID'});
 708
 709                         # Grab the configured status of the corresponding entry.
 710                         $status = $used_providers{$id}[3];
 711                 } else {
 712                         # Each newly added entry automatically should be enabled.
 713                         $status = "enabled";
 714
 715                         # Generate the ID for the new entry.
 716                         #
 717                         # Sort the keys by their ID and store them in an array.
 718                         my @keys = sort { $a <=> $b } keys %used_providers;
 719
 720                         # Reverse the key array.
 721                         my @reversed = reverse(@keys);
 722
 723                         # Obtain the last used id.
 724                         my $last_id = @reversed[0];
 725
 726                         # Increase the last id by one and use it as id for the new entry.
 727                         $id = ++$last_id;
 728                 }
 729
 730                 # Add/Modify the entry to/in the used providers hash..
 731                 $used_providers{$id} = ["$provider", "$subscription_code", "$status_autoupdate", "$status"];
 732
 733                 # Write the changed hash to the providers settings file.
 734                 &General::writehasharray($IDS::providers_settings_file, \%used_providers);
 735
 736                 # Check if a new provider will be added.
 737                 if ($cgiparams{'PROVIDERS'} eq $Lang::tr{'add'}) {
 738                         # Lock the webpage and print notice about downloading
 739                         # a new ruleset.
 740                         &working_notice("$Lang::tr{'ids working'}");
 741
 742                         # Download the ruleset.
 743                         &IDS::downloadruleset($provider);
 744
 745                         # Extract the ruleset
 746                         &IDS::extractruleset($provider);
 747
 748                         # Move the ruleset.
 749                         &IDS::move_tmp_ruleset();
 750
 751                         # Cleanup temporary directory.
 752                         &IDS::cleanup_tmp_directory();
 753
 754                         # Create new empty file for used rulefiles
 755                         # for this provider.
 756                         &IDS::write_used_provider_rulefiles_file($provider);
 757
 758                         # Perform a reload of the page.
 759                         &reload();
 760                 }
 761
 762                 # Undefine providers flag.
 763                 undef($cgiparams{'PROVIDERS'});
 764         }
 765
 766 ## Toggle Enabled/Disabled for an existing provider.
 767 #
 768 } elsif ($cgiparams{'PROVIDERS'} eq $Lang::tr{'toggle enable disable'}) {
 769         my %used_providers = ();
 770
 771         # Only go further, if an ID has been passed.
 772         if ($cgiparams{'ID'}) {
 773                 # Assign the given ID.
 774                 my $id = $cgiparams{'ID'};
 775
 776                 # Undef the given ID.
 777                 undef($cgiparams{'ID'});
 778
 779                 # Read-in file which contains the provider settings.
 780                 &General::readhasharray($IDS::providers_settings_file, \%used_providers);
 781
 782                 # Grab the configured status of the corresponding entry.
 783                 my $status = $used_providers{$id}[3];
 784
 785                 # Switch the status.
 786                 if ($status eq "enabled") {
 787                         $status = "disabled";
 788                 } else {
 789                         $status = "enabled";
 790                 }
 791
 792                 # Modify the status of the existing entry.
 793                 $used_providers{$id} = ["$used_providers{$id}[0]", "$used_providers{$id}[1]", "$used_providers{$id}[2]", "$status"];
 794
 795                 # Write the changed hash to the providers settings file.
 796                 &General::writehasharray($IDS::providers_settings_file, \%used_providers);
 797
 798                 # Get all enabled providers.
 799                 my @enabled_providers = &IDS::get_enabled_providers();
 800
 801                 # Write the main providers include file.
 802                 &IDS::write_main_used_rulefiles_file(@enabled_providers);
 803
 804                 # Check if the IDS is running.
 805                 if(&IDS::ids_is_running()) {
 806                         # Gather the amount of enabled providers (elements in the array).
 807                         my $amount = @enabled_providers;
 808
 809                         # Check if there are still enabled ruleset providers.
 810                         if ($amount >= 1) {
 811                                 # Call suricatactrl to perform a restart.
 812                                 &IDS::call_suricatactrl("restart");
 813
 814                         # No active ruleset provider, suricata has to be stopped.
 815                         } else {
 816                                 # Stop suricata.
 817                                 &IDS::call_suricatactrl("stop");
 818                         }
 819                 }
 820
 821                 # Undefine providers flag.
 822                 undef($cgiparams{'PROVIDERS'});
 823         }
 824
 825 ## Remove provider from the list of used providers.
 826 #
 827 } elsif ($cgiparams{'PROVIDERS'} eq $Lang::tr{'remove'}) {
 828         my %used_providers = ();
 829
 830         # Read-in provider settings file.
 831         &General::readhasharray($IDS::providers_settings_file, \%used_providers);
 832
 833         # Grab the provider name bevore deleting it from hash.
 834         my $provider = $used_providers{$cgiparams{'ID'}}[0];
 835
 836         # Drop entry from the hash.
 837         delete($used_providers{$cgiparams{'ID'}});
 838
 839         # Undef the given ID.
 840         undef($cgiparams{'ID'});
 841
 842         # Write the changed hash to the provide settings file.
 843         &General::writehasharray($IDS::providers_settings_file, \%used_providers);
 844
 845         # Lock the webpage and print message.
 846         &working_notice("$Lang::tr{'ids apply ruleset changes'}");
 847
 848         # Drop the stored ruleset file.
 849         &IDS::drop_dl_rulesfile($provider);
 850
 851         # Get the name of the provider rulessets include file.
 852         my $provider_used_rulefile = &get_used_provider_rulesfile_file($provider);
 853
 854         # Drop the file, it is not longer needed.
 855         unlink("$provider_used_rulefile");
 856
 857         # Regenerate ruleset.
 858         &IDS::oinkmaster();
 859
 860         # Gather all enabled providers.
 861         my @enabled_providers = &IDS::get_enabled_providers();
 862
 863         # Regenerate main providers include file.
 864         &IDS::write_main_used_rulefiles_file(@enabled_providers);
 865
 866         # Check if the IDS is running.
 867         if(&IDS::ids_is_running()) {
 868                 # Get amount of enabled providers.
 869                 my $amount = @enabled_providers;
 870
 871                 # Check if at least one enabled provider remains.
 872                 if ($amount >= 1) {
 873                         # Call suricatactrl to perform a reload.
 874                         &IDS::call_suricatactrl("restart");
 875
 876                 # Stop suricata if no enabled provider remains.
 877                 } else {
 878                         # Call suricatactrel to perform the stop.
 879                         &IDS::call_suricatactrl("stop");
 880                 }
 881         }
 882
 883         # Undefine providers flag.
 884         undef($cgiparams{'PROVIDERS'});
 885
 886         # Reload page.
 887         &reload();
 888 }
 889
 890 &Header::openpage($Lang::tr{'intrusion detection system'}, 1, '');
 891
 892 &Header::openbigbox('100%', 'left', '', $errormessage);
 893
 894 &show_display_error_message();
 895
 896 if ($cgiparams{'RULESET'} eq "$Lang::tr{'ids customize ruleset'}" ) {
 897         &show_customize_ruleset();
 898 } elsif ($cgiparams{'PROVIDERS'} ne "") {
 899         &show_add_provider();
 900 } else {
 901         &show_mainpage();
 902 }
 903
 904 &Header::closebigbox();
 905 &Header::closepage();
 906
 907 #
 908 ## Tiny function to show if a error message happened.
 909 #
 910 sub show_display_error_message() {
 911         if ($errormessage) {
 912                 &Header::openbox('100%', 'left', $Lang::tr{'error messages'});
 913                         print "<class name='base'>$errormessage\n";
 914                         print "&nbsp;</class>\n";
 915                 &Header::closebox();
 916         }
 917 }
 918
 919 #
 920 ## Function to display the main IDS page.
 921 #
 922 sub show_mainpage() {
 923         # Read-in idssettings and provider settings.
 924         &General::readhash("$IDS::ids_settings_file", \%idssettings);
 925         &General::readhasharray("$IDS::providers_settings_file", \%used_providers);
 926
 927         # If no autoupdate intervall has been configured yet, set default value.
 928         unless(exists($idssettings{'AUTOUPDATE_INTERVAL'})) {
 929                 # Set default to "weekly".
 930                 $idssettings{'AUTOUPDATE_INTERVAL'} = 'weekly';
 931         }
 932
 933         # Read-in ignored hosts.
 934         &General::readhasharray("$IDS::settingsdir/ignored", \%ignored);
 935
 936         $checked{'ENABLE_IDS'}{'off'} = '';
 937         $checked{'ENABLE_IDS'}{'on'} = '';
 938         $checked{'ENABLE_IDS'}{$idssettings{'ENABLE_IDS'}} = "checked='checked'";
 939         $checked{'MONITOR_TRAFFIC_ONLY'}{'off'} = '';
 940         $checked{'MONITOR_TRAFFIC_ONLY'}{'on'} = '';
 941         $checked{'MONITOR_TRAFFIC_ONLY'}{$idssettings{'MONITOR_TRAFFIC_ONLY'}} = "checked='checked'";
 942         $selected{'AUTOUPDATE_INTERVAL'}{'off'} = '';
 943         $selected{'AUTOUPDATE_INTERVAL'}{'daily'} = '';
 944         $selected{'AUTOUPDATE_INTERVAL'}{'weekly'} = '';
 945         $selected{'AUTOUPDATE_INTERVAL'}{$idssettings{'AUTOUPDATE_INTERVAL'}} = "selected='selected'";
 946
 947         # Draw current state of the IDS
 948         &Header::openbox('100%', 'left', $Lang::tr{'intrusion detection system'});
 949
 950         # Check if the IDS is running and obtain the process-id.
 951         my $pid = &IDS::ids_is_running();
 952
 953         # Display some useful information, if suricata daemon is running.
 954         if ($pid) {
 955                 # Gather used memory.
 956                 my $memory = &get_memory_usage($pid);
 957
 958                 print <<END;
 959                         <table width='95%' cellspacing='0' class='tbl'>
 960                                 <tr>
 961                                         <th bgcolor='$color{'color20'}' colspan='3' align='left'><strong>$Lang::tr{'intrusion detection'}</strong></th>
 962                                 </tr>
 963
 964                                 <tr>
 965                                         <td class='base'>$Lang::tr{'guardian daemon'}</td>
 966                                         <td align='center' colspan='2' width='75%' bgcolor='${Header::colourgreen}'><font color='white'><strong>$Lang::tr{'running'}</strong></font></td>
 967                                 </tr>
 968
 969                                 <tr>
 970                                         <td class='base'></td>
 971                                         <td bgcolor='$color{'color20'}' align='center'><strong>PID</strong></td>
 972                                         <td bgcolor='$color{'color20'}' align='center'><strong>$Lang::tr{'memory'}</strong></td>
 973                                 </tr>
 974
 975                                 <tr>
 976                                         <td class='base'></td>
 977                                         <td bgcolor='$color{'color22'}' align='center'>$pid</td>
 978                                         <td bgcolor='$color{'color22'}' align='center'>$memory KB</td>
 979                                 </tr>
 980                         </table>
 981 END
 982         } else {
 983                 # Otherwise display a hint that the service is not launched.
 984                 print <<END;
 985                         <table width='95%' cellspacing='0' class='tbl'>
 986                                 <tr>
 987                                         <th bgcolor='$color{'color20'}' colspan='3' align='left'><strong>$Lang::tr{'intrusion detection'}</strong></th>
 988                                 </tr>
 989
 990                                 <tr>
 991                                         <td class='base'>$Lang::tr{'guardian daemon'}</td>
 992                                         <td align='center' width='75%' bgcolor='${Header::colourred}'><font color='white'><strong>$Lang::tr{'stopped'}</strong></font></td>
 993                                 </tr>
 994                         </table>
 995 END
 996         }
 997
 998         # Only show this area, if at least one ruleset provider is configured.
 999         if (%used_providers) {
1000
1001 print <<END
1002
1003                 <br><br><h2>$Lang::tr{'settings'}</h2>
1004
1005                 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
1006                         <table width='100%' border='0'>
1007                                 <tr>
1008                                         <td class='base' colspan='2'>
1009                                                 <input type='checkbox' name='ENABLE_IDS' $checked{'ENABLE_IDS'}{'on'}>&nbsp;$Lang::tr{'ids enable'}
1010                                         </td>
1011
1012                                         <td class='base' colspan='2'>
1013                                                 <input type='checkbox' name='MONITOR_TRAFFIC_ONLY' $checked{'MONITOR_TRAFFIC_ONLY'}{'on'}>&nbsp;$Lang::tr{'ids monitor traffic only'}
1014                                 </td>
1015                                 </tr>
1016
1017                                 <tr>
1018                                         <td><br><br></td>
1019                                         <td><br><br></td>
1020                                         <td><br><br></td>
1021                                         <td><br><br></td>
1022                                 </tr>
1023
1024                                 <tr>
1025                                         <td colspan='4'><b>$Lang::tr{'ids monitored interfaces'}</b><br></td>
1026                                 </tr>
1027
1028                                 <tr>
1029 END
1030 ;
1031
1032                 # Loop through the array of available networks and print config options.
1033                 foreach my $zone (@network_zones) {
1034                         my $checked_input;
1035                         my $checked_forward;
1036
1037                         # Convert current zone name to upper case.
1038                         my $zone_upper = uc($zone);
1039
1040                         # Set zone name.
1041                         my $zone_name = $zone;
1042
1043                         # Dirty hack to get the correct language string for the red zone.
1044                         if ($zone eq "red") {
1045                                 $zone_name = "red1";
1046                         }
1047
1048                         # Grab checkbox status from settings hash.
1049                         if ($idssettings{"ENABLE_IDS_$zone_upper"} eq "on") {
1050                                 $checked_input = "checked = 'checked'";
1051                         }
1052
1053                         print "<td class='base' width='20%'>\n";
1054                         print "<input type='checkbox' name='ENABLE_IDS_$zone_upper' $checked_input>\n";
1055                         print "&nbsp;$Lang::tr{'enabled on'}<font color='$colourhash{$zone}'> $Lang::tr{$zone_name}</font>\n";
1056                         print "</td>\n";
1057                 }
1058
1059 print <<END
1060                                 </tr>
1061
1062                                 <tr>
1063                                         <td><br><br></td>
1064                                         <td><br><br></td>
1065                                         <td><br><br></td>
1066                                         <td><br><br></td>
1067                                 </tr>
1068
1069                                 <tr>
1070                                         <td colspan='4'><b>$Lang::tr{'ids automatic rules update'}</b></td>
1071                                 </tr>
1072
1073                                 <tr>
1074                                         <td>
1075                                                 <select name='AUTOUPDATE_INTERVAL'>
1076                                                         <option value='off' $selected{'AUTOUPDATE_INTERVAL'}{'off'} >- $Lang::tr{'Disabled'} -</option>
1077                                                         <option value='daily' $selected{'AUTOUPDATE_INTERVAL'}{'daily'} >$Lang::tr{'Daily'}</option>
1078                                                         <option value='weekly' $selected{'AUTOUPDATE_INTERVAL'}{'weekly'} >$Lang::tr{'Weekly'}</option>
1079                                                 </select>
1080                                         </td>
1081                                 </tr>
1082                         </table>
1083
1084                         <br><br>
1085
1086                         <table width='100%'>
1087                                 <tr>
1088                                         <td align='right'><input type='submit' name='IDS' value='$Lang::tr{'save'}' /></td>
1089                                 </tr>
1090                         </table>
1091                 </form>
1092 END
1093 ;
1094
1095         }
1096
1097         &Header::closebox();
1098
1099         #
1100         # Used Ruleset Providers section.
1101         #
1102         &Header::openbox('100%', 'center', $Lang::tr{'ids ruleset settings'});
1103
1104 print <<END;
1105         <table width='100%' border='0'>
1106                 <tr>
1107                         <td class='base' bgcolor='$color{'color20'}'><b>$Lang::tr{'ids provider'}</b></td>
1108                         <td class='base' bgcolor='$color{'color20'}'><b>$Lang::tr{'date'}</b></td>
1109                         <td class='base' bgcolor='$color{'color20'}' align='center'><b>$Lang::tr{'ids autoupdates'}</b></td>
1110                         <td class='base' bgcolor='$color{'color20'}'></td>
1111                         <td class='base' colspan='3' bgcolor='$color{'color20'}'></td>
1112                 </tr>
1113 END
1114                 # Check if some providers has been configured.
1115                 if (keys (%used_providers)) {
1116                         my $col = "";
1117
1118                         # Loop through all entries of the hash.
1119                         foreach my $id (sort keys(%used_providers)) {
1120                                 # Assign data array positions to some nice variable names.
1121                                 my $provider = $used_providers{$id}[0];
1122                                 my $provider_name = &get_provider_name($provider);
1123
1124                                 #XXX my $rulesdate = &IDS::get_ruleset_date($provider);
1125                                 my $rulesdate;
1126
1127                                 my $subscription_code = $used_providers{$id}[1];
1128                                 my $autoupdate_status = $used_providers{$id}[2];
1129                                 my $status  = $used_providers{$id}[3];
1130
1131                                 # Check if the item number is even or not.
1132                                 if ($id % 2) {
1133                                         $col="bgcolor='$color{'color22'}'";
1134                                 } else {
1135                                         $col="bgcolor='$color{'color20'}'";
1136                                 }
1137
1138                                 # Choose icons for the checkboxes.
1139                                 my $status_gif;
1140                                 my $status_gdesc;
1141                                 my $autoupdate_status_gif;
1142                                 my $autoupdate_status_gdesc;
1143
1144                                 # Check if the status is enabled and select the correct image and description.
1145                                 if ($status eq 'enabled' ) {
1146                                         $status_gif = 'on.gif';
1147                                         $status_gdesc = $Lang::tr{'click to disable'};
1148                                 } else {
1149                                         $status_gif = 'off.gif';
1150                                         $status_gdesc = $Lang::tr{'click to enable'};
1151                                 }
1152
1153                                 # Check if the autoupdate status is enabled and select the correct image and description.
1154                                 if ($autoupdate_status eq 'enabled') {
1155                                         $autoupdate_status_gif = 'on.gif';
1156                                         $autoupdate_status_gdesc = $Lang::tr{'click to disable'};
1157                                 } else {
1158                                         $autoupdate_status_gif = 'off.gif';
1159                                         $autoupdate_status_gdesc = $Lang::tr{'click to enable'};
1160                                 }
1161
1162 print <<END;
1163                                 <tr>
1164                                         <td width='33%' class='base' $col>$provider_name</td>
1165                                         <td width='30%' class='base' $col>$rulesdate</td>
1166
1167                                         <td align='center' $col>
1168                                                 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
1169                                                         <input type='hidden' name='AUTOUPDATE' value='$Lang::tr{'toggle enable disable'}' />
1170                                                         <input type='image' name='$Lang::tr{'toggle enable disable'}' src='/images/$autoupdate_status_gif' alt='$autoupdate_status_gdesc' title='$autoupdate_status_gdesc' />
1171                                                         <input type='hidden' name='ID' value='$id' />
1172                                                 </form>
1173                                         </td>
1174
1175                                         <td align='center' $col>
1176                                                 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
1177                                                         <input type='hidden' name='PROVIDERS' value='$Lang::tr{'toggle enable disable'}'>
1178                                                         <input type='image' name='$Lang::tr{'toggle enable disable'}' src='/images/$status_gif' alt='$status_gdesc' title='$status_gdesc'>
1179                                                         <input type='hidden' name='ID' value='$id'>
1180                                                 </form>
1181                                         </td>
1182
1183                                         <td align='center' $col>
1184                                                 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
1185                                                         <input type='hidden' name='PROVIDERS' value='$Lang::tr{'edit'}'>
1186                                                         <input type='image' name='$Lang::tr{'edit'}' src='/images/edit.gif' alt='$Lang::tr{'edit'}' title='$Lang::tr{'edit'}'>
1187                                                         <input type='hidden' name='ID' value='$id'>
1188                                                 </form>
1189                                         </td>
1190
1191                                         <td align='center' $col>
1192                                                 <form method='post' name='$provider' action='$ENV{'SCRIPT_NAME'}'>
1193                                                         <input type='image' name='$Lang::tr{'remove'}' src='/images/delete.gif' title='$Lang::tr{'remove'}' alt='$Lang::tr{'remove'}'>
1194                                                         <input type='hidden' name='ID' value='$id'>
1195                                                         <input type='hidden' name='PROVIDERS' value='$Lang::tr{'remove'}'>
1196                                                 </form>
1197                                         </td>
1198                                 </tr>
1199 END
1200                         }
1201
1202                 } else {
1203                         # Print notice that currently no hosts are ignored.
1204                         print "<tr>\n";
1205                         print "<td class='base' colspan='2'>$Lang::tr{'guardian no entries'}</td>\n";
1206                         print "</tr>\n";
1207                 }
1208
1209         print "</table>\n";
1210
1211         # Section to add new elements or edit existing ones.
1212 print <<END;
1213         <br>
1214         <hr>
1215         <br>
1216
1217         <div align='right'>
1218                 <table width='100%'>
1219                         <form method='post' action='$ENV{'SCRIPT_NAME'}'>
1220                                 <tr>
1221 END
1222
1223                                         # Only show this button if a ruleset provider is configured.
1224                                         if (%used_providers) {
1225                                                 print "<input type='submit' name='RULESET' value='$Lang::tr{'ids customize ruleset'}'>\n";
1226                                         }
1227 print <<END;
1228                                         <input type='submit' name='PROVIDERS' value='$Lang::tr{'ids add provider'}'>
1229                                 </tr>
1230                         </form>
1231                 </table>
1232         </div>
1233 END
1234
1235         &Header::closebox();
1236
1237         #
1238         # Whitelist / Ignorelist
1239         #
1240         &Header::openbox('100%', 'center', $Lang::tr{'ids ignored hosts'});
1241
1242         print <<END;
1243         <table width='100%'>
1244                 <tr>
1245                         <td class='base' bgcolor='$color{'color20'}'><b>$Lang::tr{'ip address'}</b></td>
1246                         <td class='base' bgcolor='$color{'color20'}'><b>$Lang::tr{'remark'}</b></td>
1247                         <td class='base' colspan='3' bgcolor='$color{'color20'}'></td>
1248                 </tr>
1249 END
1250                 # Check if some hosts have been added to be ignored.
1251                 if (keys (%ignored)) {
1252                         my $col = "";
1253
1254                         # Loop through all entries of the hash.
1255                         while( (my $key) = each %ignored)  {
1256                                 # Assign data array positions to some nice variable names.
1257                                 my $address = $ignored{$key}[0];
1258                                 my $remark = $ignored{$key}[1];
1259                                 my $status  = $ignored{$key}[2];
1260
1261                                 # Check if the key (id) number is even or not.
1262                                 if ($cgiparams{'ID'} eq $key) {
1263                                         $col="bgcolor='${Header::colouryellow}'";
1264                                 } elsif ($key % 2) {
1265                                         $col="bgcolor='$color{'color22'}'";
1266                                 } else {
1267                                         $col="bgcolor='$color{'color20'}'";
1268                                 }
1269
1270                                 # Choose icon for the checkbox.
1271                                 my $gif;
1272                                 my $gdesc;
1273
1274                                 # Check if the status is enabled and select the correct image and description.
1275                                 if ($status eq 'enabled' ) {
1276                                         $gif = 'on.gif';
1277                                         $gdesc = $Lang::tr{'click to disable'};
1278                                 } else {
1279                                         $gif = 'off.gif';
1280                                         $gdesc = $Lang::tr{'click to enable'};
1281                                 }
1282
1283 print <<END;
1284                                 <tr>
1285                                         <td width='20%' class='base' $col>$address</td>
1286                                         <td width='65%' class='base' $col>$remark</td>
1287
1288                                         <td align='center' $col>
1289                                                 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
1290                                                         <input type='hidden' name='WHITELIST' value='$Lang::tr{'toggle enable disable'}'>
1291                                                         <input type='image' name='$Lang::tr{'toggle enable disable'}' src='/images/$gif' alt='$gdesc' title='$gdesc'>
1292                                                         <input type='hidden' name='ID' value='$key'>
1293                                                 </form>
1294                                         </td>
1295
1296                                         <td align='center' $col>
1297                                                 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
1298                                                         <input type='hidden' name='WHITELIST' value='$Lang::tr{'edit'}'>
1299                                                         <input type='image' name='$Lang::tr{'edit'}' src='/images/edit.gif' alt='$Lang::tr{'edit'}' title='$Lang::tr{'edit'}'>
1300                                                         <input type='hidden' name='ID' value='$key'>
1301                                                 </form>
1302                                         </td>
1303
1304                                         <td align='center' $col>
1305                                                 <form method='post' name='$key' action='$ENV{'SCRIPT_NAME'}'>
1306                                                         <input type='image' name='$Lang::tr{'remove'}' src='/images/delete.gif' title='$Lang::tr{'remove'}' alt='$Lang::tr{'remove'}'>
1307                                                         <input type='hidden' name='ID' value='$key'>
1308                                                         <input type='hidden' name='WHITELIST' value='$Lang::tr{'remove'}'>
1309                                                 </form>
1310                                                 </td>
1311                                         </tr>
1312 END
1313                                 }
1314                         } else {
1315                                 # Print notice that currently no hosts are ignored.
1316                                 print "<tr>\n";
1317                                 print "<td class='base' colspan='2'>$Lang::tr{'guardian no entries'}</td>\n";
1318                                 print "</tr>\n";
1319                         }
1320
1321                 print "</table>\n";
1322
1323                 # Section to add new elements or edit existing ones.
1324 print <<END;
1325                 <br>
1326                 <hr>
1327                 <br>
1328
1329                 <div align='center'>
1330                         <table width='100%'>
1331 END
1332
1333                 # Assign correct headline and button text.
1334                 my $buttontext;
1335                 my $entry_address;
1336                 my $entry_remark;
1337
1338                 # Check if an ID (key) has been given, in this case an existing entry should be edited.
1339                 if ($cgiparams{'ID'} ne '') {
1340                         $buttontext = $Lang::tr{'update'};
1341                                 print "<tr><td class='boldbase' colspan='3'><b>$Lang::tr{'update'}</b></td></tr>\n";
1342
1343                                 # Grab address and remark for the given key.
1344                                 $entry_address = $ignored{$cgiparams{'ID'}}[0];
1345                                 $entry_remark = $ignored{$cgiparams{'ID'}}[1];
1346                         } else {
1347                                 $buttontext = $Lang::tr{'add'};
1348                                 print "<tr><td class='boldbase' colspan='3'><b>$Lang::tr{'dnsforward add a new entry'}</b></td></tr>\n";
1349                         }
1350
1351 print <<END;
1352                                 <form method='post' action='$ENV{'SCRIPT_NAME'}'>
1353                                 <input type='hidden' name='ID' value='$cgiparams{'ID'}'>
1354                                 <tr>
1355                                         <td width='30%'>$Lang::tr{'ip address'}: </td>
1356                                         <td width='50%'><input type='text' name='IGNORE_ENTRY_ADDRESS' value='$entry_address' size='24' /></td>
1357
1358                                         <td width='30%'>$Lang::tr{'remark'}: </td>
1359                                         <td wicth='50%'><input type='text' name=IGNORE_ENTRY_REMARK value='$entry_remark' size='24' /></td>
1360                                         <td align='center' width='20%'><input type='submit' name='WHITELIST' value='$buttontext' /></td>
1361                                 </tr>
1362                                 </form>
1363                         </table>
1364                 </div>
1365 END
1366
1367         &Header::closebox();
1368 }
1369
1370 #
1371 ## Function to show the customize ruleset section.
1372 #
1373 sub show_customize_ruleset() {
1374         ### Java Script ###
1375         print"<script>\n";
1376
1377         # Java script variable declaration for show and hide.
1378         print"var show = \"$Lang::tr{'ids show'}\"\;\n";
1379         print"var hide = \"$Lang::tr{'ids hide'}\"\;\n";
1380
1381 print <<END
1382         // Tiny java script function to show/hide the rules
1383         // of a given category.
1384         function showhide(tblname) {
1385                 \$("#" + tblname).toggle();
1386
1387                 // Get current content of the span element.
1388                 var content = document.getElementById("span_" + tblname);
1389
1390                 if (content.innerHTML === show) {
1391                         content.innerHTML = hide;
1392                 } else {
1393                         content.innerHTML = show;
1394                 }
1395         }
1396         </script>
1397 END
1398 ;
1399         &Header::openbox('100%', 'LEFT', "$Lang::tr{'intrusion detection system rules'}" );
1400                 print"<form method='POST' action='$ENV{'SCRIPT_NAME'}'>\n";
1401
1402                 # Output display table for rule files
1403                 print "<table width='100%'>\n";
1404
1405                 # Loop over each rule file
1406                 foreach my $rulefile (sort keys(%idsrules)) {
1407                         my $rulechecked = '';
1408
1409                         # Check if rule file is enabled
1410                         if ($idsrules{$rulefile}{'Rulefile'}{'State'} eq 'on') {
1411                                 $rulechecked = 'CHECKED';
1412                         }
1413
1414                         # Convert rulefile name into category name.
1415                         my $categoryname = &_rulefile_to_category($rulefile);
1416
1417                         # Table and rows for the rule files.
1418                         print"<tr>\n";
1419                         print"<td class='base' width='5%'>\n";
1420                         print"<input type='checkbox' name='$rulefile' $rulechecked>\n";
1421                         print"</td>\n";
1422                         print"<td class='base' width='90%'><b>$rulefile</b></td>\n";
1423                         print"<td class='base' width='5%' align='right'>\n";
1424                         print"<a href=\"javascript:showhide('$categoryname')\"><span id='span_$categoryname'>$Lang::tr{'ids show'}</span></a>\n";
1425                         print"</td>\n";
1426                         print"</tr>\n";
1427
1428                         # Rows which will be hidden per default and will contain the single rules.
1429                         print"<tr  style='display:none' id='$categoryname'>\n";
1430                         print"<td colspan='3'>\n";
1431
1432                         # Local vars
1433                         my $lines;
1434                         my $rows;
1435                         my $col;
1436
1437                         # New table for the single rules.
1438                         print "<table width='100%'>\n";
1439
1440                         # Loop over rule file rules
1441                         foreach my $sid (sort {$a <=> $b} keys(%{$idsrules{$rulefile}})) {
1442                                 # Local vars
1443                                 my $ruledefchecked = '';
1444
1445                                 # Skip rulefile itself.
1446                                 next if ($sid eq "Rulefile");
1447
1448                                 # If 2 rules have been displayed, start a new row
1449                                 if (($lines % 2) == 0) {
1450                                         print "</tr><tr>\n";
1451
1452                                         # Increase rows by once.
1453                                         $rows++;
1454                                 }
1455
1456                                 # Colour lines.
1457                                 if ($rows % 2) {
1458                                         $col="bgcolor='$color{'color20'}'";
1459                                 } else {
1460                                         $col="bgcolor='$color{'color22'}'";
1461                                 }
1462
1463                                 # Set rule state
1464                                 if ($idsrules{$rulefile}{$sid}{'State'} eq 'on') {
1465                                         $ruledefchecked = 'CHECKED';
1466                                 }
1467
1468                                 # Create rule checkbox and display rule description
1469                                 print "<td class='base' width='5%' align='right' $col>\n";
1470                                 print "<input type='checkbox' NAME='$sid' $ruledefchecked>\n";
1471                                 print "</td>\n";
1472                                 print "<td class='base' width='45%' $col>$idsrules{$rulefile}{$sid}{'Description'}</td>";
1473
1474                                 # Increment rule count
1475                                 $lines++;
1476                         }
1477
1478                         # If do not have a second rule for row, create empty cell
1479                         if (($lines % 2) != 0) {
1480                                 print "<td class='base'></td>";
1481                         }
1482
1483                         # Close display table
1484                         print "</tr></table></td></tr>";
1485                 }
1486
1487                 # Close display table
1488                 print "</table>";
1489
1490                 print <<END
1491 <table width='100%'>
1492 <tr>
1493         <td width='100%' align='right'>
1494                 <input type='submit' value='$Lang::tr{'fwhost back'}'>
1495                 <input type='submit' name='RULESET' value='$Lang::tr{'ids apply'}'>
1496         </td>
1497 </tr>
1498 </table>
1499 </form>
1500 END
1501 ;
1502                 &Header::closebox();
1503         }
1504 }
1505
1506 #
1507 ## Function to show section for add/edit a provider.
1508 #
1509 sub show_add_provider() {
1510         my %used_providers = ();
1511         my @subscription_providers;
1512
1513         # Read -in providers settings file.
1514         &General::readhasharray("$IDS::providers_settings_file", \%used_providers);
1515
1516         # Get all supported ruleset providers.
1517         my @ruleset_providers = &IDS::get_ruleset_providers();
1518
1519         ### Java Script ###
1520         print "<script>\n";
1521
1522         # Generate Java Script Object which contains the URL of the providers.
1523         print "\t// Object, which contains the webpages of the ruleset providers.\n";
1524         print "\tvar url = {\n";
1525
1526         # Loop through the array of supported providers.
1527         foreach my $provider (@ruleset_providers) {
1528                 # Check if the provider requires a subscription.
1529                 if ($IDS::Ruleset::Providers{$provider}{'requires_subscription'} eq "True") {
1530                         # Add the provider to the array of subscription_providers.
1531                         push(@subscription_providers, $provider);
1532                 }
1533
1534                 # Grab the URL for the provider.
1535                 my $url = $IDS::Ruleset::Providers{$provider}{'website'};
1536
1537                 # Print the URL to the Java Script Object.
1538                 print "\t\t$provider: \"$url\"\,\n";
1539         }
1540
1541         # Close the Java Script Object declaration.
1542         print "\t}\;\n\n";
1543
1544         # Generate Java Script Array which contains the provider that requires a subscription.
1545         my $line = "";
1546         $line = join("', '", @subscription_providers);
1547
1548         print "\t// Array which contains the providers that requires a subscription.\n";
1549         print "\tsubscription_provider = ['$line']\;\n\n";
1550
1551 print <<END
1552         // Java Script function to swap the text input field for
1553         // entering a subscription code.
1554         var update_provider = function() {
1555                 if(inArray(\$('#PROVIDER').val(), subscription_provider)) {
1556                         \$('.subscription_code').show();
1557                 } else {
1558                         \$('.subscription_code').hide();
1559                 }
1560
1561                 // Call function to change the website url.
1562                 change_url(\$('#PROVIDER').val());
1563         };
1564
1565         // Java Script function to check if a given value is part of
1566         // an array.
1567         function inArray(value,array) {
1568                 var count=array.length;
1569
1570                 for(var i=0;i<count;i++) {
1571                         if(array[i]===value){
1572                                 return true;
1573                         }
1574                 }
1575
1576                 return false;
1577         }
1578
1579         // Tiny function to change the website url based on the selected element in the "PROVIDERS"
1580         // dropdown menu.
1581         function change_url(provider) {
1582                 // Get and change the href to the corresponding url.
1583                 document.getElementById("website").href = url[provider];
1584         }
1585
1586         // JQuery function to call corresponding function when
1587         // the ruleset provider is changed or the page is loaded for showing/hiding
1588         // the subscription_code area.
1589         \$(document).ready(function() {
1590                 \$('#PROVIDER').change(update_provider);
1591                         update_provider();
1592         });
1593
1594         </script>
1595 END
1596 ;
1597
1598         &Header::openbox('100%', 'center', $Lang::tr{'ids provider settings'});
1599
1600         # Check if an existing provider should be edited.
1601         if($cgiparams{'PROVIDERS'} eq "$Lang::tr{'edit'}") {
1602                 # Check if autoupdate is enabled for this provider.
1603                 if ($used_providers{$cgiparams{'ID'}}[2] eq "enabled") {
1604                         # Set the checkbox to be checked.
1605                         $checked{'ENABLE_AUTOUPDATE'} = "checked='checked'";
1606                 }
1607         } elsif ($cgiparams{'PROVIDERS'} eq "$Lang::tr{'ids add provider'}") {
1608                 # Set the autoupdate to true as default.
1609                 $checked{'ENABLE_AUTOUPDATE'} = "checked='checked'";
1610         }
1611
1612 print <<END
1613         <form method='post' action='$ENV{'SCRIPT_NAME'}'>
1614                 <table width='100%' border='0'>
1615                         <tr>
1616                                 <td colspan='2'><b>$Lang::tr{'ids provider'}</b></td>
1617                         </tr>
1618
1619                         <tr>
1620                                 <td width='40%'>
1621                                         <input type='hidden' name='ID' value='$cgiparams{'ID'}'>
1622                                         <select name='PROVIDER' id='PROVIDER'>
1623 END
1624 ;
1625                                                 # Loop through the array of ruleset providers.
1626                                                 foreach my $provider (@ruleset_providers) {
1627                                                         # Get the provider name.
1628                                                         my $provider_name = &get_provider_name($provider);
1629
1630                                                         # Pre-select the provider if one is given.
1631                                                         if (($used_providers{$cgiparams{'ID'}}[0] eq "$provider") || ($cgiparams{'PROVIDER'} eq "$provider")) {
1632                                                                 $selected{$provider} = "selected='selected'";
1633                                                         }
1634
1635                                                         # Add the provider to the dropdown menu.
1636                                                         print "<option value='$provider' $selected{$provider}>$provider_name</option>\n";
1637                                                 }
1638 print <<END
1639                                         </select>
1640                                 </td>
1641
1642                                 <td width='60%'>
1643                                         <b><a id="website" target="_blank" href="#">$Lang::tr{'ids visit provider website'}</a></b>
1644                                 </td>
1645                         </tr>
1646
1647                         <tr>
1648                                 <td colspan='2'><br><br></td>
1649                         </tr>
1650
1651                         <tr class='subscription_code' style='display:none' id='subscription_code'>
1652                                 <td colspan='2'>
1653                                         <table border='0'>
1654                                                 <tr>
1655                                                         <td>
1656                                                                 <b>$Lang::tr{'subscription code'}</b>
1657                                                         </td>
1658                                                 </tr>
1659
1660                                                 <tr>
1661                                                         <td>
1662                                                                 <input type='text' size='40' name='SUBSCRIPTION_CODE' value='$used_providers{$cgiparams{'ID'}}[1]'>
1663                                                         </td>
1664                                                 </tr>
1665
1666                                                 <tr>
1667                                                         <td><br><br></td>
1668                                                 </tr>
1669                                         </table>
1670                                 </td>
1671                         </tr>
1672
1673                         <tr>
1674                                 <td colspan='2'>
1675                                         <input type='checkbox' name='ENABLE_AUTOUPDATE' $checked{'ENABLE_AUTOUPDATE'}>&nbsp;$Lang::tr{'ids enable automatic updates'}
1676                                 </td>
1677                         </tr>
1678
1679                         <tr>
1680                                 <td colspan='2' align='right'>
1681                                         <input type='submit' value='$Lang::tr{'back'}'>
1682 END
1683 ;
1684                                 # Check if a provider should be added or edited.
1685                                 if ($cgiparams{'PROVIDERS'} eq "$Lang::tr{'edit'}") {
1686                                         # Display button for updating the existing provider.
1687                                         print "<input type='submit' name='PROVIDERS' value='$Lang::tr{'update'}'>\n";
1688                                 } else {
1689                                         # Display button to add the new provider.
1690                                         print "<input type='submit' name='PROVIDERS' value='$Lang::tr{'add'}'>\n";
1691                                 }
1692 print <<END
1693                                 </td>
1694                         </tr>
1695                 </table>
1696         </form>
1697 END
1698 ;
1699         &Header::closebox();
1700 }
1701
1702 #
1703 ## A function to display a notice, to lock the webpage and
1704 ## tell the user which action currently will be performed.
1705 #
1706 sub working_notice ($) {
1707         my ($message) = @_;
1708
1709         &Header::openpage($Lang::tr{'intrusion detection system'}, 1, '');
1710         &Header::openbigbox('100%', 'left', '', $errormessage);
1711         &Header::openbox( 'Waiting', 1,);
1712                 print <<END;
1713                         <table>
1714                                 <tr>
1715                                         <td><img src='/images/indicator.gif' alt='$Lang::tr{'aktiv'}' /></td>
1716                                         <td>$message</td>
1717                                 </tr>
1718                         </table>
1719 END
1720         &Header::closebox();
1721         &Header::closebigbox();
1722         &Header::closepage();
1723 }
1724
1725 #
1726 ## A tiny function to perform a reload of the webpage after one second.
1727 #
1728 sub reload () {
1729         print "<meta http-equiv='refresh' content='1'>\n";
1730
1731         # Stop the script.
1732         exit;
1733 }
1734
1735 #
1736 ## Private function to read-in and parse rules of a given rulefile.
1737 #
1738 ## The given file will be read, parsed and all valid rules will be stored by ID,
1739 ## message/description and it's state in the idsrules hash.
1740 #
1741 sub readrulesfile ($) {
1742         my $rulefile = shift;
1743
1744         # Open rule file and read in contents
1745         open(RULEFILE, "$IDS::rulespath/$rulefile") or die "Unable to read $rulefile!";
1746
1747         # Store file content in an array.
1748         my @lines = <RULEFILE>;
1749
1750         # Close file.
1751         close(RULEFILE);
1752
1753         # Loop over rule file contents
1754         foreach my $line (@lines) {
1755                 # Remove whitespaces.
1756                 chomp $line;
1757
1758                 # Skip blank  lines.
1759                 next if ($line =~ /^\s*$/);
1760
1761                 # Local vars.
1762                 my $sid;
1763                 my $msg;
1764
1765                 # Gather rule sid and message from the ruleline.
1766                 if ($line =~ m/.*msg:\"(.*?)\"\; .* sid:(.*?); /) {
1767                         $msg = $1;
1768                         $sid = $2;
1769
1770                         # Check if a rule has been found.
1771                         if ($sid && $msg) {
1772                                 # Add rule to the idsrules hash.
1773                                 $idsrules{$rulefile}{$sid}{'Description'} = $msg;
1774
1775                                 # Grab status of the rule. Check if ruleline starts with a "dash".
1776                                 if ($line =~ /^\#/) {
1777                                         # If yes, the rule is disabled.
1778                                         $idsrules{$rulefile}{$sid}{'State'} = "off";
1779                                 } else {
1780                                         # Otherwise the rule is enabled.
1781                                         $idsrules{$rulefile}{$sid}{'State'} = "on";
1782                                 }
1783                         }
1784                 }
1785         }
1786 }
1787
1788 #
1789 ## Function to get the used memory of a given process-id.
1790 #
1791 sub get_memory_usage($) {
1792         my ($pid) = @_;
1793
1794         my $memory = 0;
1795
1796         # Try to open the status file for the given process-id on the pseudo
1797         # file system proc.
1798         if (open(FILE, "/proc/$pid/status")) {
1799                 # Loop through the entire file.
1800                 while (<FILE>) {
1801                         # Splitt current line content and store them into variables.
1802                         my ($key, $value) = split(":", $_, 2);
1803
1804                         # Check if the current key is the one which contains the memory usage.
1805                         # The wanted one is VmRSS which contains the Real-memory (resident set)
1806                         # of the entire process.
1807                         if ($key eq "VmRSS") {
1808                                 # Found the memory usage add it to the memory variable.
1809                                 $memory += $value;
1810
1811                                 # Break the loop.
1812                                 last;
1813                         }
1814                 }
1815
1816                 # Close file handle.
1817                 close(FILE);
1818
1819                 # Return memory usage.
1820                 return $memory;
1821         }
1822
1823         # If the file could not be open, return nothing.
1824         return;
1825 }
1826
1827 #
1828 ## Function to read-in the given enabled or disables sids file.
1829 #
1830 sub read_enabled_disabled_sids_file($) {
1831         my ($file) = @_;
1832
1833         # Temporary hash to store the sids and their state. It will be
1834         # returned at the end of this function.
1835         my %temphash;
1836
1837         # Open the given filename.
1838         open(FILE, "$file") or die "Could not open $file. $!\n";
1839
1840         # Loop through the file.
1841         while(<FILE>) {
1842                 # Remove newlines.
1843                 chomp $_;
1844
1845                 # Skip blank lines.
1846                 next if ($_ =~ /^\s*$/);
1847
1848                 # Skip coments.
1849                 next if ($_ =~ /^\#/);
1850
1851                 # Splitt line into sid and state part.
1852                 my ($state, $sid) = split(" ", $_);
1853
1854                 # Skip line if the sid is not numeric.
1855                 next unless ($sid =~ /\d+/ );
1856
1857                 # Check if the sid was enabled.
1858                 if ($state eq "enablesid") {
1859                         # Add the sid and its state as enabled to the temporary hash.
1860                         $temphash{$sid} = "enabled";
1861                 # Check if the sid was disabled.
1862                 } elsif ($state eq "disablesid") {
1863                         # Add the sid and its state as disabled to the temporary hash.
1864                         $temphash{$sid} = "disabled";
1865                 # Invalid state - skip the current sid and state.
1866                 } else {
1867                         next;
1868                 }
1869         }
1870
1871         # Close filehandle.
1872         close(FILE);
1873
1874         # Return the hash.
1875         return %temphash;
1876 }
1877
1878 #
1879 ## Function to get the provider name from the language file or providers file for a given handle.
1880 #
1881 sub get_provider_name($) {
1882         my ($handle) = @_;
1883         my $provider_name;
1884
1885         # Get the required translation string for the given provider handle.
1886         my $tr_string = $IDS::Ruleset::Providers{$handle}{'tr_string'};
1887
1888         # Check if the translation string is available in the language files.
1889         if ($Lang::tr{$tr_string}) {
1890                 # Use the translated string from the language file.
1891                 $provider_name = $Lang::tr{$tr_string};
1892         } else {
1893                 # Fallback and use the provider summary from the providers file.
1894                 $provider_name = $IDS::Ruleset::Providers{$handle}{'summary'};
1895         }
1896
1897         # Return the obtained provider name.
1898         return $provider_name;
1899 }
1900
1901 #
1902 ## Private function to convert a given rulefile to a category name.
1903 ## ( No file extension anymore and if the name contained a dot, it
1904 ## would be replaced by a underline sign.)
1905 #
1906 sub _rulefile_to_category($) {
1907         my ($filename) = @_;
1908
1909         # Splitt the filename into single chunks and store them in a
1910         # temorary array.
1911         my @parts = split(/\./, $filename);
1912
1913         # Return / Remove last element of the temporary array.
1914         # This removes the file extension.
1915         pop @parts;
1916
1917         # Join together the single elements of the temporary array.
1918         # If these are more than one, use a "underline" for joining.
1919         my $category = join '_', @parts;
1920
1921         # Return the converted filename.
1922         return $category;
1923 }