Examples: microsoft-iis-8.5-site-stig-baseline (specific version)
apache-tomcat-7-cis-baseline (7.x)
rsa-archer-6-baseline (6.x)
microsoft-azure-cis-foundations-baseline
InSpec Profile to validate the secure configuration of vendor product-version-edition, against the <DISA/CIS/vendor>'s <CIS Benchmark|DISA STIG, etc.> version <x.y.z>.
It is intended and recommended that InSpec run this profile from a "runner" host (such as a DevOps orchestration server, an administrative management system, or a developer's workstation/laptop) against the target remotely over <transport_protocol>.
For the best security of the runner, always install on the runner the latest version of InSpec and supporting Ruby language components.
Latest versions and installation options are available at the InSpec site.
Git is required to download the latest InSpec profiles using the instructions below. Git can be downloaded from the Git site.
START-OPTIONAL-ATTRIBUTES-TEXT
The following attributes must be configured in an attributes file for the profile to run correctly. More information about InSpec attributes can be found in the InSpec Profile Documentation.
# Attribute description
attribute_name: 'value'
END-OPTIONAL-ATTRIBUTES-TEXT
When the "runner" host uses this profile overlay for the first time, follow these steps:
mkdir profiles
cd profiles
git clone https://<baseline_repo>.git
cd vendor-product-version-edition[-stig|cis-]-baseline
bundle install
cd ..
inspec exec vendor-product-version-edition[-stig|cis-]-baseline --attrs=<path_to_your_attributes_file/name_of_your_attributes_file.yml> [-t <transport_protocol>://<hostname>:<port> --user=<username> --password=<password>] --reporter=cli json:<path_to_your_output_file/name_of_your_output_file.json>
For every successive run, follow these steps to always have the latest version of this profile:
cd profiles/<baseline_repo>
git pull
cd ..
inspec exec vendor-product-version-edition[-stig|cis-]-baseline --attrs=<path_to_your_attributes_file/name_of_your_attributes_file.yml> [-t <transport_protocol>://<hostname>:<port> --user=<username> --password=<password>] --reporter=cli json:<path_to_your_output_file/name_of_your_output_file.json>
The JSON results output file can be loaded into heimdall-lite for a user-interactive, graphical view of the InSpec results.
The JSON InSpec results file may also be loaded into a full heimdall server, allowing for additional functionality such as to store and compare multiple profile runs.
To report a bug or feature request, please open an issue.
- author_1
- author_2
- person_1
- person_2
This project is licensed under the terms of the Apache 2.0 license excepted as noted in LICENSE.MD.
© 2019 The MITRE Corporation.
Approved for Public Release; Distribution Unlimited. Case Number 18-3678.
MITRE hereby grants express written permission to use, reproduce, distribute, modify, and otherwise leverage this software to the extent permitted by the licensed terms provided in the LICENSE.md file included with this project.
This software was produced for the U. S. Government under Contract Number HHSM-500-2012-00008I, and is subject to Federal Acquisition Regulation Clause 52.227-14, Rights in Data-General.
No other use other than that granted to the U. S. Government, or to those acting on behalf of the U. S. Government under that Clause is authorized without the express written permission of The MITRE Corporation.
For further information, please contact The MITRE Corporation, Contracts Management Office, 7515 Colshire Drive, McLean, VA 22102-7539, (703) 983-6000.
< DISA STIGs | CIS Benchmarks > are published by < DISA IASE | the Center for Internet Security (CIS) >, see: < https://iase.disa.mil/Pages/privacy_policy.aspx | https://www.cisecurity.org/ >.