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