freebsd-skq/crypto/openssh/README.privsep

64 lines
2.6 KiB
Plaintext
Raw Normal View History

2002-06-27 22:31:32 +00:00
Privilege separation, or privsep, is method in OpenSSH by which
operations that require root privilege are performed by a separate
privileged monitor process. Its purpose is to prevent privilege
2004-02-26 10:38:49 +00:00
escalation by containing corruption to an unprivileged process.
2002-06-27 22:31:32 +00:00
More information is available at:
http://www.citi.umich.edu/u/provos/ssh/privsep.html
Privilege separation is now enabled by default; see the
UsePrivilegeSeparation option in sshd_config(5).
2004-02-26 10:38:49 +00:00
On systems which lack mmap or anonymous (MAP_ANON) memory mapping,
compression must be disabled in order for privilege separation to
2002-06-27 22:31:32 +00:00
function.
2002-06-29 11:34:13 +00:00
When privsep is enabled, during the pre-authentication phase sshd will
2002-06-27 22:31:32 +00:00
chroot(2) to "/var/empty" and change its privileges to the "sshd" user
2002-06-29 11:34:13 +00:00
and its primary group. sshd is a pseudo-account that should not be
used by other daemons, and must be locked and should contain a
"nologin" or invalid shell.
You should do something like the following to prepare the privsep
preauth environment:
2002-06-27 22:31:32 +00:00
# mkdir /var/empty
# chown root:sys /var/empty
# chmod 755 /var/empty
# groupadd sshd
2002-06-29 11:34:13 +00:00
# useradd -g sshd -c 'sshd privsep' -d /var/empty -s /bin/false sshd
2002-06-27 22:31:32 +00:00
/var/empty should not contain any files.
configure supports the following options to change the default
privsep user and chroot directory:
--with-privsep-path=xxx Path for privilege separation chroot
--with-privsep-user=user Specify non-privileged user for privilege separation
2002-06-29 11:34:13 +00:00
Privsep requires operating system support for file descriptor passing.
Compression will be disabled on systems without a working mmap MAP_ANON.
2002-06-27 22:31:32 +00:00
2005-09-03 06:59:33 +00:00
PAM-enabled OpenSSH is known to function with privsep on AIX, FreeBSD,
HP-UX (including Trusted Mode), Linux, NetBSD and Solaris.
2002-06-27 22:31:32 +00:00
2004-10-28 16:03:53 +00:00
On Cygwin, Tru64 Unix, OpenServer, and Unicos only the pre-authentication
part of privsep is supported. Post-authentication privsep is disabled
automatically (so you won't see the additional process mentioned below).
2002-06-27 22:31:32 +00:00
Note that for a normal interactive login with a shell, enabling privsep
will require 1 additional process per login session.
Given the following process listing (from HP-UX):
UID PID PPID C STIME TTY TIME COMMAND
root 1005 1 0 10:45:17 ? 0:08 /opt/openssh/sbin/sshd -u0
root 6917 1005 0 15:19:16 ? 0:00 sshd: stevesk [priv]
stevesk 6919 6917 0 15:19:17 ? 0:03 sshd: stevesk@2
stevesk 6921 6919 0 15:19:17 pts/2 0:00 -bash
process 1005 is the sshd process listening for new connections.
process 6917 is the privileged monitor process, 6919 is the user owned
sshd process and 6921 is the shell process.
2005-09-03 06:59:33 +00:00
$Id: README.privsep,v 1.16 2005/06/04 23:21:41 djm Exp $