*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->FreeBSD man pages -> tcpd (8)              



NAME    [Toc]    [Back]

       tcpd - access control facility for internet services

DESCRIPTION    [Toc]    [Back]

       The tcpd program can be set up to monitor incoming requests for telnet,
       finger, ftp, exec, rsh, rlogin, tftp, talk, comsat and  other  services
       that have a one-to-one mapping onto executable files.

       The  program  supports  both  4.3BSD-style sockets and System V.4-style
       TLI.  Functionality may be limited when the protocol underneath TLI  is
       not an internet protocol.

       Operation  is  as  follows: whenever a request for service arrives, the
       inetd daemon is tricked into running the tcpd program  instead  of  the
       desired	server. tcpd logs the request and does some additional checks.
       When all is well, tcpd runs the appropriate  server  program  and  goes

       Optional  features  are:  pattern-based access control, client username
       lookups with the RFC 931 etc. protocol, protection against  hosts  that
       pretend	to  have someone elses host name, and protection against hosts
       that pretend to have someone elses network address.

LOGGING    [Toc]    [Back]

       Connections that are monitored by tcpd are reported  through  the  sys-
       log(3)  facility.  Each	record	contains a time stamp, the client host
       name and the name of the requested service.   The  information  can  be
       useful  to detect unwanted activities, especially when logfile information
 from several hosts is merged.

       In order to find out where your logs are going, examine the syslog configuration
 file, usually /etc/syslog.conf.

ACCESS CONTROL    [Toc]    [Back]

       Optionally, tcpd supports a simple form of access control that is based
       on pattern matching.  The access-control software  provides  hooks  for
       the execution of shell commands when a pattern fires.  For details, see
       the hosts_access(5) manual page.


       The authentication scheme of some protocols  (rlogin,  rsh)  relies  on
       host  names.  Some  implementations believe the host name that they get
       from any random name server; other implementations are more careful but
       use a flawed algorithm.

       tcpd   verifies	 the   client  host  name  that  is  returned  by  the
       address->name DNS server by looking at the host name and  address  that
       are  returned  by  the name->address DNS server.  If any discrepancy is
       detected, tcpd concludes that it is dealing with a host	that  pretends
       to have someone elses host name.

       If the sources are compiled with -DPARANOID, tcpd will drop the connection
 in case of a host name/address mismatch.  Otherwise, the  hostname
       can  be matched with the PARANOID wildcard, after which suitable action
       can be taken.


       Optionally, tcpd disables source-routing socket options on  every  connection
	that  it  deals with. This will take care of most attacks from
       hosts that pretend to have an address that  belongs  to	someone  elses
       network. UDP services do not benefit from this protection. This feature
       must be turned on at compile time.

RFC 931    [Toc]    [Back]

       When RFC 931 etc. lookups are enabled (compile-time option)  tcpd  will
       attempt	to  establish  the  name of the client user. This will succeed
       only if the client host runs an RFC 931-compliant daemon.  Client  user
       name  lookups  will not work for datagram-oriented connections, and may
       cause noticeable delays in the case of connections from PCs.

EXAMPLES    [Toc]    [Back]

       The details of using tcpd depend on pathname information that was  compiled
 into the program.

EXAMPLE 1    [Toc]    [Back]

       This  example  applies when tcpd expects that the original network daemons
 will be moved to an "other" place.

       In order to monitor access to the finger  service,  move  the  original
       finger daemon to the "other" place and install tcpd in the place of the
       original finger daemon. No changes are required to configuration files.

	    # mkdir /other/place
	    # mv /usr/etc/in.fingerd /other/place
	    # cp tcpd /usr/etc/in.fingerd

       The  example assumes that the network daemons live in /usr/etc. On some
       systems, network daemons live in /usr/sbin or in /usr/libexec, or  have
       no `in.' prefix to their name.

EXAMPLE 2    [Toc]    [Back]

       This  example  applies  when  tcpd expects that the network daemons are
       left in their original place.

       In order to monitor access to the finger service, perform the following
       edits  on  the  inetd  configuration  file  (usually /etc/inetd.conf or

	    finger  stream  tcp  nowait  nobody  /usr/etc/in.fingerd  in.fingerd


	    finger  stream  tcp  nowait  nobody  /some/where/tcpd     in.fingerd

       The example assumes that the network daemons live in /usr/etc. On  some
       systems, network daemons live in /usr/sbin or in /usr/libexec, the daemons
 have no `in.' prefix to their name, or there is no userid field in
       the inetd configuration file.

       Similar	changes  will  be needed for the other services that are to be
       covered by tcpd.  Send a `kill -HUP' to the inetd(8)  process  to  make
       the changes effective. AIX users may also have to execute the `inetimp'

EXAMPLE 3    [Toc]    [Back]

       In the case of daemons that do not live in a common directory ("secret"
       or  otherwise),	edit the inetd configuration file so that it specifies
       an absolute path name for the process name field. For example:

	   ntalk  dgram  udp  wait  root  /some/where/tcpd  /usr/local/lib/ntalkd

       Only the last component (ntalkd) of  the  pathname  will  be  used  for
       access control and logging.

BUGS    [Toc]    [Back]

       Some  UDP  (and	RPC) daemons linger around for a while after they have
       finished their work, in case another request comes in.	In  the  inetd
       configuration  file these services are registered with the wait option.
       Only the request that started such a daemon will be logged.

       The program does not work with RPC services over  TCP.  These  services
       are  registered	as  rpc/tcp  in the inetd configuration file. The only
       non-trivial service that is affected by this limitation is rexd,  which
       is  used by the on(1) command. This is no great loss.  On most systems,
       rexd is less secure than a wildcard in /etc/hosts.equiv.

       RPC broadcast requests (for example: rwall, rup, rusers) always	appear
       to  come  from  the  responding	host.  What happens is that the client
       broadcasts the request to all portmap  daemons  on  its	network;  each
       portmap	daemon	forwards  the request to a local daemon. As far as the
       rwall etc.  daemons know, the request comes from the local host.

FILES    [Toc]    [Back]

       The default locations of the host access control tables are:


SEE ALSO    [Toc]    [Back]

       hosts_access(5), format of the tcpd access control tables.
       syslog.conf(5), format of the syslogd control file.
       inetd.conf(5), format of the inetd control file.

AUTHORS    [Toc]    [Back]

       Wietse Venema (wietse@wzv.win.tue.nl),
       Department of Mathematics and Computing Science,
       Eindhoven University of Technology
       Den Dolech 2, P.O. Box 513,
       5600 MB Eindhoven, The Netherlands

[ Back ]
 Similar pages
Name OS Title
tcpd OpenBSD tcp wrappers access control facility for internet services
lomac FreeBSD Low-Watermark Mandatory Access Control security facility
inetd Tru64 Internet services daemon
inetd HP-UX Internet services daemon
services Linux Internet network services list
services Tru64 Defines the sockets and protocols used for Internet services
inetsvcs_sec HP-UX enable/disable secure internet services
inetsvcs.conf HP-UX configuration file for secure internet services
sis HP-UX secure internet services with Kerberos authentication and authorization
rcinet Tru64 Restarts, starts, or stops Internet network services on the system
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service