Readme for LSAT
This is the README file for LSAT (Linux Security Auditing Tool)
NOTE: This is still BETA software. Pretty sure it will not break anything,
and as of this writing it will not change any files on the system.
--------------------------------------------------------------------------------
Hoempage:
The homepage for lsat is http://usat.sourceforge.net
The backup homepage is http://www.dimlight.org/lsat
The homepage for lsat used to be http://www.dimlight.org/~number9/lsat
--------------------------------------------------------------------------------
About:
Linux Security Auditing Tool (LSAT) is a post install security
auditing tool. It is modular in design, so new features can be added
quickly. It checks inetd entries and scans for unneeded RPM packages.
It is being expanded to work with Linux distributions other than Red Hat,
and checks for kernel versions.
--------------------------------------------------------------------------------
Changes:
See changelog/changelog.html for changes.
--------------------------------------------------------------------------------
Current working systems:
LSAT currently compiles and works under RedHat 5.x, 6.x, 7.x, 8.x, 9.x and
Gentoo linux systems. (tested on RedHat 8,9 and Gentoo 1.4)
It should compile and run under RedHat derivative systems, Debian, and the
x86_64 based systems.
The goal is to have it work under many *NIX systems, including but not
limited to Solaris, Debian, RedHat (and derivatives), FreeBSD etc.
--------------------------------------------------------------------------------
REQUIREMENTS:
LSAT was intended to build with a minimal of fuss, but it does require
one thing that is not installed on some systems (I have heard this
from Suse users in particular). popt. If make fails or complains about
popt, please install the popt-devel package as you need the popt header
files.
Other things that would be nice, but LSAT will run without:
To be clear, the following are OPTIONAL, but are useful anyhows,
and LSAT will use them if you have them to give you more information.
nmap Yes LSAT calls nmap to do that one extra scan of your ip address.
lsof This is not installed by default on many systems. Your distribution
most probably has a package of this ready to be installed.
ip This is on newer redhat boxen, replaces ipconfig, gives more output.
sha512sum This is on most new systems by default, even Mac OS X.
--------------------------------------------------------------------------------
Compilation:
LSAT now has autoconf: building should just be (in the lsat- dir:
./configure
make
If you like you can do a:
make install
after the make. This will place lsat in /usr/local/bin and man pages
in /usr/local/man.
If you want to clean the config files, etc, do a:
make clean
If you want it to be as if you just unpacked the tarball do:
make cleanall
--------------------------------------------------------------------------------
Running:
To run the program:
./lsat [OPTIONS]
Options:
-d diff current and old md5, output in lsatmd5.diff
-f Force a specific distribution test.
Distro names are:
redhat
debian
mandrake
solaris
gentoo
macosx
If no -f option, lsat will guess. If lsat can
not guess the distribution, default is redhat.
-a Show this (advanced) help page
-o Output file name -- default is lsat.out
-r Check rpm integrity -- redhat or mandrake only
-s Silent mode
-v Verbose output
-w Output file in html format
-x eXclude module(s) in filelist from checks...
modules listed in filename will be excluded
from checks. Valid module names are the module
names themselves without the check.
(e.g. set not checkset)
NOTE: The valid names for the -x (exclude) option are the following:
pkgs, rpm, inetd, inittab, logging, set, write, dotfiles, passwd, files,
umask, ftpusers, rc, kbd, limits, ssh, open, issue, www, md5, modules,
securetty, perms, net, forward, promisc, listening, cfg, bpass, ipv4, startx,
ftp, disk, services, hostfiles, pkgupdate and passtime.
These should be in a text file in the working directory where lsat
is called from, and can be comma, whitespace/tab or newline delimited.
Any number of options can be specified on the command line.
This may take some time on older systems as it (at some point in time) does
an rpm -qa while checking installed packages. It also checks all SETUID and
SETGID files on the system. (On my Sun sparc20 running Mandrake at 80mhz, it
can take quite a while)
The output is in the file in the directory where lsatmain was run and
should be called lsat.out. If you have previously run lsatmain then the
previous output will be moved to lsat.old. This is so that you may check
your imcremental security improvements to the system.
--------------------------------------------------------------------------------
Modules:
Please see modules.html for info on modules or
writing modules.
Plain text version is README.modules
--------------------------------------------------------------------------------
License:
This software is licensed under the GNU/GPL, please see http://www.gnu.org
for more detals.
--------------------------------------------------------------------------------
Contact:
I am number9. Sometimes known as Triode. My personal page is at
http://www.dimlight.org/number9
You may reach me at
number9 AT dimlight DOT org
--------------------------------------------------------------------------------