mirror of
https://github.com/inspec/inspec
synced 2024-11-30 16:39:20 +00:00
9cfc86d2ab
Light formatting changes, change order of example and matchers, slight color changes Signed-off-by: hannah-radish <hmaddy@chef.io>
78 lines
1.9 KiB
Text
78 lines
1.9 KiB
Text
---
|
|
title: The Nginx Resource
|
|
---
|
|
|
|
# nginx
|
|
|
|
Use the `nginx` InSpec audit resource to test the fields and validity of nginx.
|
|
|
|
Nginx resource extracts and exposes data reported by the command 'nginx -V'
|
|
|
|
<br>
|
|
|
|
## Syntax
|
|
|
|
An `nginx` InSpec audit resource block extracts configuration settings that should be tested:
|
|
|
|
describe nginx do
|
|
its('attribute') { should eq 'value' }
|
|
end
|
|
|
|
describe nginx('path to nginx') do
|
|
its('attribute') { should eq 'value' }
|
|
end
|
|
|
|
where
|
|
|
|
* `'attribute'` is a configuration parsed from result of the command 'nginx -V'
|
|
* `'value'` is the value that is expected of the attribute
|
|
|
|
<br>
|
|
|
|
## Supported Properties
|
|
|
|
* 'compiler_info', 'error_log_path', 'http_client_body_temp_path', 'http_fastcgi_temp_path', 'http_log_path', 'http_proxy_temp_path', 'http_scgi_temp_path', 'http_uwsgi_temp_path', 'lock_path', 'modules', 'modules_path', 'openssl_version', 'prefix', 'sbin_path', 'service', 'support_info', 'version'
|
|
|
|
<br>
|
|
|
|
## Property Examples and Return Types
|
|
|
|
### version(String)
|
|
|
|
`version` returns a string of the version of the running nginx instance
|
|
|
|
describe nginx do
|
|
its('version') { should eq '1.12.0' }
|
|
end
|
|
|
|
### modules(String)
|
|
|
|
`modules` returns a array modules in the running nginx instance
|
|
|
|
describe nginx do
|
|
its('modules') { should include 'my_module' }
|
|
end
|
|
|
|
### openssl_version(Hash)
|
|
|
|
`openssl_version ` returns a hash with 'version' and 'date' as keys
|
|
|
|
describe nginx do
|
|
its('openssl_version.date') { should eq '11 Feb 2013' }
|
|
end
|
|
|
|
### compiler_info(Hash)
|
|
|
|
`compiler_info ` returns a hash with 'compiler' , version' and 'date' as keys
|
|
|
|
describe nginx do
|
|
its('compiler_info.compiler') { should eq 'gcc' }
|
|
end
|
|
|
|
### support_info(String)
|
|
|
|
`support_info ` returns a string containing supported protocols
|
|
|
|
describe nginx do
|
|
its('support_info') { should match /TLS/ }
|
|
end
|