mirror of
https://github.com/inspec/inspec
synced 2024-11-23 13:13:22 +00:00
9cfc86d2ab
Light formatting changes, change order of example and matchers, slight color changes Signed-off-by: hannah-radish <hmaddy@chef.io>
46 lines
1.5 KiB
Text
46 lines
1.5 KiB
Text
---
|
|
title: About the audit_policy Resource
|
|
---
|
|
|
|
# audit_policy
|
|
|
|
Use the `audit_policy` Inspec audit resource to test auditing policies on the Windows platform. An auditing policy is a category of security-related events to be audited. Auditing is disabled by default and may be enabled for categories like account management, logon events, policy changes, process tracking, privilege use, system events, or object access. For each auditing category property that is enabled, the auditing level may be set to `No Auditing`, `Not Specified`, `Success`, `Success and Failure`, or `Failure`.
|
|
|
|
<br>
|
|
|
|
## Syntax
|
|
|
|
An `audit_policy` resource block declares a parameter that belongs to an audit policy category or subcategory:
|
|
|
|
describe audit_policy do
|
|
its('parameter') { should eq 'value' }
|
|
end
|
|
|
|
where
|
|
|
|
* `'parameter'` must specify a parameter
|
|
* `'value'` must be one of `No Auditing`, `Not Specified`, `Success`, `Success and Failure`, or `Failure`
|
|
|
|
<br>
|
|
|
|
## Examples
|
|
|
|
The following examples show how to use this InSpec audit resource.
|
|
|
|
### Test that a parameter is not set to "No Auditing"
|
|
|
|
describe audit_policy do
|
|
its('Other Account Logon Events') { should_not eq 'No Auditing' }
|
|
end
|
|
|
|
### Test that a parameter is set to "Success"
|
|
|
|
describe audit_policy do
|
|
its('User Account Management') { should eq 'Success' }
|
|
end
|
|
|
|
<br>
|
|
|
|
## Matchers
|
|
|
|
For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
|