/usr/share/doc/samhain/manual.html/droproot.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Important installation notes</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="The Samhain Host Integrity Monitoring System"
HREF="index.html"><LINK
REL="UP"
TITLE="Configuring yule, the log server"
HREF="yule.html"><LINK
REL="PREVIOUS"
TITLE="Configuring yule, the log server"
HREF="yule.html"><LINK
REL="NEXT"
TITLE="Registering a client"
HREF="clients.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="./docbook.css"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><!--#if expr="! ($HTTP_USER_AGENT = /MSIE/)"--><!--#include virtual="/resources/ssi/header.html"--><!--#endif --><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The Samhain Host Integrity Monitoring System</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="yule.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 6. Configuring <SPAN
CLASS="APPLICATION"
>yule</SPAN
>, the log server</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="clients.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="DROPROOT"
>6.2. Important installation notes</A
></H1
><P
>As of version 1.7.0, <SPAN
CLASS="APPLICATION"
>yule</SPAN
> will
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>always</I
></SPAN
> drop root privileges after startup and
initialization. You can use a privileged port (port number below
1024), because setting up the listening socket will occur as long as
<SPAN
CLASS="APPLICATION"
>yule</SPAN
> still has root privileges.</P
><P
>There are some special considerations that need to be taken into account
when setting up an installation of <SPAN
CLASS="APPLICATION"
>yule</SPAN
>. In 
particular:</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>The unprivileged user</DT
><DD
><P
>	 By default, <B
CLASS="COMMAND"
>configure</B
> will check (in this order)
	 for the existance of a user <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>yule</I
></SPAN
>,
	 <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>daemon</I
></SPAN
>, or <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>nobody</I
></SPAN
>,
	 and use the first match.
	 </P
><P
>	 You can override this with the option
	 <B
CLASS="COMMAND"
>configure 
	 --enable-identity=<TT
CLASS="REPLACEABLE"
><I
>user</I
></TT
></B
>. The
	 user does not need to exist already; the install script
	 knows how to create a new user (on Linux, FreeBSD, NetBSD, 
	 Solaris, HP-UX, OSF1). 
	 </P
><P
>	 After successful installation, you will be asked to run 
	 <B
CLASS="COMMAND"
>make install-user</B
> in order to:
	 (i) create
	 the user that you specified to <B
CLASS="COMMAND"
>configure</B
>
	 if it does not exist already (<B
CLASS="COMMAND"
>make install-user</B
>
	 will check for this), and 
	 (ii) chown/chmod some directories.
	 </P
><P
>	 After running <B
CLASS="COMMAND"
>make install</B
> and 
	 <B
CLASS="COMMAND"
>make install-user</B
>, you should have a sane setup.
	 </P
></DD
><DT
>Logfile directory</DT
><DD
><P
>	 The system logfile directory usually requires root privileges
	 to write there (otherwise log files may easily get corrupted ...).
	 To enable <SPAN
CLASS="APPLICATION"
>yule</SPAN
> to write the log file
	 and the HTML status file, a (sub-)directory should be used
	 that is owned by <SPAN
CLASS="APPLICATION"
>yule</SPAN
>. The
	 <B
CLASS="COMMAND"
>configure</B
> script and the Makefile will do
	 that automatically with the default layout (i.e. a directory
	 <TT
CLASS="FILENAME"
>/var/log/yule</TT
> will be
	 created).
	 </P
></DD
><DT
>Data files</DT
><DD
><P
>	 The data file directory is now owned by root and
	 world readable by default. If you chown it to a suitable
	 <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>group</I
></SPAN
> for the unprivileged
	 <SPAN
CLASS="APPLICATION"
>yule</SPAN
> user, you can make 
	 it group readable only. <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Note that it is not required,
	 and weakens the security, if the data file directory is writeable
	 for the server.</I
></SPAN
>
	 </P
></DD
><DT
>GnuPG signed configuration file</DT
><DD
><P
>	 The unprivileged yule user must have a 
	 <TT
CLASS="FILENAME"
>.gnupg</TT
> subdirectory in
	 its home directory, holding the public keyring with the
	 key to verify the signature.
	 </P
></DD
><DT
>PID file</DT
><DD
><P
>	 The PID file is written with before dropping root privileges.
	 Therefore <SPAN
CLASS="APPLICATION"
>yule</SPAN
> will not be able to
	 overwrite it later (which is a GoodThing), or 
	 remove it upon exit (it will usually
	 be able to recognize and handle a stale PID file on startup).
	 Still, it may be a good idea to remove it after stopping 
	 <SPAN
CLASS="APPLICATION"
>yule</SPAN
>. The provided start/stop scripts
	 for various architectures will handle this.
	 </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="yule.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="clients.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Configuring <SPAN
CLASS="APPLICATION"
>yule</SPAN
>, the log server</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="yule.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Registering a client</TD
></TR
></TABLE
></DIV
><!--#if expr="! ($HTTP_USER_AGENT = /MSIE/)"--><!--#include virtual="/resources/ssi/footer.html"--><!--#endif --></BODY
></HTML
>
samhain 3.1.0-5ubuntu1 / usr / share / doc / samhain / manual.html / droproot.html
