Skip to content
This repository has been archived by the owner on Jul 1, 2022. It is now read-only.

InSpec Reporter Plugin developed under the SAF to extend security testing capabilities for the SAF shared community. Initial feature: ability to address manual controls.

License

Notifications You must be signed in to change notification settings

mitre/inspec-reporter-json-hdf

Repository files navigation

This capability has moved to the SAF CLI. This reporter is now depercated.

Please use the SAF CLI Attest capability.

https://saf-cli.mitre.org/#attest

inspec-reporter-json-hdf

This InSpec Reporter Plugin is developed under the SAF to extend security testing capabilities for the SAF shared community.

Installation:

if using inspec:

inspec plugin install inspec-reporter-json-hdf

...or if using cinc-auditor:

cinc-auditor plugin install inspec-reporter-json-hdf

Features:

Manual Attestation

Sometimes requirements (i.e., "InSpec controls") in an InSpec profile require manual review, whereby someone interviews/examines the requirement and confirms (attests as to) whether or not the control requirements have been satisfied. These attestations can be provided to a profile as follows:

Getting Started:

Option 1:

Step 1: Simply add your attestations to a json file, such as "my_attestations.json". For example:

{
    "plugins": {
        "inspec-reporter-json-hdf": {
            "attestations": [
                {
		"control_id": "2.1",
		"explanation": "Discussed with team to ensure a dedicated machine is running this instance of MySQL.",
		"frequency": "annually",
		"status": "passed",
		"updated": "2022-01-02",
		"updated_by": "Json Smith, Security"
                },
                {
		"control_id": "2.4",
		"explanation": "Discussed with team to ensure that neither default nor shared cryptographic material is not being used.",
		"frequency": "every3days",
		"status": "passed",
		"updated": "2022-04-09",
		"updated_by": "Json Smith, Security"
                },
                {
		"control_id": "9.1",
		"explanation": "Reviewed deployment with team to ensure replication traffic is secured and found some connections non-secure.",
		"frequency": "quarterly",
		"status": "failed",
		"updated": "2022-04-02",
		"updated_by": "Json Smith, Security"
                }
		]
        }
    },
    "version": "1.2"
}

Step 2: Supply this attestations file using the "--config" flag and request the HDF reporter:

inspec exec <path to InSpec profile> --config <path/attestations_filename>.json --reporter hdf:<path/results_filename>.json 

for example:

inspec exec https://github.com/mitre/oracle-mysql-ee-5.7-cis-baseline/archive/master.tar.gz --config my_attestations.json --reporter hdf:my_results_with_attestations.json 

Before and after attestation:

image

Detailed Usage:

Attestations JSON template:

{
    "plugins": {
        "inspec-reporter-json-hdf": {
            "attestations": [
                {
		"control_id": "<InSpec Control ID>",
		"explanation": "<Attestation text explaining compliance or non-compliance>",
		"frequency": "<How often this review/attestation needs to be updated - Supported frequency choices:  annually, semiannually, quarterly, monthly, every2weeks, weekly, every3days, daily>",
		"status": "<assigned status based on review/attestation - Supported status value choices: passed, failed>",
		"updated": "<last date attestation was performed (in YYYY-MM-DD format) - e.g., 2021-04-12>",
		"updated_by": "<Name, Role of person performing attestation for this control>"
                },
                {
		"control_id": "<Another InSpec Control ID>",
		"explanation": "<Attestation text explaining compliance or non-compliance>",
		"frequency": "<How often this review/attestation needs to be updated - Supported frequency choices:  annually, semiannually, quarterly, monthly, every2weeks, weekly, every3days, daily>",
		"status": "<assigned status based on review/attestation - Supported status value choices: passed, failed>",
		"updated": "<last date attestation was performed (in YYYY-MM-DD format) - e.g., 2021-04-12>",
		"updated_by": "<Name, Role of person performing attestation for this control>"
                }
		]
        }
    },
    "version": "1.2"
}

Option 2 - Use an Excel Spreadsheet for your attestations!

Step 1: Add your attestations to an Excel Spreadsheet, such as "my_attestations.xlsx". For example:

image

Step 2: Include your attestations to your config json file, such as "my_attestations.json". For example:

{
    "plugins": {
        "inspec-reporter-json-hdf": {
	            "include-attestations-file": {
                "path": "my_attestations.xlsx",
                "type": "xlsx"
            }
        }
    },
    "version": "1.2"
}

Step 3: Again, supply this attestations file using the "--config" flag and request the HDF reporter:

inspec exec <path to InSpec profile> --config <path/attestations_filename>.json --reporter hdf:<path/results_filename>.json 

for example:

inspec exec https://github.com/mitre/oracle-mysql-ee-5.7-cis-baseline/archive/master.tar.gz --config my_attestations.json --reporter hdf:my_results_with_attestations.json 

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, (703) 983-6000.

About

InSpec Reporter Plugin developed under the SAF to extend security testing capabilities for the SAF shared community. Initial feature: ability to address manual controls.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages