summaryrefslogtreecommitdiffstats
path: root/usr.bin/ssh/sshd_config.5
diff options
context:
space:
mode:
authordjm <djm@openbsd.org>2008-04-04 05:14:38 +0000
committerdjm <djm@openbsd.org>2008-04-04 05:14:38 +0000
commitde51a352e5fa8d3a3890613a591b7955f10bf4ce (patch)
tree0d36cfe327f56cf9483b95492d7fdd1d6934d4e7 /usr.bin/ssh/sshd_config.5
parentsimplify SNDCTL_DSP_SETTRIGGER (diff)
downloadwireguard-openbsd-de51a352e5fa8d3a3890613a591b7955f10bf4ce.tar.xz
wireguard-openbsd-de51a352e5fa8d3a3890613a591b7955f10bf4ce.zip
ChrootDirectory is supported in Match blocks (in fact, it is most useful
there). Spotted by Minstrel AT minstrel.org.uk
Diffstat (limited to 'usr.bin/ssh/sshd_config.5')
-rw-r--r--usr.bin/ssh/sshd_config.538
1 files changed, 36 insertions, 2 deletions
diff --git a/usr.bin/ssh/sshd_config.5 b/usr.bin/ssh/sshd_config.5
index 9212eb5ac5b..a5a140d410b 100644
--- a/usr.bin/ssh/sshd_config.5
+++ b/usr.bin/ssh/sshd_config.5
@@ -34,8 +34,8 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.\" $OpenBSD: sshd_config.5,v 1.84 2008/03/25 11:58:02 djm Exp $
-.Dd $Mdocdate: March 25 2008 $
+.\" $OpenBSD: sshd_config.5,v 1.85 2008/04/04 05:14:38 djm Exp $
+.Dd $Mdocdate: April 4 2008 $
.Dt SSHD_CONFIG 5
.Os
.Sh NAME
@@ -210,6 +210,29 @@ in-process sftp server is used (see
.Cm Subsystem
for details).
.Pp
+Please note that there are many ways to misconfigure a chroot environment
+in ways that compromise security.
+These include:
+.Pp
+.Bl -dash -offset indent -compact
+.It
+Making unsafe setuid binaries available;
+.It
+Having missing or incorrect configuration files in the chroot's
+.Pa /etc
+directory;
+.It
+Hard-linking files between the chroot and outside;
+.It
+Leaving unnecessary
+.Pa /dev
+nodes accessible inside the chroot (especially those for physical drives);
+.It
+Executing scripts or binaries inside the chroot from outside, either
+directly or through facilities such as
+.Xr cron 8 .
+.El
+.Pp
The default is not to
.Xr chroot 2 .
.It Cm Ciphers
@@ -340,6 +363,11 @@ Specifying a command of
will force the use of an in-process sftp server that requires no support
files when used with
.Cm ChrootDirectory .
+Note that
+.Dq internal-sftp
+is only supported when
+.Cm UsePrivilegeSeparation
+is enabled.
.It Cm GatewayPorts
Specifies whether remote hosts are allowed to connect to ports
forwarded for the client.
@@ -563,6 +591,7 @@ keyword.
Available keywords are
.Cm AllowTcpForwarding ,
.Cm Banner ,
+.Cm ChrootDirectory ,
.Cm ForceCommand ,
.Cm GatewayPorts ,
.Cm GSSApiAuthentication ,
@@ -801,6 +830,11 @@ server.
This may simplify configurations using
.Cm ChrootDirectory
to force a different filesystem root on clients.
+Note that
+.Dq internal-sftp
+is only supported when
+.Cm UsePrivilegeSeparation
+is enabled.
.Pp
By default no subsystems are defined.
Note that this option applies to protocol version 2 only.