root/psad/tags/psad-2.1.2/ChangeLog

Revision 2163, 42.5 KB (checked in by mbr, 2 years ago)

version 2.1.2

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1psad-2.1.2 (04/03/2008):
2    - Bugfix to not include kernel timestamps in iptables log prefixes that
3      contain spaces like "[   65.026008] DROP" (bug reported by Erik Heidt).
4    - Bugfix to skip non-resolved IP addresses (bug reported by Albert Whale)
5    - Better p0f output in --debug mode to display when a passive OS
6      fingerprint cannot be calculated based on iptables log messages that
7      include tcp options (i.e., with --log-tcp-options when building a LOG
8      rule on the iptables command line).
9
10psad-2.1.1 (01/25/2008):
11    - Added a new feature whereby psad can acquire iptables log data just by
12      parsing an existing file (/var/log/messages by default) that is written
13      to by syslog.  By default, psad acquires iptables log data from the
14      /var/log/psad/fwdata file which is written to by kmsgsd, but on some
15      systems, having syslog communicate log data to kmsgsd can be problematic
16      since syslog configs and external factors such as Apparmor and SELinux
17      can play a role here.  This new feature is controled by two new
18      configuration variables "ENABLE_SYSLOG_FILE" (to enable/disable the
19      feature) and "IPT_SYSLOG_FILE" to specifiy the path to the file to
20      parse.
21    - Better installation support for various Linux distributions including
22      Fedora 8 and Ubuntu.  The current runlevel is now acquired via the
23      "runlevel" command instead of attempting to read /etc/inittab (which
24      does not even exist on Ubuntu 7.10), and there are new command line
25      arguments --init-dir, --init-name, and --runlevel to allow the init
26      directory, init script name, and the runlevel to be manually specified
27      on the install.pl command line.
28    - Updated psad to automatically handle situations where the either the
29      /var/log/psad/fwdata file or the /var/log/messages file (whichever
30      syslog is writing iptables log messages to) gets rotated.  The
31      filehandle is closed and reopened if the file shrinks or if the inode
32      changes.  This strategy is borrowed from how the fwknop project deals
33      with the filesystem packet capture file.
34    - Minor bugfix to generate syslog message when restarting a psad process.
35    - Updated install.pl to set the LC_ALL environmental variable to "C"
36      This should address some issues with installing psad on non-English
37      locale systems.
38    - Updated install.pl to be compatible with the rsyslog daemon, which is
39      commonly installed on Fedora 8 systems.
40
41psad-2.1 (10/19/2007):
42    - Changed EMAIL_LIMIT model to apply to scanning source addresses only
43      instead of also factoring in the destination address. The original
44      src/dst email limit behavior can be restored by setting a new variable
45      "ENABLE_EMAIL_LIMIT_PER_DST" to "Y".
46    - Added the patches/iptables-1.3.8_LOG_prefix_space.patch file which can
47      be applied to the iptables-1.3.8 code to enforce a trailing space
48      character before any log prefix when a LOG rule is added. This ensures
49      that the user cannot break the iptables syslog format just by forgetting
50      to include a space at the end of a logging prefix.
51    - Bugfix to ensure that parsing TCP options does not descend into an
52      infinite loop in some some circumstances with obscure or maliciously
53      constructed options.  Also added syslog reporting for broken options
54      lengths of zero or one byte (the minimum option length is two bytes to
55      accomodate the TLV encoding).
56    - Bugfix to enforce the usage of --CSV-fields in --gnuplot mode.
57    - Implemented --get-next-rule-id so that it is easy to assign a new rule
58      ID to a new signature in the /etc/psad/signatures file.
59    - Updated to just call die() if GetOpt fails; this allows erroneous usage
60      of the command line to display informative error messages more clearly.
61
62psad-2.0.8 (07/27/2007):
63    - Added --gnuplot mode so that psad can output data that is suitable for
64      plotting with gnuplot. All output produced in this mode is integer data
65      with the exception of date stamps that are derived from iptables syslog
66      messages.
67    - Added the ability to negate match conditions on fields specified with
68      the --CSV-fields argument by prepending the string "not" (which plays
69      more nicely with shells like bash than a character like "!"). For
70      example, to graph all packet data in --gnuplot or --CSV modes that
71      originates from the 11.11.0.0/16 subnet and is not destined for port
72      80, the following argument does the trick:
73
74            --CSV-fields "src:11.11.0.0/16 dp:not80"
75
76    - In --gnuplot mode, added the ability to generate the count for a CSV
77      field instead of the field itself. Supported modes are an absolute
78      count (<field>:count) , and a unique count (<field>:uniqcount). This
79      is useful to plot graphs of source IP vs. the number unique ports for
80      example.  Also added the ability to count iptables log fields over
81      various time scales (minutes, hours, and days) with the following
82      switches: <field>:countday, <field>:counthour, <field>:countmin.
83    - In --gnuplot mode, added the ability to specify the view coordinates
84      for 3D graph viewing with --gnuplot-view.
85    - Added the Storable-2.16 module along with the --use-store-file argument
86      so that in --gnuplot mode the Gnuplot data can be stored on disk and
87      retrieve quickly.  This eliminates a large performance bottleneck when
88      Gnuplot configuration directives are tweaked while the same graph is
89      generated multiple times.
90    - Added --gnuplot-template so that a template file can be used for all
91      Gnuplot directives (usually psad creates the .gnu file based on the
92      --gnuplot command line arguments).
93    - Added --gnuplot-grayscale to generate graphs without the default red
94      color for graph points.
95    - Bugfix for regular expressions not being imported correctly from within
96      the --CSV-fields argument.
97    - Added --analysis-fields so the iptables log messages that are parsed in
98      -A mode can be restricted to those that meet certain criteria. For
99      example, to restrict the analyze mode to process packets with a source
100      address of 192.168.10.1, use this command:
101
102            psad -A --analysis-fields "src:192.168.10.1"
103
104    - Added --plot-separator to allow the format of plot data (either in
105      --gnuplot or --CSV modes) to be influenced by the user.
106    - Added the ability to configure the syslog facility and priority via the
107      psad.conf file (see the SYSLOG_FACILITY and SYSLOG_PRIORITY variables).
108    - Updated psad.spec file to respect the %_initrddir RPM macro.
109
110psad-2.0.7 (05/28/2007):
111    - Bugfix to define a custom 'source' definition for syslog-ng daemons -
112      this fixes a problem on SuSE systems where the existing syslog-ng
113      reconfig caused the daemon to not start.
114    - Bugfix to allow specific signatures to be ignored by setting SID values
115      of zero in /etc/psad/snort_rule_dl.
116    - Added -X command line argument to allow the user to delete any psad
117      chains (in auto-response mode).  This is a synonym for the iptables -X
118      command line argument.
119
120psad-2.0.6 (03/24/2007):
121    - Better integration with fwsnort; psad signature match syslog messages
122      and email alerts now include the fwsnort rule number (for fwsnort
123      version 0.9.0 and greater) and chain information.
124    - Added the Snort bleeding-all.rules signature file from the Bleeding
125      Snort project (see http://www.bleedingsnort.com).
126    - Bugfix to allow interfaces that have IP aliases.
127    - Added uname, ifconfig, and syslog process information to --Dump-conf
128      output (this can help diagnose various runtime issues).
129    - Changed the --Lib-dir command line argument to --lib-dir, and added
130      --List (similar to iptables) to list the psad auto-blocking chain rules.
131    - Added psad.SlackBuild script contributed by pyllyukko for building psad
132      on Slackware systems.  It uses the Cipherdyne cd_rpmbuilder script to
133      first build and RPM, and then uses it to build a Slackware package.
134
135psad-2.0.5 (03/01/2007):
136    - Consolidated all configuration variables into the /etc/psad/psad.conf
137      file. The kmsgsd.conf, psadwatchd.conf, alert.conf, and fw_search.conf
138      files were all removed since the daemons just reference the psad.conf
139      now.  Updated install.pl to archive and remove these files if they
140      exist from a previous psad installation.
141    - Bugfix to account for iptables -nL output where the protocol may be
142      reported as "0" instead of "all".
143    - Added a function safe_malloc() for kmsgsd.c and psadwatchd.c to ensure
144      that a single API is used to perform a NULL check on heap-allocated
145      memory.
146    - Bugfix to ensure that the psad_ip_len signature matching keyword is
147      checked withing match_snort_ip_keywords() so that it applies to all
148      protocol packets.  This fixes a bug that would cause the "PSAD-CUSTOM
149      Nachi worm reconnaisannce" signature to fire on normal ICMP packet log
150      messages.
151    - Added version and Subversion file revision numbers to die and warn
152      messages that are written to /var/log/psad/errs/.  This helps when
153      trying to track these messages down to a specific file revisions when
154      psad is being upgraded on the local system.
155    - Added version and Subversion file revision numbers to --Dump-conf
156      output.
157    - Minor update to allow --fw-dump to be used on the command line without
158      also having to use the -D argument.
159    - Updated the default_log() function in the IPTables::Parse module to
160      handle iptables policies that were dumped with -v, such as when
161      --Dump-conf is used.
162
163psad-2.0.4 (01/27/2007):
164    - Added Snort rule matches to syslog alerts.  Multiple matches can be
165      controlled with new configuration variables in psad.conf:
166      ENABLE_SIG_MSG_SYSLOG, SIG_MSG_SYSLOG_THRESHOLD, and
167      SIG_SID_SYSLOG_THRESHOLD.
168    - Bugfix to include scanned UDP port ranges in syslog alerts.
169    - Bugfix to parse SEQ and ACK iptables log message fields (requires
170      --log-tcp-sequence on the iptables command line).  This allows the ipEye
171      signature to work.
172    - Added --debug-sid to allow a specific Snort rule to be debugged while
173      psad runs it through its detection engine.  A consequence of this is
174      that the -d command line argument must be spelled out, i.e. "psad
175      --debug".
176    - Bugfix to allow logging prefixes to omit trailing spaces.  This is a bug
177      in the iptables logging format to allow this in the first place, but
178      before this gets fixed psad needs to compensate.
179    - Bugfix for syslog-ng init script path in install.pl.
180    - Bugfix to include a "source" definition for /proc/kmsg if not already
181      defined for syslog-ng daemons.
182    - Minor memory handling bugfixes discovered by valgrind the excellent
183      Valgrind project: http://www.valgrind.org
184
185psad-2.0.3 (12/31/2006):
186    - Removed Psad.pm perl module and kmsgsd.pl and psadwatchd.pl scripts.
187      This is a major change that allows psad to be more flexible and
188      completely derive its config from the psad.conf file and from the
189      command line.  In the previous scheme, psad imported its config with a
190      function within Psad.pm, and this required that psad imported the Psad
191      perl module before reading its config. A consequence was that the
192      PSAD_LIBS_DIR var could not be specified usefully within the config
193      file.
194    - Added the ability to recursively resolve embedded variables from *.conf
195      files (with a limit of 20 resolution attempts).
196    - Added IGNORE_KERNEL_TIMESTAMP so that Linux distros that add a timestamp
197      to all kernel messages (Ubuntu for example) can be ignored.
198    - Consolidated code to import data out of /var/log/psad/<ip> directories
199      with code to display status and analysis output (-S and -A).
200      Essentially the %scan hash is built by the filesystem data import
201      routine and the remainder of the code references this single data
202      structure.
203
204psad-2.0.2 (12/23/2006):
205    - Added the ability to download the latest signatures from cipherdyne.org
206      in install.pl.
207    - Added the cd_rpmbuilder script to make it easy to build RPM's out of
208      CipherDyne projects by automatically downloading the project .tar.gz and
209      .spec files from http://www.cipherdyne.org/.
210    - Added print statements for @INC array in debug mode so that the user can
211      see the additional /usr/lib/psad/* directories added by
212      import_psad_perl_modules().
213    - Changed Unix::Syslog import strategy from "use" to "require" since the
214      path is not known until import_psad_perl_modules() gets a chance to
215      run (psad ran fine without this, but it is more consistent this way).
216    - Bugfix for not properly including elements of the
217      @connected_subnets_cidr array.
218    - IP subnet bugfix to make sure to get the entire subnet in signature
219      import routine if it is not in CIDR format
220    - Bugfix to not print an IP addresses in the "top attackers" section that
221      do not have at least one packet or signature match (for any reason).
222    - Bugfix to not print more than TOP_IP_LOG_THRESHOLD IP addresses in thet
223      top attackers section.
224    - Updated install.pl to reference configuration paths directly from
225      psad.conf instead of defining them separately.  This should fix Debian
226      bug #403566.
227    - Added -c argument to install.pl so that the path to a psad.conf file
228      can be altered from the command line.
229    - Bugfix to not import any IP from the top_attackers file from a previous
230      psad run that does not have a /var/log/psad/<ip> directory.
231    - Added MIN_DANGER_LEVEL to allow all alerts and /var/log/psad/<ip>
232      tracking to be disabled unless an attacker reaches at least this
233      danger level.
234    - Added text in install.pl to mention ifconfig parsing for HOME_NET
235      derivation.
236
237psad-2.0.1 (12/12/2006):
238    - Added Nachi worm reconnaisannce icmp signature
239    - Added the psad_ip_len signature keyword to allow the length field in the
240      IP header to be explicitly tested.
241    - Bugfix for inappropriately removing some directories in @INC when
242      splicing in psad perl module paths.
243    - Switched nf2csv installation path in install.pl to /usr/bin/.
244
245psad-2.0 (12/10/2006):
246    - Completely refactored the Snort rule matching support in psad.  Added
247      many header field tests with full range matching support.  These tests
248      include the following keywords from Snort: ttl, id, seq, ack, window,
249      icmp_id, icmp_seq, itype, icode, ip_proto, ipopts, and sameip.
250    - Refactored all signatures in /etc/psad/signatures to conform to new
251      signature matching support in this release.  There are now about 190
252      signatures that psad can run directly against Netfilter logging
253      messages (i.e. without the help of fwsnort).
254    - Added the ability to download the latest signatures file from
255      http://www.cipherdyne.org/psad/signatures with the --sig-update command
256      line argument to psad.
257    - Added "MISC Windows popup spam" signature.  This allows psad to detect
258      when attempts are made to send spam via the Windows Messenger service.
259    - Completely reworked --Status and --Analyze output, signature matches
260      are included now, along with a listing of top sig matches, top scanned
261      ports, and top attackers.  Also, scan data is not written to
262      /var/log/psad/ipt_analysis/ before display analysis output in -A mode;
263      analysis results are displayed much faster this way.
264    - Added ipEye, Subversion, Kuang2, Microsoft SQL, Radmin, and Ghostsurf
265      signatures.
266    - Added 'data in TCP SYN packet' signature.
267    - Added --CSV mode so that psad can be used to generate comma-separated
268      value output suitable for the AfterGlow project (see
269      http://afterglow.sourceforge.net/index.html) for graphical
270      representations of Netfilter logs and associated scan data.  Also added
271      nf2csv so that normal users can take advantage of this feature.
272    - Added emulation of the Snort "dsize" test through the use of the IP
273      length field for TCP/ICMP signatures, and the UDP length field for UDP
274      signatures.  For SYN packets, TCP options are included so psad
275      automatically adds 44 bytes (the maximum length for TCP options) so the
276      dsize test corresponds to the estimated payload length.
277    - Added the psad_id, psad_dsize, and psad_derived_sids fields for the new
278      Snort rule support.
279    - Added the ability to decode IP options, which are included within Snort
280      rules as the "ipopts" keyword.  This functionality requires that the
281      --log-ip-options command line argument is given to iptables when
282      building a rule that uses the LOG target.
283    - Added Snort rules (sids 475, 500, 501, and 502) that detect IP options
284      usage such as source routing and the traceroute IP option with the new
285      IP options decoder.
286    - Enhanced psad email alert output to include sid values that have been
287      derived from existing Snort rules.
288    - Added the ability to expand embedded variables within the psad
289      configuration files.  For example, the path to the FW_DATA_FILE is
290      defined in psad.conf as "$PSAD_DIR/fwdata", which resolves to
291      /var/log/psad/fwdata when the PSAD_DIR variable is expanded.  This
292      feature allows a consistent set of file paths to easily be defined
293      instead of using the full path for each file path.
294    - Better validation of IPT_AUTO_CHAIN{n} variables so that the from_chain
295      cannot be identical to the to_chain.
296    - Added dump_config() to psadwatchd.c and kmsgsd.c when compiled with
297      debugging support.
298    - Added ENABLE_INTF_LOCAL_NETS to have psad automatically treat all IP
299      addresses that are part of the local system as belonging to the HOME_NET
300      for signature matching.
301    - Added ENABLE_SNORT_SIG_STRICT to have psad exit if there are any
302      problems found with Snort rules in the /etc/psad/signatures file.  If
303      this feature is disabled (this is the default), then psad generates
304      syslog warnings for improperly formatted signatures).
305    - Update to print the number of IP addresses at each danger level in -A
306      analysis mode.  This is useful to get a sense for how long the disk IO
307      might take to write out all of the /var/log/psad/ipt_analysis/<IP>
308      directories.
309    - Added code to restart kmsgsd at psad start up if a previous kmsgsd
310      process is still running and TRUNCATE_FWDATA is set to 'Y' (this is the
311      default).  This probably isn't strictly necessary because kmsgsd is
312      capable of writing to the fwdata file even if another process truncates
313      it.
314    - Added code to recreate the AUTO_IPT_SOCK (/var/run/psad/auto_ipt.sock)
315      file if some other process happens to delete it out of /var/run/psad/
316    - Bugfix to allow backwards compatibility with old NOT_USED value
317      for the HOME_NET variable.
318    - Bugfix to cleanup any lost blocking rules from the running psad
319      timeouts (a separate process might have deleted rules from the psad
320      chains).
321    - Bugfix to allow Netfilter log messages to include the PHYSDEV (i.e.
322      PHYSIN and PHYSOUT) interfaces.
323    - Updated to read architecture-dependent perl module installation
324      directory out of /usr/lib/psad (e.g. "/usr/lib/psad/x86_64-linux")
325      before importing psad perl modules such as IPTables::Parse, etc. These
326      modules are now imported via "require" after the appropriate
327      directories have been added to @INC. This allows the RPM files to be
328      built on one system that builds @INC differently than the system where
329      psad is actually installed since psad can now compensate for this.
330    - Added new code to populate the <dst>_signature file in each of the
331      /var/log/psad/<ip> directories with verbose information including the
332      signature time, sid, protocol, dst port, and packet count.
333    - Changed --interval to --Interval, and added --interface to allow
334      psad's detection to be limited to a specific IN interface for the INPUT
335      and FORWARD chains (or OUT interface for the OUTPUT chain).
336    - Replaced --status-brief with --status-summary, but changed it so that
337      only the detailed IP status information is omitted.
338    - Removed unnecessary --status-sort-dl option.
339    - Added STATUS_OUTPUT_FILE so the --Status and --Analyze output is
340      captured instead of just being lost if the output was not piped to
341      'less' or another similar program.
342    - Added --restrict-ip so that psad will restrict its attack detection
343      operations to a specific IP or network.
344    - Updated psadwatchd.c to parse EMAIL_ADDRESSES out of
345      /etc/psad/psad.conf to avoid duplication of variables.
346    - Bugfix to clear old @ipt_config array after receiving a HUP signal.
347      This bug broke the auto-blocking mode.
348    - Bugfix for syslog-ng config so that any custom source for /proc/kmsg is
349      used for the psadfifo path.
350
351psad-1.4.8 (10/15/2006):
352    - Added the ability to get the auto-blocking status for a specific IP
353      address in --status-ip mode.
354    - Bugfix to use the IPT_OUTPUT_FILE and IPT_ERROR_FILE configuration
355      variables.
356    - Bugfix to restore "start" functionality in Gentoo init script.
357    - Added the ability to selectively disable psad auto-blocking emails.
358    - Added more rigorous IP matching regex from Sebastien J. (contributed
359      originally for fwknop).
360
361psad-1.4.7 (09/10/2006):
362    - Completely re-worked IPTables::ChainMgr to support the return of
363      iptables error messages that are collected via stderr.  This is critical
364      to fixing a bug where psad would sometimes die on an iptables command
365      but no information would be returned to the user.
366    - Added the ability to specify the position for both the jump rule into
367      the psad chains as well as the position for new rules within the psad
368      chains via the -I argument to iptables.  This fixes a bug where the user
369      was given the impression that the IPTABLES_AUTO_RULENUM would accomplish
370      this.
371    - Populated the _debug option in the IPTables::ChainMgr module, and also
372      added a _verbose option so that the specific iptables commands can
373      actually be seen as IPTables::ChainMgr functions are called.
374    - Added code to install.pl to ask the user if a manual restart of syslog
375      is ok upon an unsuccessful test of the syslog reconfiguration.  This
376      fixes a bug where some syslog daemons might not re-import their
377      configurations after receiving a HUP signal.
378    - Bugfix for incorrect config variable name that gated Netfilter
379      prerequisite checks.
380    - Added code to install.pl to update command paths in psad.conf and
381      psadwatchd.conf if any of the paths are broken (i.e. the local system
382      does not conform to the default paths).  By default this only happens if
383      the user does not want old configs to be merged, but to override this
384      use the new --path-update command line argument to install.pl.
385    - Added the --Skip-mod-install command line argument to install.pl to
386      allow all perl module installs to be skipped.
387    - Added the --force-mod-regex command line argument to install.pl to allow
388      a regex match on perl module names to force matching modules to be
389      installed.
390    - Added the logrotate.psad file (contributed by Albert Whale).
391
392psad-1.4.6 (06/13/2006):
393    - Added ENABLE_AUTO_IDS_REGEX and AUTO_BLOCK_REGEX to allow filtering on
394      logging prefixes.
395    - Added code to save DShield email to a file.
396    - Added IPTABLES_PREREQ_CHECK to allow the administrator to control the
397      frequency of Netfilter checks (for auto-block compatibility).
398    - Added IGNORE_LOG_PREFIXES to allow certain log prefixes to be completely
399      ignored by psad.
400    - Added classification.config file from Snort-2.3.3 so that psad can
401      assign danger levels based upon Snort rule class type.  This is useful
402      when also running fwsnort.
403    - Added snort_rule_dl to allow specific psad to assign specific danger
404      level values to particular signatures.  This is useful if you want to
405      do define certain Snort rules as being particularly evil (or not).
406      Running fwsnort is also necessary to take advantage of this feature.
407    - Added reference.config so that psad can include reference information in
408      email alerts that are derived from attacks detected by fwsnort.
409    - Updated to Snort-2.3.3 signatures.
410    - Updated to whois-4.7.13.
411
412psad-1.4.5 (01/13/2006):
413    - Bugfix in IPTables::Parse to allow the limit target to apply to
414      logging rules.
415    - Made calls to chain creation and jump rule functions for only every
416      100 block calls in auto-IDS mode.
417    - Bugfix to make sure /var/run/psad directory exists at startup since
418      this directory is removed by some Linux distributions at boot time.
419    - Bugfix for zero masks in auto_dl; this allows a network of "0.0.0.0/0"
420      to be specified.
421    - Added ENABLE_FW_LOGGING_CHECK so that the Netfilter policy check can be
422      enabled/disabled easily via psad.conf.
423    - Enhanced -D output to include "uname -a" and "perl -V" output.
424    - Added ENABLE_RENEW_BLOCK_EMAILS to allow whether renew emails are sent
425      for auto-blocked addresses.
426
427psad-1.4.4 (11/27/2005):
428    - Added MAC address reporting in psad email alerts.  This feature is
429      enabled via a new config keyword "ENABLE_MAC_ADDR_REPORTING".
430    - Added --fw-rm-block-ip <ip> option to allow IP addresses to be removed
431      from the auto-blocking chains from the command line.
432    - Updated command line firewall arguments to write commands to the
433      AUTO_IPT_SOCK domain socket.
434    - Added the ability to specify ports and port ranges to auto_dl file.
435    - Added --force-mod-install command line argument to installer to force
436      perl modules used by psad to be installed within /usr/lib/psad
437      regardless of whether they already exist in the system perl tree.
438    - Bugfix in the installer to seek() to the end of the fwdata file
439    - Bugfix for psad repeatedly trying to remove the same IP address(es)
440      from the auto-blocking chains.
441      instead of reading the entire thing into memory.
442    - Added the ability to truncate the fwdata file via a new configuration
443      keyword "TRUNCATE_FWDATA" (this is enabled by default).
444    - Bugfix in auto-blocking mode for deleting AUTO_IPT_SOCK when a HUP
445      signal is received.
446    - Bugfix for parsing Netfilter policies that contain ULOG logging rules
447      instead of the standard LOG target.
448    - Removed the smtpdaemon requirement in the RPM because psad might be
449      configured to not send email alerts.
450
451psad-1.4.3 (09/27/2005):
452    - Bugfixes for auto-blocking code.  Timeouts should be handled
453      properly, including cached IP addresses in the auto_blocked_iptables
454      file that are referenced upon psad startup.  Communication with the
455      running psad is performed over a Unix domain socket in --fw-block
456      mode.
457    - Bugfix to seek to the end of the fwdata file instead of reading the
458      entire thing into memory and then looking for newly written logging
459      messages.  This drastically reduces the amount of memory required
460      by psad.
461    - Updated to only display psad chains if --verbose is set
462    - Updated to automatically flush the psad auto-response Netfilter chains
463      at start time (subject to a new config keyword "FLUSH_IPT_AT_INIT").
464
465psad-1.4.2 (07/15/2005):
466    - Dependency bugfixes for mail binary.
467    - Bugfix for various IGNORE_* keywords not being honored.
468    - Bugfix for not timing out blocked IP addresses from a previous run.
469    - Updated to version 0.2 of the IPTables::ChainMgr module.
470    - Updated to not truncate the fwdata file upon psad startup.
471    - Added --fw-dump which produces a sanitized (i.e. no IP addresses)
472      version of the local Netfilter policy.  Also added --fw-include-ips
473      to (optionally) not sanitize IPs/nets.  Note that the 0.0.0.0 and
474      0.0.0.0/0 IPs/nets are not sanitized since they give no useful
475      information about specific IPs/nets.
476    - Added ulogd data collection mode.
477    - Bugfix for FW_MSG_SEARCH default (at least "DROP" is included now
478      even if FW_SEARCH_ALL is set to "N").
479    - Bugfix for non-network address for subnet specified with --fw-block.
480    - Bugfix for multiple --fw-block IPs/nets.
481    - Added README.SYSLOG (Francois Marier contributed the content).
482    - Made email alert prefixes (such as "[psad-alert]") customizable via
483      psad.conf.
484
485psad-1.4.1 (03/12/2005):
486    - Updated to Snort-2.3 rules in the snort_rules directory.
487    - Re-worked syslog installation portion of install.pl.  The user will
488      always be prompted to enter the syslog daemon now, and also added
489      the --syslog-conf arg to allow the config file path to be specified
490      on the install.pl command line.
491    - Bugfix in install.pl for using IP address instead of network address
492      of directly connected subnets.
493    - Updated to version 4.6.23 of the whois client.
494    - Bugfix for distinguishing OPT field associated with --log-tcp-options
495      vs. --log-ip-options.
496    - Bugfix for syslog format that may not include the "kernel:" tag.
497    - Applied patch to only install perl modules that are not already
498      installed (Blair Zajac).
499    - Bugfix for the psad version number that is sent in DShield alerts.
500    - Updated Psad module directory structure to be consistent with current
501      versions of perl (5.8.x).
502    - Added IPTables::ChainMgr module.
503    - Completely re-worked the Netfilter auto-blocking code to use
504      IPTables::ChainMgr functions so that auto-generated rules are placed
505      in chains created by psad.
506    - Added IPT_AUTO_CHAIN keyword in psad.conf which is used to define the
507      set of chains to which auto-generated Netfilter rules are added.
508    - Added --fw-list-auto to display the contents of psad Netfilter
509      chains.
510    - Added the ability to import an IP into the Netfilter auto-blocking
511      chains from the command line with --fw-block-ip.  This allows psad to
512      apply its timeout mechanism against such IPs/nets.
513    - Added the ability to ignore packets based on input interface with
514      IGNORE_INTERFACES in psad.conf.
515    - Re-worked auto_dl code, better hash design and searching function.
516    - Removed dependency on sendmail command unless DShield alerting is
517      enabled and a DShield user id is specified.
518    - Added ALERTING_METHODS keyword in the file alert.conf to allow either
519      syslog or email alerts (or both) to be disabled.  Psad and psadwatchd
520      reference this file.
521
522psad-1.4.0 (11/26/2004):
523    - Added p0f-style passive OS fingerprinting through the use of the OPT
524      field in iptables log messages (which is only logged through the use
525      of the --log-tcp-options command line arg to iptables).
526    - Bugfix for iptables log messages that include tcp sequence numbers
527      (see the iptables --log-tcp-sequence command line argument).
528    - Bugfix for O_RDONLY open flag when kmsgsd receives a HUP signal.
529
530psad-1.3.4 (10/17/2004):
531    - Bugfix for init script directory on Slackware systems.
532    - Bugfix for null prefix counters.
533    - Added --whois-analysis argument since whois lookups are now disabled
534      by default when running in analysis (-A) mode.
535    - Updated psad_init() to rework setup() and import orderings vs.
536      --fw-analyze and --Benchmark modes.
537    - Added bidirectional iptables auto-blocking support for all chains
538      except for the INPUT and OUTPUT chains.
539    - Better syslog message support when run in auto-blocking mode.
540    - Added iptables auto-block rules section to --Status output.
541    - Added init script for Fedora systems.
542    - Added default_log() function to IPTables::Parse.  This function
543      parses user defined chains in an effort to find default logging
544      rules.
545    - Added EMAIL_LIMIT_STATUS_MSG to control whether or not psad sends a
546      status email when the PSAD_EMAIL_LIMIT threshold has been reached by
547      an IP address.
548    - Added ENABLE_SCAN_ARCHIVE to control whether or not psad archives old
549      scan data within /var/log/psad/scan_archive at start time.
550
551psad-1.3.3 (09/09/2004):
552    - Fixed __WARN__ and __DIE__ exception handlers so that they
553      reference global message variables.
554    - Fixed auto danger level assignments.  Network auto assignments as
555      well as per-protocol assignments work now.
556    - Added SYSLOG_DAEMON variable to define which syslog daemon is running
557      on the underlying system instead of just guessing.
558    - Added the ability to ignore both ranges and specific ports/protocols
559      with a new variable IGNORE_PORTS in psad.conf.
560    - Bugfix to make sure email addresses are separated by spaces when
561      Psad::sendmail() is called.
562    - Bugfix for ipt_prefix counters not being parsed correct at import
563      time.
564    - Removed exclude_auto_ignore_ip() since this function was made
565      unnecessary by newly rewritten auto-assign code.
566    - Bugfix for Text::Wrap calls in install.pl uninstall() routine.
567    - Bugfix for using --no-fw-search-all even when FW_SEARCH_ALL is
568      set to "Y".
569    - Removed extraneous ".." and "**" chars from syslog messages, and
570      updated to use [+] prefix strings.
571    - Moved init scripts into init-scripts directory within source tree.
572    - Removed dependency on Bit::Vector (psad does not seem to make use
573      of any Date::Calc functions that require it).
574    - Wrapped copy() and move() calls with "or die()" to make them
575      safer in install.pl.
576    - Added check for existing psad process in install.pl.
577    - Updated to a new psad email alert subject format.  Prefixes of
578      "[psad-alert]", "[psad-error]", and "[psad-status]" are used now.
579    - Permissions fixes with umask() setting in /var/log/psad, permissions
580      fixes for files in /etc/psad at install time.
581
582psad-1.3.2 (06/25/2004):
583    - Removed FW_MSG_SEARCH from psad.conf, and created a new config
584      file "fw_search.conf" that both psad and kmsgsd use to get the
585      FW_MSG_SEARCH definition(s).
586    - Added default mode of parsing all iptables messages instead of
587      just those that contain specific search strings.  A new config
588      variable "FW_SEARCH_ALL" was added to fw_search.conf that
589      controls this mode.
590    - Updated psad and kmsgsd so that multiple firewall search strings
591      can be specified through multiple FW_MSG_SEARCH variables in
592      fw_search.conf.
593    - Added iptables chain and logging-prefix tracking for current
594      scan interval in email alerts.
595    - Added protocol-specific auto-danger level assignments.
596    - Added total scan source and destination IP address counters in
597      --Status output.
598    - Added number of email alerts sent and OS guess in default
599      --Status output.  The output is getting wide now, so there is
600      also a new option --status-brief that will remove the alerts
601      sent and OS guess columns.
602    - Added getopt() command line arg parsing to kmsgsd with two new
603      options "-c" (for config file path) and "-k" (for fw_search.conf
604      path).
605    - Made iptables parsing code into its own script "fwcheck_psad"
606      that gets called by psad.
607    - Added Dshield stats summary to --Status output.
608    - Bugfix for auto-ignore IP addresses and networks being missed.
609    - Made parsing of ifconfig output language independent (should
610      handle French now for example).
611    - Removed "psad_" prefix on files psad_signatures, psad_auto_ips,
612      psad_posf, and psad_icmp_types in /etc/psad/.
613    - Updated to version 4.6.14 of the whois client.
614
615psad-1.3.1 (12/25/2003):
616    - Added the ability to import /var/log/psad/<ip> directories
617      back into memory so scan data remains persistent across
618      psad restarts or system reboots.
619    - Added --Analyze-msgs to run psad in analysis mode against an
620      iptables logfile (/var/log/psad/fwdata by default).  The logfile
621      path can be changed with --messages-file.
622    - Added icmp type and code validation against RFC 792.
623    - Bugfix for being too strict with FW_MSG_SEARCH.
624    - Added port ranges for tcp and udp scans in <ip>/<dst>_packet_ctr.
625    - Added <ip>/<dst>_start_time and <ip>/os_guess.
626    - Bugfix for missing --no-signatures code.
627    - Updated to Snort-2.1 signatures.
628
629psad-1.3 (11/30/2003):
630    - Replaced all signatures in psad_signatures with updated snort
631      rules.
632    - Added support for source and destination ip addresses in
633      signature matching code.  A new variable "HOME_NET" makes this
634      possible.
635    - Added support for the iptables output chain.
636    - Added chain tracking for all signatures.
637    - Replaced match_fastsigs() with two new routines for tcp and
638      udp signature matching that don't autovivify hash keys.
639    - Removed support for ipchains.
640    - Added support for metalog.
641    - Removed all "Undefined Code" signatures from psad_signatures.
642    - Re-worked %auto_blocked_ips hash and corresponding blocking
643      routines.  This (hopefully) fixes a restart bug seen on older
644      systems such as those that are still running versions of perl
645      less than 5.6.
646    - Re-worked firewall policy parsing routines.  Chains that have
647      a default policy of DROP are handled properly now.
648    - Bugfix for missing NULL char in kmsgsd.c.
649    - Updated scan alerting format.  Put current interval protocol
650      status before source and destination addresses.
651    - Buffer overflow fix in kmsgsd.c for size of buf[MAX_LINE_BUF]
652      buffer in read() call.
653    - Added --no-kmsgsd option to aid in psad --debug mode.
654
655psad-1.2.4 (10/15/2003):
656    - Added danger level to subject line in email alerts.
657    - Removed diskmond altogether since psad now handles disk space
658      thresholds directly.  This allows filehandles to be handled
659      properly.
660    - Added auto_block_ignore_ip() to prevent 0.0.0.0, 127.0.0.1,
661      and local interface ips from being included in auto blocking
662      routines.
663    - Added Bit::Vector module to stop installation warnings from
664      Date::Calc.
665    - Made get_local_ips() called periodically since local addresses
666      may change (dhcp, etc.).
667    - Added installation code and init script for Gentoo Linux.
668    - Bugfix for INIT_DIR in uninstall() routine in install.pl.
669    - Bugfix for auto-blocking loop after timeouts are hit.
670    - Added --status-dl [N] to display status information only for
671      those scans that reach at least [N].
672
673psad-1.2.3 (09/12/2003):
674    - Added interface tracking for scans.
675    - Bugfix for not opening /etc/hosts.deny the right way in
676      tcpwr_block().
677    - Bugfix for psadfifo path in syslog-ng config.
678    - Better format for summary stats section in email alerts.
679    - Bugfix for INIT_DIR path on non-RedHat systems.
680    - Bugfix for gzip path.
681    - Make Psad.pm installed last of all perl modules installed
682      by psad.
683    - Added additional call to incr_syscall_ctr() in psadwatchd.c
684
685psad-1.2.2 (08/24/2003):
686    - psad is finally available as an RPM package.
687    - Added chain tracking for iptables.
688    - Added chain counts to --Status output.
689    - Bugfix for psad not taking into account multiple scan
690      destinations.
691    - Reworked auto-blocking code for both tcpwrappers and
692      iptables.  Lines added to /etc/hosts.deny will no longer be
693      duplicated.  Added IPTABLES_AUTO_RULENUM and
694      IPCHAINS_AUTO_RULENUM so auto rules can be inserted at a
695      configurable point within iptables and ipchains policies.
696    - Psad now installs all perl modules within /usr/lib/psad.
697    - Removed /var/log/psad/<ip>/scanlog file since it was wasting
698      too much disk.
699    - Made psad, psadwatchd, and diskmond take the machine hostname
700      from their respective config files.  This makes installation
701      via the rpm easier, and is generally cleaner.
702    - Added scan destination in --Status output.
703    - Added --status-sort-dl (the default status output is now
704      sorted by ip address by default).
705
706psad-1.2.1 (07/11/2003):
707    - Bugfix for multiple processes being spawned by psadwatchd
708      due to lack of proper config variables in the new split
709      daemon config files.
710    - Bugfix for old scan messages being regenerated if a HUP
711      signal is received.
712    - Bugfix for incorrectly calculating disk utilization in
713      diskmond.c.
714    - Extended install.pl to include compression for archived
715      files in /etc/psad.
716    - Added preserve questions in install.pl for the psad
717      signature and auto ips files.
718    - Bugfix for --USR1 command line switch not mapping to the
719      correct subroutine.
720    - Bugfix for psad man page missing the pipe character in
721      psadfifo line for syslog.conf.
722
723psad-1.2 (06/18/2003):
724    - Added passive OS fingerprinting based on packet ttl, length,
725      tos, and id fields.
726    - Added dshield.org alerting capability.
727    - Added exec_external_script() for external script execution.
728    - Added auto blocked timeouts.
729    - Implemented config re-imports via HUP signals in a manner
730      similar to various other system daemons (sysylog, apache
731      etc.)
732    - Better --Status output that shows packet counts per protocol
733      for each ip.
734    - Added --ip-status for more verbose status output for a
735      particular ip address.
736    - Added config preservation code to install.pl.
737    - Added Psad::psyslog().
738    - Split psad.conf into a separate config file for each of the
739      four psad daemons.
740    - Completely re-worked the auto blocking code (made dedicated
741      files for iptables and ipchains block methods).
742    - Added danger level hash.
743    - Minor code cleanups (shorter hash keys, etc.).
744
745psad-1.1.1 (04/26/2003):
746    - Bugfix for incorrect usage of %scan hash keys associated
747      with tcp/udp when the current protocol is icmp.
748    - Bugfix for being too strict on iptable default log string.
749    - Reworked USR1 signal handler so the Data::Dumper function
750      call is made in the main part of the psad code.
751    - Added a startup message for psad.
752    - Minor bugfix for leading whitespace in auto_ips.
753
754psad-1.1 (04/20/2003):
755    - Added the IPTables::Parse module for better processing of
756      the iptables ruleset.
757    - Added --snort-sids so that iptables messages generated by
758      fwsnort can be included in alerts.  Such alerts now include
759      the content fields of packets (fwsnort uses the iptables
760      string match module).
761    - Added the ability to specify entire networks in the auto
762      ips file through the use of the Net::IPv4Addr module.
763    - Better logging format that reinstates the current interval,
764      and adds an "overall stats" section that includes packet
765      counters per protocol.
766    - Removed the PROTO hash key since it was unnecesssary.
767    - Better benchmarking code.
768    - Bug fix for incorrectly looking for the "MAC" string in
769      iptables messages that could have been generated by the
770      FORWARD chain.
771
772psad-1.0 (02/27/2003):
773    - Added --Benchmark and --packets command line options to support
774      psad benchmarking.
775    - Bugfix for improperly detecting NULL scans.
776    - Completely redesigned website.
777
778psad-1.0.0-pre4 (11/26/2002):
779    - Rewrote kmsgsd and psadwatchd in C.
Note: See TracBrowser for help on using the browser.