mirror of
https://github.com/inspec/inspec
synced 2024-11-23 21:23:29 +00:00
9cfc86d2ab
Light formatting changes, change order of example and matchers, slight color changes Signed-off-by: hannah-radish <hmaddy@chef.io>
79 lines
1.9 KiB
Text
79 lines
1.9 KiB
Text
---
|
|
title: About the ssh_config Resource
|
|
---
|
|
|
|
# ssh_config
|
|
|
|
Use the `ssh_config` InSpec audit resource to test OpenSSH client configuration data located at `/etc/ssh/ssh_config` on Linux and Unix platforms.
|
|
|
|
<br>
|
|
|
|
## Syntax
|
|
|
|
An `ssh_config` resource block declares the client OpenSSH configuration data to be tested:
|
|
|
|
describe ssh_config('path') do
|
|
its('name') { should include('foo') }
|
|
end
|
|
|
|
where
|
|
|
|
* `name` is a configuration setting in `ssh_config`
|
|
* `('path')` is the non-default `/path/to/ssh_config`
|
|
* `{ should include('foo') }` tests the value of `name` as read from `ssh_config` versus the value declared in the test
|
|
|
|
<br>
|
|
|
|
## Examples
|
|
|
|
The following examples show how to use this InSpec audit resource.
|
|
|
|
### Test SSH configuration settings
|
|
|
|
describe ssh_config do
|
|
its('cipher') { should contain '3des' }
|
|
its('port') { should eq '22' }
|
|
its('hostname') { should include('example.com') }
|
|
end
|
|
|
|
### Test which variables from the local environment are sent to the server
|
|
|
|
only_if do
|
|
command('sshd').exist? or command('ssh').exists?
|
|
end
|
|
|
|
describe ssh_config do
|
|
its('SendEnv') { should include('GORDON_CLIENT') }
|
|
end
|
|
|
|
### Test owner and group permissions
|
|
|
|
describe ssh_config do
|
|
its('owner') { should eq 'root' }
|
|
its('mode') { should cmp '0644' }
|
|
end
|
|
|
|
### Test SSH configuration
|
|
|
|
describe ssh_config do
|
|
its('Host') { should eq '*' }
|
|
its('Tunnel') { should eq nil }
|
|
its('SendEnv') { should eq 'LANG LC_*' }
|
|
its('HashKnownHosts') { should eq 'yes' }
|
|
end
|
|
|
|
<br>
|
|
|
|
## Matchers
|
|
|
|
This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
|
|
|
|
### name
|
|
|
|
The `name` matcher tests the value of `name` as read from `ssh_config` versus the value declared in the test:
|
|
|
|
its('name') { should eq 'foo' }
|
|
|
|
or:
|
|
|
|
its('name') { should include('bar') }
|