Sensor Mappings to ATT&CK is a collection of resources to assist cyber defenders with understanding which sensors and events can help detect real-world adversary behaviors in their environments.
Utilities for generating content from mappings data, such as Navigator layers, CSV files, etc.
src/util/create_mappings.py
Summary
This intakes the Excel sheet for the mappings, converts it to a DataFrame and standardizes the fields.
Adds the ATT&CK Data Source ID as a new field to the DataFrame using an ATT&CK spreadsheets
The DataFrame is split by Sensor and saved as CSVs which are used to generate STIX objects in generate_stix.py
src/parse/generate_stix.py
Summary
Utility script to generate and save STIX Bundles files from a corresponding CSV. The script creates custom STIX Objects when needed for:
Data Source
Data Component
Sensor Mapping
and saves all new SDOs and SROs to Reference-for-mappings-enterprise.json in order to avoid overwriting STIX IDs.
src/util/create_heatmap.py
Summary
Generates ATT&CK Navigator layers for the sensor from its STIX Bundle on disk. It builds out a layer for each Sensor Data Bundle on disk and consolidates all the techniques from all Sensor Navigator layers into a file called sensor-comparison-heatmap.json. The layers can be found in the layers folder of the attack type in the stix output folder.
parse/
util/
src/util/create_mappings.py
Summary
This intakes the Excel sheet for the mappings, converts it to a DataFrame and standardizes the fields. Adds the ATT&CK Data Source ID as a new field to the DataFrame using an ATT&CK spreadsheets The DataFrame is split by Sensor and saved as CSVs which are used to generate STIX objects in
generate_stix.py
src/parse/generate_stix.py
Summary
Utility script to generate and save STIX Bundles files from a corresponding CSV. The script creates custom STIX Objects when needed for:
Reference-for-mappings-enterprise.json
in order to avoid overwriting STIX IDs.src/util/create_heatmap.py
Summary
Generates ATT&CK Navigator layers for the sensor from its STIX Bundle on disk. It builds out a layer for each Sensor Data Bundle on disk and consolidates all the techniques from all Sensor Navigator layers into a file called
sensor-comparison-heatmap.json
. The layers can be found in thelayers
folder of the attack type in the stix output folder.Related Tickets
Resolves the tickets SMAP70 & SMAP-83