Bug 1587 - [man] sshd_config(5) provide examples of keyword 'Match'
Summary: [man] sshd_config(5) provide examples of keyword 'Match'
Status: CLOSED WORKSFORME
Alias: None
Product: Portable OpenSSH
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 5.2p1
Hardware: Other Other
: P2 enhancement
Assignee: Assigned to nobody
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-04-06 16:15 AEST by Jari Aalto
Modified: 2021-04-23 15:10 AEST (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jari Aalto 2009-04-06 16:15:17 AEST
The manual page reads:

    Match   Introduces a conditional block.  If all of the criteria on the
            Match line are satisfied, the keywords on the following lines
            override those set in the global section of the config file,
            until either another Match line or the end of the file.
            ...

This looks like a useful feature, but from the description is hard to understand how it is used.

Please provide 2-3 examples how to use this keyword in the manual page.
Comment 1 Jari Aalto 2009-04-06 19:07:28 AEST
Darren Tucker has posted informative message about the
use of "Match" keyword. Please include his examples to the
manual page.

http://archive.netbsd.se/?ml=openssh-unix-dev&a=2006-03&t=1883229

# allow anyone to authenticate normally from the local net
Match Address 192.168.0.0/24
	RequiredAuthentications default

# allow admins from the dmz with pubkey and password
Match Group admins Address 1.2.3.0/24
	RequiredAuthentications publickey,password

# deny untrusted and local users from any other net
Match Group untrusted,lusers
	RequiredAuthentications deny

# anyone else gets normal behaviour
Match all
	RequiredAuthentications default

There's also some potential for other things too:

Match User anoncvs
	PermitTcpForwarding no

Match Group nosftp
	Subsystem sftp /bin/false
Comment 2 Darren Tucker 2010-01-15 11:35:23 AEDT
There's an example in the sample sshd_config file:

# Example of overriding settings on a per-user basis
#Match User anoncvs
#>......X11Forwarding no
#>......AllowTcpForwarding no
#>......ForceCommand cvs server

(Most of the samples you quoted do not exist in the current code.)
Comment 3 Damien Miller 2019-05-31 14:35:59 AEST
The default sshd_config file already contains an example
Comment 4 Damien Miller 2021-04-23 15:10:00 AEST
closing resolved bugs as of 8.6p1 release