attack flow & theory branch update

center-for-threat-informed-defense · Jun 19, 2024 · 5225cf4 · 5225cf4
1 parent 07d7a56
commit 5225cf4
Show file tree

Hide file tree

Showing 20 changed files with 38 additions and 92 deletions.
diff --git a/docs/_static/3.png b/docs/_static/3.png
diff --git a/docs/_static/evidencescoring.png b/docs/_static/evidencescoring.png
diff --git a/docs/_static/protection_layer.svg b/docs/_static/protection_layer.svg
diff --git a/docs/_static/question1graphic.png b/docs/_static/question1graphic.png
diff --git a/docs/_static/risklayer.svg b/docs/_static/risklayer.svg
diff --git a/docs/_static/scoringlayer.svg b/docs/_static/scoringlayer.svg
diff --git a/docs/_static/theory.svg b/docs/_static/theory.svg
diff --git a/docs/_static/theory_evidence.svg b/docs/_static/theory_evidence.svg
diff --git a/docs/_static/theoryevidencettps.png b/docs/_static/theoryevidencettps.png
diff --git a/docs/_static/theoryscoring.png b/docs/_static/theoryscoring.png
diff --git a/docs/additional-resources.rst b/docs/additional-resources.rst
@@ -1,3 +1,5 @@
+.. _Additional Resources:
+
 Additional Resources
 ====================
 
@@ -20,3 +22,13 @@ Leveraging existing CTI allows you to develop known attack vectors that could be
 *	When it comes to researching CTI for embedded systems, MITRE developed a publicly available knowledge base called `EMB3D <https://emb3d.mitre.org/properties-list/>`_. This is a great resource for both theory and evidence. Start by down selecting by embedded system property and read through the various threats to each.
 
 It is a good idea to have a central location/repository for all your CTI data. This can be a spreadsheet or a threat intelligence platform (TIP) like OpenCTI (see example data below for FIN7). There are many TIP out there that will do to research work for you – automatically pulling in the latest vender reports. Some TIPs will even auto-parse the data in reports for you. Be sure to spot check any automated report parsing for accuracy.
+
+Attack Flow
+-----------
+
+.. raw:: html
+
+     <iframe width="560" height="315" src="https://www.youtube.com/embed/h_BC6QMWDbA?si=Abpy35U4SYKMYUeE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
+
+|
diff --git a/docs/extra/layers/protection_layer.json b/docs/extra/layers/protection_layer.json
@@ -308,16 +308,6 @@
 			"metadata": [],
 			"links": [],
 			"showSubtechniques": false
-		},
-		{
-			"techniqueID": "T1059",
-			"tactic": "execution",
-			"color": "#bdbdbd",
-			"comment": "",
-			"enabled": true,
-			"metadata": [],
-			"links": [],
-			"showSubtechniques": false
 		}
 	],
 	"gradient": {

diff --git a/docs/extra/layers/risk_layer.json b/docs/extra/layers/risk_layer.json
@@ -320,17 +320,6 @@
 			"metadata": [],
 			"links": [],
 			"showSubtechniques": false
-		},
-		{
-			"techniqueID": "T1059",
-			"tactic": "execution",
-			"score": 3,
-			"color": "",
-			"comment": "",
-			"enabled": true,
-			"metadata": [],
-			"links": [],
-			"showSubtechniques": false
 		}
 	],
 	"gradient": {

diff --git a/docs/extra/layers/scoring_layer.json b/docs/extra/layers/scoring_layer.json
@@ -57,17 +57,6 @@
 			"links": [],
 			"showSubtechniques": false
 		},
-		{
-			"techniqueID": "T1059",
-			"tactic": "execution",
-			"score": 3,
-			"color": "",
-			"comment": "",
-			"enabled": true,
-			"metadata": [],
-			"links": [],
-			"showSubtechniques": false
-		},
 		{
 			"techniqueID": "T1528",
 			"tactic": "credential-access",

diff --git a/docs/extra/layers/theory.json b/docs/extra/layers/theory.json
@@ -294,16 +294,6 @@
 			"links": [],
 			"showSubtechniques": false
 		},
-		{
-			"techniqueID": "T1134",
-			"tactic": "privilege-escalation",
-			"color": "#9e9ac8",
-			"comment": "",
-			"enabled": true,
-			"metadata": [],
-			"links": [],
-			"showSubtechniques": false
-		},
 		{
 			"techniqueID": "T1111",
 			"tactic": "credential-access",
@@ -344,16 +334,6 @@
 			"links": [],
 			"showSubtechniques": false
 		},
-		{
-			"techniqueID": "T1059",
-			"tactic": "execution",
-			"color": "#9e9ac8",
-			"comment": "",
-			"enabled": true,
-			"metadata": [],
-			"links": [],
-			"showSubtechniques": false
-		},
 		{
 			"techniqueID": "T1059.001",
 			"tactic": "execution",

diff --git a/docs/extra/layers/theory_+_evidence.json b/docs/extra/layers/theory_+_evidence.json
@@ -294,16 +294,6 @@
 			"links": [],
 			"showSubtechniques": false
 		},
