mitre / apache-tomcat-7-cis-baseline

(WIP) (ALPHA) InSpec Profile for the CIS Apache Tomcat v7 Benchmark

(WIP) apache-tomcat-7-cis-baseline

InSpec Profile to validate the secure configuration of apache-tomcat-7-cis-baseline, against CIS' Apache Tomcat 7 Benchmark

Getting Started

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 ssh.

The latest versions and installation options are available at the InSpec site.

Tailoring to Your Environment

The following inputs must be configured in an inputs ".yml" file for the profile to run correctly for your specific environment. More information about InSpec inputs can be found in the InSpec Profile Documentation.

# Description: Tomcat home Directory
tomcat_home: ''

# Description: Tomcat Directory for additional servers
tomcat_base: ''

# Description: Tomcat App Directory
tomcat_app_dir: ''

# Description: Tomcat library Directory
tomcat_lib_dir: ''

# Description: Tomcat service Name
tomcat_service_name: ''

# Description: Tomcat username
tomcat_user: ''

# Description: Port of the tomcat instance
tomcat_port: ''

# Description: Server Info value
tomcat_server_info: ''

# Description: Server Number value
tomcat_server_number: ''

# Description: Server Built value
tomcat_server_built: ''

# Description: Tomcat server configuration file
tomcat_conf_server: ''

# Description: Tomcat web configuration file
tomcat_conf_web: ''

# Description: Group owner of files/directories
tomcat_group: ''

# Description: User owner of files/directories
tomcat_owner: ''

# Description: A list of Realms that should not be enabled
tomcat_realms_list: []
                    
# Description: List of extraneous resources that should not exist
tomcat_extraneous_resource_list: []

Running This Baseline Directly from Github

# How to run
inspec exec https://github.com/mitre/apache-tomcat-7-cis-baseline/archive/master.tar.gz -t ssh:// --input-file=<path_to_your_inputs_file/name_of_your_inputs_file.yml> --reporter=cli json:<path_to_your_output_file/name_of_your_output_file.json>

Different Run Options

Full exec options

Running This Baseline from a local Archive copy

If your runner is not always expected to have direct access to GitHub, use the following steps to create an archive bundle of this baseline and all of its dependent tests:

(Git is required to clone the InSpec profile using the instructions below. Git can be downloaded from the Git site.)

When the "runner" host uses this profile baseline for the first time, follow these steps:

mkdir profiles
cd profiles
git clone https://github.com/mitre/apache-tomcat-7-cis-baseline
inspec archive apache-tomcat-7-cis-baseline
inspec exec <name of generated archive> -t ssh:// --input-file=<path_to_your_inputs_file/name_of_your_inputs_file.yml> --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 baseline:

cd apache-tomcat-7-cis-baseline
git pull
cd ..
inspec archive apache-tomcat-7-cis-baseline --overwrite
inspec exec <name of generated archive> -t ssh:// --input-file=<path_to_your_inputs_file/name_of_your_inputs_file.yml> --reporter=cli json:<path_to_your_output_file/name_of_your_output_file.json>

Viewing the JSON Results

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.

Authors

• Mohamed El-Sharkawi - HackerShark

Special Thanks

• Shivani Karikar - karikarshivani

Contributing and Getting Help

To report a bug or feature request, please open an issue.

NOTICE

© 2018-2020 The MITRE Corporation.

Approved for Public Release; Distribution Unlimited. Case Number 18-3678.

NOTICE

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.

NOTICE

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, [phone].

NOTICE

CIS Benchmarks are published by the Center for Internet Security (CIS), see: https://www.cisecurity.org/.

apache-tomcat-7-cis-baseline's Issues

File mode checks should also pass if mode is more restrictive

Several controls are performing a mode check on files using

its('mode') { should cmp '0750' }

This should to changed to cmp <= instead of just cmp, so that the control will still pass if the mode set is more restrictive.

The following controls are affected:

• M-4.1
• M-4.11
• M-4.12
• M-4.13
• M-4.14
• M-4.2
• M-4.3
• M-4.4
• M-4.5
• M-4.6
• M-4.7
• M-4.8
• M-4.9

M-8.1 has undefined method

Control M-8.1 fails with:

FAILED -- Test: Control Source Code Error controls/M-8.1.rb:35
Message: undefined method `tomcat_catalina_conf' for #<#:0x000000000514df20>

Many controls have an only_if for tomcat installed, which should also change control impact to 0.0

Many controls contain
only_if do
service(TOMCAT_SERVICE_NAME).installed?
end

If tomcat is not installed, all checks will be categorized as not reviewed. Instead they should be marked as Not applicable and their impact should be changed to 0.0.

M-10.6 has undefined method apache

Control M-10.6 fails with:

FAILED -- Test: Parse Config File /usr/share/tomcat/conf/catalina.properties org.apache.catalina.STRICT_SERVLET_COMPLIANCE
Message: undefined method `apache' for nil:NilClass

Maintenance

The gemfile has dependencies specified without semver

It is also marked as both WIP and ALPHA so what is still required before an actual release?

M-10.7 has undefined method

Control M-10.7 fails with:

One or more of the automated tests failed or was inconclusive for the control FAILED -- Test: Parse Config File /usr/share/tomcat/conf/catalina.properties org.apache.catalina.connector.RECYCLE_FACADES Message: undefined method `apache' for nil:NilClass

M-10.9 has undefined method

Control M-10.9 fails with:

One or more of the automated tests failed or was inconclusive for the control FAILED -- Test: Parse Config File /usr/share/tomcat/conf/catalina.properties org.apache.coyote.USE_CUSTOM_STATUS_MSG_IN_HEADER Message: undefined method `apache' for nil:NilClass

Run inspec check - several controls have no tests defined

The following controls have no tests defined

• M-6.4
• M-7.5
• M-7.1
• M-6.1
• M-6.5
• M-7.4
• M-6.2
• M-7.3
• M-7.7
• M-10.20
• M-7.6
• M-6.3
• M-7.2
• M-10.3
• M-2.4
• M-1.2
• M-2.5
• M-2.6