crypto/openssh/sshd_config.5

   1 .\"  -*- nroff -*-
   2 .\"
   3 .\" Author: Tatu Ylonen <ylo@cs.hut.fi>
   4 .\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
   5 .\"                    All rights reserved
   6 .\"
   7 .\" As far as I am concerned, the code I have written for this software
   8 .\" can be used freely for any purpose.  Any derived versions of this
   9 .\" software must be clearly marked as such, and if the derived work is
  10 .\" incompatible with the protocol description in the RFC file, it must be
  11 .\" called by a name other than "ssh" or "Secure Shell".
  12 .\"
  13 .\" Copyright (c) 1999,2000 Markus Friedl.  All rights reserved.
  14 .\" Copyright (c) 1999 Aaron Campbell.  All rights reserved.
  15 .\" Copyright (c) 1999 Theo de Raadt.  All rights reserved.
  16 .\"
  17 .\" Redistribution and use in source and binary forms, with or without
  18 .\" modification, are permitted provided that the following conditions
  19 .\" are met:
  20 .\" 1. Redistributions of source code must retain the above copyright
  21 .\"    notice, this list of conditions and the following disclaimer.
  22 .\" 2. Redistributions in binary form must reproduce the above copyright
  23 .\"    notice, this list of conditions and the following disclaimer in the
  24 .\"    documentation and/or other materials provided with the distribution.
  25 .\"
  26 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  27 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  28 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  29 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  30 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  31 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  32 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  33 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  34 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  35 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  36 .\"
  37 .\" $OpenBSD: sshd_config.5,v 1.13 2002/09/16 20:12:11 stevesk Exp $
  38 .\" $FreeBSD: src/crypto/openssh/sshd_config.5,v 1.5.2.5 2003/02/11 12:11:54 des Exp $
  39 .Dd September 25, 1999
  40 .Dt SSHD_CONFIG 5
  41 .Os
  42 .Sh NAME
  43 .Nm sshd_config
  44 .Nd OpenSSH SSH daemon configuration file
  45 .Sh SYNOPSIS
  46 .Bl -tag -width Ds -compact
  47 .It Pa /etc/ssh/sshd_config
  48 .El
  49 .Sh DESCRIPTION
  50 .Nm sshd
  51 reads configuration data from
  52 .Pa /etc/ssh/sshd_config
  53 (or the file specified with
  54 .Fl f
  55 on the command line).
  56 The file contains keyword-argument pairs, one per line.
  57 Lines starting with
  58 .Ql #
  59 and empty lines are interpreted as comments.
  60 .Pp
  61 The possible
  62 keywords and their meanings are as follows (note that
  63 keywords are case-insensitive and arguments are case-sensitive):
  64 .Bl -tag -width Ds
  65 .It Cm AFSTokenPassing
  66 Specifies whether an AFS token may be forwarded to the server.
  67 Default is
  68 .Dq no .
  69 .It Cm AllowGroups
  70 This keyword can be followed by a list of group name patterns, separated
  71 by spaces.
  72 If specified, login is allowed only for users whose primary
  73 group or supplementary group list matches one of the patterns.
  74 .Ql \&*
  75 and
  76 .Ql ?
  77 can be used as
  78 wildcards in the patterns.
  79 Only group names are valid; a numerical group ID is not recognized.
  80 By default, login is allowed for all groups.
  81 .Pp
  82 .It Cm AllowTcpForwarding
  83 Specifies whether TCP forwarding is permitted.
  84 The default is
  85 .Dq yes .
  86 Note that disabling TCP forwarding does not improve security unless
  87 users are also denied shell access, as they can always install their
  88 own forwarders.
  89 .Pp
  90 .It Cm AllowUsers
  91 This keyword can be followed by a list of user name patterns, separated
  92 by spaces.
  93 If specified, login is allowed only for users names that
  94 match one of the patterns.
  95 .Ql \&*
  96 and
  97 .Ql ?
  98 can be used as
  99 wildcards in the patterns.
 100 Only user names are valid; a numerical user ID is not recognized.
 101 By default, login is allowed for all users.
 102 If the pattern takes the form USER@HOST then USER and HOST
 103 are separately checked, restricting logins to particular
 104 users from particular hosts.
 105 .Pp
 106 .It Cm AuthorizedKeysFile
 107 Specifies the file that contains the public keys that can be used
 108 for user authentication.
 109 .Cm AuthorizedKeysFile
 110 may contain tokens of the form %T which are substituted during connection
 111 set-up. The following tokens are defined: %% is replaced by a literal '%',
 112 %h is replaced by the home directory of the user being authenticated and
 113 %u is replaced by the username of that user.
 114 After expansion,
 115 .Cm AuthorizedKeysFile
 116 is taken to be an absolute path or one relative to the user's home
 117 directory.
 118 The default is
 119 .Dq .ssh/authorized_keys .
 120 .It Cm Banner
 121 In some jurisdictions, sending a warning message before authentication
 122 may be relevant for getting legal protection.
 123 The contents of the specified file are sent to the remote user before
 124 authentication is allowed.
 125 This option is only available for protocol version 2.
 126 By default, no banner is displayed.
 127 .Pp
 128 .It Cm ChallengeResponseAuthentication
 129 Specifies whether challenge-response authentication is allowed.
 130 Specifically, in
 131 .Fx ,
 132 this controls the use of PAM (see
 133 .Xr pam 3 )
 134 for authentication.
 135 Note that this affects the effectiveness of the
 136 .Cm PasswordAuthentication
 137 and
 138 .Cm PermitRootLogin
 139 variables.
 140 The default is
 141 .Dq yes .
 142 .It Cm Ciphers
 143 Specifies the ciphers allowed for protocol version 2.
 144 Multiple ciphers must be comma-separated.
 145 The default is
 146 .Pp
 147 .Bd -literal
 148   ``aes128-cbc,3des-cbc,blowfish-cbc,cast128-cbc,arcfour,
 149     aes192-cbc,aes256-cbc''
 150 .Ed
 151 .It Cm ClientAliveInterval
 152 Sets a timeout interval in seconds after which if no data has been received
 153 from the client,
 154 .Nm sshd
 155 will send a message through the encrypted
 156 channel to request a response from the client.
 157 The default
 158 is 0, indicating that these messages will not be sent to the client.
 159 This option applies to protocol version 2 only.
 160 .It Cm ClientAliveCountMax
 161 Sets the number of client alive messages (see above) which may be
 162 sent without
 163 .Nm sshd
 164 receiving any messages back from the client. If this threshold is
 165 reached while client alive messages are being sent,
 166 .Nm sshd
 167 will disconnect the client, terminating the session. It is important
 168 to note that the use of client alive messages is very different from
 169 .Cm KeepAlive
 170 (below). The client alive messages are sent through the
 171 encrypted channel and therefore will not be spoofable. The TCP keepalive
 172 option enabled by
 173 .Cm KeepAlive
 174 is spoofable. The client alive mechanism is valuable when the client or
 175 server depend on knowing when a connection has become inactive.
 176 .Pp
 177 The default value is 3. If
 178 .Cm ClientAliveInterval
 179 (above) is set to 15, and
 180 .Cm ClientAliveCountMax
 181 is left at the default, unresponsive ssh clients
 182 will be disconnected after approximately 45 seconds.
 183 .It Cm Compression
 184 Specifies whether compression is allowed.
 185 The argument must be
 186 .Dq yes
 187 or
 188 .Dq no .
 189 The default is
 190 .Dq yes .
 191 .It Cm DenyGroups
 192 This keyword can be followed by a list of group name patterns, separated
 193 by spaces.
 194 Login is disallowed for users whose primary group or supplementary
 195 group list matches one of the patterns.
 196 .Ql \&*
 197 and
 198 .Ql ?
 199 can be used as
 200 wildcards in the patterns.
 201 Only group names are valid; a numerical group ID is not recognized.
 202 By default, login is allowed for all groups.
 203 .Pp
 204 .It Cm DenyUsers
 205 This keyword can be followed by a list of user name patterns, separated
 206 by spaces.
 207 Login is disallowed for user names that match one of the patterns.
 208 .Ql \&*
 209 and
 210 .Ql ?
 211 can be used as wildcards in the patterns.
 212 Only user names are valid; a numerical user ID is not recognized.
 213 By default, login is allowed for all users.
 214 If the pattern takes the form USER@HOST then USER and HOST
 215 are separately checked, restricting logins to particular
 216 users from particular hosts.
 217 .It Cm GatewayPorts
 218 Specifies whether remote hosts are allowed to connect to ports
 219 forwarded for the client.
 220 By default,
 221 .Nm sshd
 222 binds remote port forwardings to the loopback address.  This
 223 prevents other remote hosts from connecting to forwarded ports.
 224 .Cm GatewayPorts
 225 can be used to specify that
 226 .Nm sshd
 227 should bind remote port forwardings to the wildcard address,
 228 thus allowing remote hosts to connect to forwarded ports.
 229 The argument must be
 230 .Dq yes
 231 or
 232 .Dq no .
 233 The default is
 234 .Dq no .
 235 .It Cm HostbasedAuthentication
 236 Specifies whether rhosts or /etc/hosts.equiv authentication together
 237 with successful public key client host authentication is allowed
 238 (hostbased authentication).
 239 This option is similar to
 240 .Cm RhostsRSAAuthentication
 241 and applies to protocol version 2 only.
 242 The default is
 243 .Dq no .
 244 .It Cm HostKey
 245 Specifies a file containing a private host key
 246 used by SSH.
 247 The default is
 248 .Pa /etc/ssh/ssh_host_key
 249 for protocol version 1, and
 250 .Pa /etc/ssh/ssh_host_dsa_key
 251 for protocol version 2.
 252 Note that
 253 .Nm sshd
 254 will refuse to use a file if it is group/world-accessible.
 255 It is possible to have multiple host key files.
 256 .Dq rsa1
 257 keys are used for version 1 and
 258 .Dq dsa
 259 or
 260 .Dq rsa
 261 are used for version 2 of the SSH protocol.
 262 .It Cm IgnoreRhosts
 263 Specifies that
 264 .Pa .rhosts
 265 and
 266 .Pa .shosts
 267 files will not be used in
 268 .Cm RhostsAuthentication ,
 269 .Cm RhostsRSAAuthentication
 270 or
 271 .Cm HostbasedAuthentication .
 272 .Pp
 273 .Pa /etc/hosts.equiv
 274 and
 275 .Pa /etc/ssh/shosts.equiv
 276 are still used.
 277 The default is
 278 .Dq yes .
 279 .It Cm IgnoreUserKnownHosts
 280 Specifies whether
 281 .Nm sshd
 282 should ignore the user's
 283 .Pa $HOME/.ssh/known_hosts
 284 during
 285 .Cm RhostsRSAAuthentication
 286 or
 287 .Cm HostbasedAuthentication .
 288 The default is
 289 .Dq no .
 290 .It Cm KeepAlive
 291 Specifies whether the system should send TCP keepalive messages to the
 292 other side.
 293 If they are sent, death of the connection or crash of one
 294 of the machines will be properly noticed.
 295 However, this means that
 296 connections will die if the route is down temporarily, and some people
 297 find it annoying.
 298 On the other hand, if keepalives are not sent,
 299 sessions may hang indefinitely on the server, leaving
 300 .Dq ghost
 301 users and consuming server resources.
 302 .Pp
 303 The default is
 304 .Dq yes
 305 (to send keepalives), and the server will notice
 306 if the network goes down or the client host crashes.
 307 This avoids infinitely hanging sessions.
 308 .Pp
 309 To disable keepalives, the value should be set to
 310 .Dq no .
 311 .It Cm KerberosAuthentication
 312 Specifies whether Kerberos authentication is allowed.
 313 This can be in the form of a Kerberos ticket, or if
 314 .Cm PasswordAuthentication
 315 is yes, the password provided by the user will be validated through
 316 the Kerberos KDC.
 317 To use this option, the server needs a
 318 Kerberos servtab which allows the verification of the KDC's identity.
 319 Default is
 320 .Dq no .
 321 .It Cm KerberosOrLocalPasswd
 322 If set then if password authentication through Kerberos fails then
 323 the password will be validated via any additional local mechanism
 324 such as
 325 .Pa /etc/passwd .
 326 Default is
 327 .Dq yes .
 328 .It Cm KerberosTgtPassing
 329 Specifies whether a Kerberos TGT may be forwarded to the server.
 330 Default is
 331 .Dq no ,
 332 as this only works when the Kerberos KDC is actually an AFS kaserver.
 333 .It Cm KerberosTicketCleanup
 334 Specifies whether to automatically destroy the user's ticket cache
 335 file on logout.
 336 Default is
 337 .Dq yes .
 338 .It Cm KeyRegenerationInterval
 339 In protocol version 1, the ephemeral server key is automatically regenerated
 340 after this many seconds (if it has been used).
 341 The purpose of regeneration is to prevent
 342 decrypting captured sessions by later breaking into the machine and
 343 stealing the keys.
 344 The key is never stored anywhere.
 345 If the value is 0, the key is never regenerated.
 346 The default is 3600 (seconds).
 347 .It Cm ListenAddress
 348 Specifies the local addresses
 349 .Nm sshd
 350 should listen on.
 351 The following forms may be used:
 352 .Pp
 353 .Bl -item -offset indent -compact
 354 .It
 355 .Cm ListenAddress
 356 .Sm off
 357 .Ar host No | Ar IPv4_addr No | Ar IPv6_addr
 358 .Sm on
 359 .It
 360 .Cm ListenAddress
 361 .Sm off
 362 .Ar host No | Ar IPv4_addr No : Ar port
 363 .Sm on
 364 .It
 365 .Cm ListenAddress
 366 .Sm off
 367 .Oo
 368 .Ar host No | Ar IPv6_addr Oc : Ar port
 369 .Sm on
 370 .El
 371 .Pp
 372 If
 373 .Ar port
 374 is not specified,
 375 .Nm sshd
 376 will listen on the address and all prior
 377 .Cm Port
 378 options specified. The default is to listen on all local
 379 addresses.  Multiple
 380 .Cm ListenAddress
 381 options are permitted. Additionally, any
 382 .Cm Port
 383 options must precede this option for non port qualified addresses.
 384 .It Cm LoginGraceTime
 385 The server disconnects after this time if the user has not
 386 successfully logged in.
 387 If the value is 0, there is no time limit.
 388 The default is 120 seconds.
 389 .It Cm LogLevel
 390 Gives the verbosity level that is used when logging messages from
 391 .Nm sshd .
 392 The possible values are:
 393 QUIET, FATAL, ERROR, INFO, VERBOSE, DEBUG, DEBUG1, DEBUG2 and DEBUG3.
 394 The default is INFO.  DEBUG and DEBUG1 are equivalent.  DEBUG2
 395 and DEBUG3 each specify higher levels of debugging output.
 396 Logging with a DEBUG level violates the privacy of users
 397 and is not recommended.
 398 .It Cm MACs
 399 Specifies the available MAC (message authentication code) algorithms.
 400 The MAC algorithm is used in protocol version 2
 401 for data integrity protection.
 402 Multiple algorithms must be comma-separated.
 403 The default is
 404 .Dq hmac-md5,hmac-sha1,hmac-ripemd160,hmac-sha1-96,hmac-md5-96 .
 405 .It Cm MaxStartups
 406 Specifies the maximum number of concurrent unauthenticated connections to the
 407 .Nm sshd
 408 daemon.
 409 Additional connections will be dropped until authentication succeeds or the
 410 .Cm LoginGraceTime
 411 expires for a connection.
 412 The default is 10.
 413 .Pp
 414 Alternatively, random early drop can be enabled by specifying
 415 the three colon separated values
 416 .Dq start:rate:full
 417 (e.g., "10:30:60").
 418 .Nm sshd
 419 will refuse connection attempts with a probability of
 420 .Dq rate/100
 421 (30%)
 422 if there are currently
 423 .Dq start
 424 (10)
 425 unauthenticated connections.
 426 The probability increases linearly and all connection attempts
 427 are refused if the number of unauthenticated connections reaches
 428 .Dq full
 429 (60).
 430 .It Cm PasswordAuthentication
 431 Specifies whether password authentication is allowed.
 432 The default is
 433 .Dq yes .
 434 Note that
 435 .Cm ChallengeResponseAuthentication
 436 is
 437 .Dq yes ,
 438 and the PAM authentication policy for
 439 .Nm sshd
 440 includes
 441 .Xr pam_unix 8 ,
 442 password authentication will be allowed through the challenge-response
 443 mechanism regardless of the value of
 444 .Cm PasswordAuthentication .
 445 .It Cm PermitEmptyPasswords
 446 When password authentication is allowed, it specifies whether the
 447 server allows login to accounts with empty password strings.
 448 The default is
 449 .Dq no .
 450 .It Cm PermitRootLogin
 451 Specifies whether root can login using
 452 .Xr ssh 1 .
 453 The argument must be
 454 .Dq yes ,
 455 .Dq without-password ,
 456 .Dq forced-commands-only
 457 or
 458 .Dq no .
 459 The default is
 460 .Dq no .
 461 Note that if
 462 .Cm ChallengeResponseAuthentication
 463 is
 464 .Dq yes ,
 465 the root user may be allowed in with its password even if
 466 .Cm PermitRootLogin is set to
 467 .Dq without-password .
 468 .Pp
 469 If this option is set to
 470 .Dq without-password
 471 password authentication is disabled for root.
 472 .Pp
 473 If this option is set to
 474 .Dq forced-commands-only
 475 root login with public key authentication will be allowed,
 476 but only if the
 477 .Ar command
 478 option has been specified
 479 (which may be useful for taking remote backups even if root login is
 480 normally not allowed). All other authentication methods are disabled
 481 for root.
 482 .Pp
 483 If this option is set to
 484 .Dq no
 485 root is not allowed to login.
 486 .It Cm PermitUserEnvironment
 487 Specifies whether
 488 .Pa ~/.ssh/environment
 489 and
 490 .Cm environment=
 491 options in
 492 .Pa ~/.ssh/authorized_keys
 493 are processed by
 494 .Nm sshd .
 495 The default is
 496 .Dq no .
 497 Enabling environment processing may enable users to bypass access
 498 restrictions in some configurations using mechanisms such as
 499 .Ev LD_PRELOAD .
 500 .It Cm PidFile
 501 Specifies the file that contains the process ID of the
 502 .Nm sshd
 503 daemon.
 504 The default is
 505 .Pa /var/run/sshd.pid .
 506 .It Cm Port
 507 Specifies the port number that
 508 .Nm sshd
 509 listens on.
 510 The default is 22.
 511 Multiple options of this type are permitted.
 512 See also
 513 .Cm ListenAddress .
 514 .It Cm PrintLastLog
 515 Specifies whether
 516 .Nm sshd
 517 should print the date and time when the user last logged in.
 518 The default is
 519 .Dq yes .
 520 .It Cm PrintMotd
 521 Specifies whether
 522 .Nm sshd
 523 should print
 524 .Pa /etc/motd
 525 when a user logs in interactively.
 526 (On some systems it is also printed by the shell,
 527 .Pa /etc/profile ,
 528 or equivalent.)
 529 The default is
 530 .Dq yes .
 531 .It Cm Protocol
 532 Specifies the protocol versions
 533 .Nm sshd
 534 supports.
 535 The possible values are
 536 .Dq 1
 537 and
 538 .Dq 2 .
 539 Multiple versions must be comma-separated.
 540 The default is
 541 .Dq 2,1 .
 542 Note that the order of the protocol list does not indicate preference,
 543 because the client selects among multiple protocol versions offered
 544 by the server.
 545 Specifying
 546 .Dq 2,1
 547 is identical to
 548 .Dq 1,2 .
 549 .It Cm PubkeyAuthentication
 550 Specifies whether public key authentication is allowed.
 551 The default is
 552 .Dq yes .
 553 Note that this option applies to protocol version 2 only.
 554 .It Cm RhostsAuthentication
 555 Specifies whether authentication using rhosts or
 556 .Pa /etc/hosts.equiv
 557 files is sufficient.
 558 Normally, this method should not be permitted because it is insecure.
 559 .Cm RhostsRSAAuthentication
 560 should be used
 561 instead, because it performs RSA-based host authentication in addition
 562 to normal rhosts or
 563 .Pa /etc/hosts.equiv
 564 authentication.
 565 The default is
 566 .Dq no .
 567 This option applies to protocol version 1 only.
 568 .It Cm RhostsRSAAuthentication
 569 Specifies whether rhosts or
 570 .Pa /etc/hosts.equiv
 571 authentication together
 572 with successful RSA host authentication is allowed.
 573 The default is
 574 .Dq no .
 575 This option applies to protocol version 1 only.
 576 .It Cm RSAAuthentication
 577 Specifies whether pure RSA authentication is allowed.
 578 The default is
 579 .Dq yes .
 580 This option applies to protocol version 1 only.
 581 .It Cm ServerKeyBits
 582 Defines the number of bits in the ephemeral protocol version 1 server key.
 583 The minimum value is 512, and the default is 768.
 584 .It Cm StrictModes
 585 Specifies whether
 586 .Nm sshd
 587 should check file modes and ownership of the
 588 user's files and home directory before accepting login.
 589 This is normally desirable because novices sometimes accidentally leave their
 590 directory or files world-writable.
 591 The default is
 592 .Dq yes .
 593 .It Cm Subsystem
 594 Configures an external subsystem (e.g., file transfer daemon).
 595 Arguments should be a subsystem name and a command to execute upon subsystem
 596 request.
 597 The command
 598 .Xr sftp-server 8
 599 implements the
 600 .Dq sftp
 601 file transfer subsystem.
 602 By default no subsystems are defined.
 603 Note that this option applies to protocol version 2 only.
 604 .It Cm SyslogFacility
 605 Gives the facility code that is used when logging messages from
 606 .Nm sshd .
 607 The possible values are: DAEMON, USER, AUTH, LOCAL0, LOCAL1, LOCAL2,
 608 LOCAL3, LOCAL4, LOCAL5, LOCAL6, LOCAL7.
 609 The default is AUTH.
 610 .It Cm UseLogin
 611 Specifies whether
 612 .Xr login 1
 613 is used for interactive login sessions.
 614 The default is
 615 .Dq no .
 616 Note that
 617 .Xr login 1
 618 is never used for remote command execution.
 619 Note also, that if this is enabled,
 620 .Cm X11Forwarding
 621 will be disabled because
 622 .Xr login 1
 623 does not know how to handle
 624 .Xr xauth 1
 625 cookies.  If
 626 .Cm UsePrivilegeSeparation
 627 is specified, it will be disabled after authentication.
 628 .It Cm UsePrivilegeSeparation
 629 Specifies whether
 630 .Nm sshd
 631 separates privileges by creating an unprivileged child process
 632 to deal with incoming network traffic.  After successful authentication,
 633 another process will be created that has the privilege of the authenticated
 634 user.  The goal of privilege separation is to prevent privilege
 635 escalation by containing any corruption within the unprivileged processes.
 636 The default is
 637 .Dq yes .
 638 .It Cm VerifyReverseMapping
 639 Specifies whether
 640 .Nm sshd
 641 should try to verify the remote host name and check that
 642 the resolved host name for the remote IP address maps back to the
 643 very same IP address.
 644 The default is
 645 .Dq no .
 646 .It Cm VersionAddendum
 647 Specifies a string to append to the regular version string to identify
 648 OS- or site-specific modifications.
 649 The default is
 650 .Dq FreeBSD-20030201 .
 651 .It Cm X11DisplayOffset
 652 Specifies the first display number available for
 653 .Nm sshd Ns 's
 654 X11 forwarding.
 655 This prevents
 656 .Nm sshd
 657 from interfering with real X11 servers.
 658 The default is 10.
 659 .It Cm X11Forwarding
 660 Specifies whether X11 forwarding is permitted.
 661 The argument must be
 662 .Dq yes
 663 or
 664 .Dq no .
 665 The default is
 666 .Dq yes .
 667 .Pp
 668 When X11 forwarding is enabled, there may be additional exposure to
 669 the server and to client displays if the
 670 .Nm sshd
 671 proxy display is configured to listen on the wildcard address (see
 672 .Cm X11UseLocalhost
 673 below), however this is not the default.
 674 Additionally, the authentication spoofing and authentication data
 675 verification and substitution occur on the client side.
 676 The security risk of using X11 forwarding is that the client's X11
 677 display server may be exposed to attack when the ssh client requests
 678 forwarding (see the warnings for
 679 .Cm ForwardX11
 680 in
 681 .Xr ssh_config 5 ).
 682 A system administrator may have a stance in which they want to
 683 protect clients that may expose themselves to attack by unwittingly
 684 requesting X11 forwarding, which can warrant a
 685 .Dq no
 686 setting.
 687 .Pp
 688 Note that disabling X11 forwarding does not prevent users from
 689 forwarding X11 traffic, as users can always install their own forwarders.
 690 X11 forwarding is automatically disabled if
 691 .Cm UseLogin
 692 is enabled.
 693 .It Cm X11UseLocalhost
 694 Specifies whether
 695 .Nm sshd
 696 should bind the X11 forwarding server to the loopback address or to
 697 the wildcard address.  By default,
 698 .Nm sshd
 699 binds the forwarding server to the loopback address and sets the
 700 hostname part of the
 701 .Ev DISPLAY
 702 environment variable to
 703 .Dq localhost .
 704 This prevents remote hosts from connecting to the proxy display.
 705 However, some older X11 clients may not function with this
 706 configuration.
 707 .Cm X11UseLocalhost
 708 may be set to
 709 .Dq no
 710 to specify that the forwarding server should be bound to the wildcard
 711 address.
 712 The argument must be
 713 .Dq yes
 714 or
 715 .Dq no .
 716 The default is
 717 .Dq yes .
 718 .It Cm XAuthLocation
 719 Specifies the full pathname of the
 720 .Xr xauth 1
 721 program.
 722 The default is
 723 .Pa /usr/X11R6/bin/xauth .
 724 .El
 725 .Ss Time Formats
 726 .Pp
 727 .Nm sshd
 728 command-line arguments and configuration file options that specify time
 729 may be expressed using a sequence of the form:
 730 .Sm off
 731 .Ar time Op Ar qualifier ,
 732 .Sm on
 733 where
 734 .Ar time
 735 is a positive integer value and
 736 .Ar qualifier
 737 is one of the following:
 738 .Pp
 739 .Bl -tag -width Ds -compact -offset indent
 740 .It Cm <none>
 741 seconds
 742 .It Cm s | Cm S
 743 seconds
 744 .It Cm m | Cm M
 745 minutes
 746 .It Cm h | Cm H
 747 hours
 748 .It Cm d | Cm D
 749 days
 750 .It Cm w | Cm W
 751 weeks
 752 .El
 753 .Pp
 754 Each member of the sequence is added together to calculate
 755 the total time value.
 756 .Pp
 757 Time format examples:
 758 .Pp
 759 .Bl -tag -width Ds -compact -offset indent
 760 .It 600
 761 600 seconds (10 minutes)
 762 .It 10m
 763 10 minutes
 764 .It 1h30m
 765 1 hour 30 minutes (90 minutes)
 766 .El
 767 .Sh FILES
 768 .Bl -tag -width Ds
 769 .It Pa /etc/ssh/sshd_config
 770 Contains configuration data for
 771 .Nm sshd .
 772 This file should be writable by root only, but it is recommended
 773 (though not necessary) that it be world-readable.
 774 .El
 775 .Sh AUTHORS
 776 OpenSSH is a derivative of the original and free
 777 ssh 1.2.12 release by Tatu Ylonen.
 778 Aaron Campbell, Bob Beck, Markus Friedl, Niels Provos,
 779 Theo de Raadt and Dug Song
 780 removed many bugs, re-added newer features and
 781 created OpenSSH.
 782 Markus Friedl contributed the support for SSH
 783 protocol versions 1.5 and 2.0.
 784 Niels Provos and Markus Friedl contributed support
 785 for privilege separation.
 786 .Sh SEE ALSO
 787 .Xr sshd 8