-		{
-			"techniqueID": "T1134",
-			"tactic": "privilege-escalation",
-			"color": "#9e9ac8",
-			"comment": "",
-			"enabled": true,
-			"metadata": [],
-			"links": [],
-			"showSubtechniques": false
-		},
 		{
 			"techniqueID": "T1111",
 			"tactic": "credential-access",
@@ -344,16 +334,6 @@
 			"links": [],
 			"showSubtechniques": false
 		},
-		{
-			"techniqueID": "T1059",
-			"tactic": "execution",
-			"color": "#969696",
-			"comment": "",
-			"enabled": true,
-			"metadata": [],
-			"links": [],
-			"showSubtechniques": false
-		},
 		{
 			"techniqueID": "T1059.001",
 			"tactic": "execution",

diff --git a/docs/index.rst b/docs/index.rst
@@ -10,10 +10,12 @@ Threat Modeling with ATT&CK |version|
 
 Threat Modeling with ATT&CK provides a recommended approach that integrates the common language that security operations teams rely upon - `MITRE ATT&CK® <https://attack.mitre.org/>`_ - into their organization’s threat modeling practices. Creating an approach to threat modeling that integrates ATT&CK enables cyber defenders to focus on the activity of threat modeling with a clear, consistent understanding of adversary behaviors and tailor defensive investments to mitigate threats related to their systems or environments.
 At the core of this approach are four key questions, outlined in the `Threat Modeling Manifesto <https://www.threatmodelingmanifesto.org/>`_, that we need to answer:
-Question 1: What are we working on?
-Question 2: What could go wrong?
-Question 3: What are we going to do about it?
-Question 4: Did we do a good job?
+
+* Question 1: What are we working on?
+* Question 2: What could go wrong?
+* Question 3: What are we going to do about it?
+* Question 4: Did we do a good job?
+
 This project is created and maintained by `MITRE Engenuity Center for Threat-Informed Defense (Center) <https://ctid.mitre-engenuity.org/>`_ and is funded by our `research participants <https://mitre-engenuity.org/cybersecurity/center-for-threat-informed-defense/our-work/threat-modeling-with-attack/>`_, in furtherance of our mission to advance the state of the art and the state of the practice in threat-informed defense globally. This work builds upon The MITRE Corporation’s `Playbook for Threat Modeling Medical Devices <https://www.mitre.org/sites/default/files/2021-11/Playbook-for-Threat-Modeling-Medical-Devices.pdf>`_ by applying this integrated threat modeling approach to the fictional medical device created under that project.
 
 .. toctree::

diff --git a/docs/introduction.rst b/docs/introduction.rst
@@ -7,7 +7,7 @@ Introduction
 
     Threat Modeling with ATT&CK Overview (Click to Enlarge)
 
-The process outlined in this project details an approach developed by MITRE Engenuity’s Center for Threat-Informed Defense (hereafter, the Center) for integrating MITRE ATT&CK® into your organization’s existing threat modeling methodology.
+The process outlined in this project details an approach developed by `MITRE Engenuity’s Center for Threat-Informed Defense <https://mitre-engenuity.org/cybersecurity/center-for-threat-informed-defense/our-work/>`_ (hereafter, the Center) for integrating `MITRE ATT&CK® <https://attack.mitre.org/>`_ into your organization’s existing threat modeling methodology.
 At the core of this approach are four key questions, outlined in the `Threat Modeling Manifesto <https://www.threatmodelingmanifesto.org/>`_, that we need to answer:
 
 * Question 1: What are we working on?

diff --git a/docs/question-1.rst b/docs/question-1.rst
@@ -5,7 +5,7 @@ Question 1: What are we working on?
 
 .. figure:: /_static/question1graphic.png
   :alt: Question 1 Overview
-  :scale: 30%
+  :scale: 20%
   :align: center
 
   Question 1 Overview Graphic (Click to Enlarge)
@@ -84,7 +84,7 @@ As a security team evaluating AMPS for its manufacturer, we identified that a co
 
 .. figure:: /_static/3.png
   :alt: Mission/System Decomposition Graphic
-  :scale: 50%
+  :scale: 20%
   :align: right
 
 Step 2: Identify Operational Tasks (Cross Functional Flow Chart)
@@ -100,7 +100,7 @@ Next, leverage the knowledge pooled from stakeholders to determine the different
 
 Part 3: System Decomposition
 ----------------------------
-Step 3: Develop a Data Flow Diagram (DFD) of your system.
+Step 1: Develop a Data Flow Diagram (DFD) of your system.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 There are multiple ways to design a DFD, but we recommend the `DFD3 <https://github.com/adamshostack/DFD3>`_ standard. Begin by answering the following questions:
 
@@ -124,7 +124,7 @@ From these questions, start to draw your diagram and gradually add additional co
 
   Mid-level DFD with Trust Boundaries (Click to Enlarge)
 
-Step 4: Determine which system functions are associated with distinct operational tasks.
+Step 2: Determine which system functions are associated with distinct operational tasks.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 With the DFD of your system in hand, you can then link the system’s operational tasks to specific system functions. When executing a specific task, what parts of the system are utilized? These include both assets and data flows between systems.
 

diff --git a/docs/question-2.rst b/docs/question-2.rst
@@ -94,7 +94,7 @@ Using our knowledge of the system we codified responding to Question 1, we now n
 Visualizing attack trees
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
-To visualize these attack trees, we used (and recommend using) MITRE Engenuity’s Attack Flow Builder (see below), but there are several other simple and complex tools you can use to build your attack trees. The easiest approach is to use a common tool like Microsoft Word or PowerPoint. The graphic design tool Canva is another great, easy-to-use option (any graphic design software can work as well). For more formal tools capable of complex analysis, there are a few options:
+To visualize these attack trees, we used (and recommend using) `MITRE Engenuity’s Attack Flow Builder <https://center-for-threat-informed-defense.github.io/attack-flow/>`_, but there are several other simple and complex tools you can use to build your attack trees. The easiest approach is to use a common tool like Microsoft Word or PowerPoint. The graphic design tool Canva is another great, easy-to-use option (any graphic design software can work as well). For more formal tools capable of complex analysis, there are a few options:
 
 * `SecurITree <https://www.amenaza.com/attack-tree-tool.php>`_, developed by Amenaza Technologies, is purpose-built for attack tree analyses and allows for the addition of detailed attributes to different attack paths, risk metrics, and adversary personas.
 * The `AT-AT <https://github.com/yathuvaran/AT-AT>`_ (Attack Tree Analysis Tool) allows users to develop and analyze attack scenarios in much the same way.
@@ -161,7 +161,7 @@ Below is an example of how a theoretical attack can be aligned with a TTP (Brows
 
 During our search for threats relevant to the AMPS device, we determined that one of the vectors (branch of the tree) an attacker could use to access user location data was by accessing their web portal. We determined that one potential vector for gaining access to the user’s portal was by stealing their log-in credentials. This can be done using an activity characterized as Session Hijacking in ATT&CK.
 
-Ultimately, we will be integrating these threats into a singular tree using the Center’s Attack Flow tool and directly linking them to our critical assets. Attack Flow integrates seamlessly with ATT&CK. Threat actor actions represented as nodes on the tree can be linked to specific TTPs. Furthermore, additional contextual elements such as attack characteristics, assets, data types, conditions, and references can be added to each node of the tree. With Browser Session Hijacking (T1185) identified as one of our theoretical exploits, we can now associate that specific node on the tree with T1185, thereby pulling in all the data that’s been associated with that exploit. Not all the threats you identify will be directly tied to TTPs, but these threats should still be included in your tree and will still inform the response you develop in Question 3.
+Ultimately, we will be integrating these threats into a singular tree using the Center’s Attack Flow tool and directly linking them to our critical assets. Attack Flow integrates seamlessly with ATT&CK. A Threat actor actions represented as nodes on the tree can be linked to specific TTPs. Furthermore, additional contextual elements such as attack characteristics, assets, data types, conditions, and references can be added to each node of the tree. With Browser Session Hijacking (T1185) identified as one of our theoretical exploits, we can now associate that specific node on the tree with T1185, thereby pulling in all the data that’s been associated with that exploit. Not all the threats you identify will be directly tied to TTPs, but these threats should still be included in your tree and will still inform the response you develop in Question 3.
 
 An example of the AMPS attack tree and all associated TTPs can be found below.
 
@@ -172,6 +172,8 @@ An example of the AMPS attack tree and all associated TTPs can be found below.
 
     Example AMPS Attack Tree Converted into Attack Flow
 
+For more information on the Attack Flow Builder, review the :ref:`Additional Resources` page. There you'll find a more detailed walkthrough of the Builder and its attack tree modeling capabilities.
+
 Evidence
 ---------
 
@@ -532,8 +534,8 @@ The following table summarizes the TTPs identified during the Theory and Evidenc
 
 .. figure:: /_static/theoryevidencettps.png
     :alt: Evidence and Theory TTPs Table
-    :scale: 40%
-    :align: right
+    :scale: 25%
+    :align: center
 
     Evidence and Theory TTPs Table
 
@@ -552,7 +554,7 @@ To keep the rest of this example concise, we have elected to only score the TTPs
 
 .. figure:: /_static/theoryscoring.png
     :alt: Theory Scoring Table
-    :scale: 30%
+    :scale: 25%
     :align: center
 
     Theory Scoring Table
@@ -579,7 +581,7 @@ Some notes on the above:
 
 .. figure:: /_static/evidencescoring.png
     :alt: Evidence Scoring Table
-    :scale: 40%
+    :scale: 25%
     :align: center
 
     Evidence Scoring Table