Skip to content

Commit dbe452a

Browse files
authored
Refactor default decision point values from collect.md to includable files (#1013)
2 parents bc0ce12 + 0980471 commit dbe452a

File tree

13 files changed

+39
-21
lines changed

13 files changed

+39
-21
lines changed
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
!!! tip "Default Exploitation Values"
2+
3+
[*Exploitation*](../reference/decision_points/exploitation.md) needs no special default; if adequate searches are made for exploit code and none is
4+
found, the answer is [*none*](../reference/decision_points/exploitation.md).
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
!!! tip "Default Mission Impact Values"
2+
3+
Similarly, with [*Mission Impact*](/reference/decision_points/mission_impact.md), the deployer should assume that the software is in use at the
4+
organization for a reason, and that it supports essential functions unless they have evidence otherwise.
5+
With a total lack of information, assume [*support crippled*](/reference/decision_points/mission_impact.md) as a default.
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
!!! tip "Default Safety Values"
2+
3+
If the decision maker knows nothing about the environment in which the device is used, we suggest assuming a
4+
[*marginal*](../reference/decision_points/safety_impact.md) [*Safety Impact*](../reference/decision_points/safety_impact.md).
5+
This position is conservative, but software is thoroughly embedded in daily life now, so we suggest that the decision
6+
maker provide evidence that no one's well-being will suffer.
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
!!! tip "Default System Exposure Values"
2+
3+
If the deployer does not know their exposure,<!--lowercase exposure on purpose, this is the general concept--> that
4+
means they do not know where the devices are or how they are controlled, so they should assume
5+
[*System Exposure*](../reference/decision_points/system_exposure.md) is [*open*](../reference/decision_points/system_exposure.md).

docs/howto/bootstrap/collect.md

Lines changed: 4 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -94,31 +94,15 @@ deployer may want to use that information to favor the latter.
9494
In the case where no information is available or the organization has not yet matured its initial situational analysis,
9595
we can suggest something like defaults for some decision points.
9696

97-
!!! tip "Default Exploitation Values"
97+
{% include-markdown "../../_includes/default_exploitation_values.md" %}
9898

99-
[*Exploitation*](../../reference/decision_points/exploitation.md) needs no special default; if adequate searches are made for exploit code and none is
100-
found, the answer is [*none*](../../reference/decision_points/exploitation.md).
101-
102-
!!! tip "Default System Exposure Values"
103-
104-
If the deployer does not know their exposure,<!--lowercase exposure on purpose, this is the general concept--> that
105-
means they do not know where the devices are or how they are controlled, so they should assume
106-
[*System Exposure*](../../reference/decision_points/system_exposure.md) is [*open*](../../reference/decision_points/system_exposure.md).
99+
{% include-markdown "../../_includes/default_system_exposure_values.md" %}
107100

108101
{% include-markdown "../../_includes/default_automatable_values.md" %}
109102

110-
!!! tip "Default Safety Values"
111-
112-
If the decision maker knows nothing about the environment in which the device is used, we suggest assuming a
113-
[*marginal*](../../reference/decision_points/safety_impact.md) [*Safety Impact*](../../reference/decision_points/safety_impact.md).
114-
This position is conservative, but software is thoroughly embedded in daily life now, so we suggest that the decision
115-
maker provide evidence that no one’s well-being will suffer.
116-
117-
!!! tip "Default Mission Impact Values"
103+
{% include-markdown "../../_includes/default_safety_values.md" %}
118104

119-
Similarly, with [*Mission Impact*](../../reference/decision_points/mission_impact.md), the deployer should assume that the software is in use at the
120-
organization for a reason, and that it supports essential functions unless they have evidence otherwise.
121-
With a total lack of information, assume [*support crippled*](../../reference/decision_points/mission_impact.md) as a default.
105+
{% include-markdown "../../_includes/default_mission_impact_values.md" %}
122106

123107
!!! example "Using Defaults"
124108

docs/howto/gathering_info/exploitation.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ from ssvc.doc_helpers import example_block
77
print(example_block(LATEST))
88
```
99

10+
{% include-markdown "../../_includes/default_exploitation_values.md" %}
11+
1012
## Public PoC
1113
[Historical Analysis of Exploit Availability Timelines](https://dl.acm.org/doi/10.5555/3485754.3485760) presents a method for searching the GitHub repositories of open-source exploit databases.
1214
This method could be employed to gather information about whether *PoC* is true.

docs/howto/gathering_info/mission_impact.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,3 +12,5 @@ At a minimum, understanding mission impact should include gathering information
1212
There are various sources of guidance on how to gather this information; see for example the FEMA guidance in [Continuity Directive 2](https://www.fema.gov/sites/default/files/2020-07/Federal_Continuity_Directive-2_June132017.pdf) or [OCTAVE FORTE](https://insights.sei.cmu.edu/insider-threat/2018/06/octave-forte-and-fair-connect-cyber-risk-practitioners-with-the-boardroom.html).
1313
This is part of risk management more broadly.
1414
It should require the vulnerability management team to interact with more senior management to understand mission priorities and other aspects of risk mitigation.
15+
16+
{% include-markdown "../../_includes/default_mission_impact_values.md" %}

docs/howto/gathering_info/system_exposure.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ from ssvc.doc_helpers import example_block
77
print(example_block(LATEST))
88
```
99

10+
{% include-markdown "../../_includes/default_system_exposure_values.md" %}
11+
1012
*System Exposure* is primarily used by [Deployers](../../deployer_tree), so the question is about whether some specific system is in fact exposed, not a hypothetical or aggregate question about systems of that type.
1113
Therefore, it generally has a concrete answer, even though it may vary from vulnerable component to vulnerable component, based on their respective configurations.
1214

docs/reference/decision_points/exploitation.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,8 @@ print(example_block(LATEST))
1111

1212
See this [HowTo](../../howto/gathering_info/exploitation.md) for advice on gathering information about the Exploitation decision point.
1313

14+
{% include-markdown "../../_includes/default_exploitation_values.md" %}
15+
1416
The intent of this measure is the present state of exploitation of the vulnerability. The intent is not to predict future exploitation but only to acknowledge the current state of affairs. Predictive systems, such as EPSS, could be used to augment this decision or to notify stakeholders of likely changes [@jacobs2021epss].
1517

1618
## CWE-IDs for *PoC*

docs/reference/decision_points/mission_impact.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,8 @@ print(example_block(LATEST))
1111

1212
See this [HowTo](../../howto/gathering_info/mission_impact.md) for advice on gathering information about the Mission Impact decision point.
1313

14+
{% include-markdown "../../_includes/default_mission_impact_values.md" %}
15+
1416
!!! tip "See also"
1517

1618
Mission Impact combines with [Safety Impact](./safety_impact.md) to inform

0 commit comments

Comments
 (0)