From 1de88b324e786b83d1c719dc239e676ed4d2cc99 Mon Sep 17 00:00:00 2001 From: "Mark E. Haase" Date: Wed, 31 Jul 2024 14:51:03 -0400 Subject: [PATCH] Fix build errors --- .github/workflows/delete-web-preview.yml | 2 +- docs/architecture.rst | 12 ++++++++---- docs/index.rst | 19 ++++++++++--------- make/sphinx.mk | 3 +-- 4 files changed, 20 insertions(+), 16 deletions(-) diff --git a/.github/workflows/delete-web-preview.yml b/.github/workflows/delete-web-preview.yml index a039e79..6532b92 100644 --- a/.github/workflows/delete-web-preview.yml +++ b/.github/workflows/delete-web-preview.yml @@ -14,7 +14,7 @@ jobs: azure_blob: runs-on: ubuntu-latest env: - AZURE_STORAGE_ACCOUNT: {{ cookiecutter.storage_account }} + AZURE_STORAGE_ACCOUNT: defendingotwithattack AZURE_STORAGE_SAS_TOKEN: ${{ secrets.AZURE_SAS_TOKEN }} BRANCH_NAME: ${{ github.head_ref || github.ref_name }} steps: diff --git a/docs/architecture.rst b/docs/architecture.rst index 17cc7fc..cee91eb 100644 --- a/docs/architecture.rst +++ b/docs/architecture.rst @@ -12,7 +12,7 @@ systems. .. figure:: ./_static/ref_arch.png :align: center - :scale: 80% + :scale: 25% Reference Architecture (click to enlarge) @@ -53,8 +53,12 @@ Impacting ICS Understanding impact to assets, particulary in context of ICS and application of ATT&CK in IT and OT environments -The below table provides descriptions for each of the 21 identified Defending OT with ATT&CK Architecture Assets. All assets were mapped to -ATT&CK for Enterprise's platforms and/or ATT&CK for ICS' assets. There were nine assets where ATT&CK for Enterprise and ATT&CK for ICS overlap: +.. _asset-table: + +The below table provides descriptions for each of the 21 identified Defending OT with +ATT&CK Architecture Assets. All assets were mapped to ATT&CK for Enterprise's platforms +and/or ATT&CK for ICS' assets. There were nine assets where ATT&CK for Enterprise and +ATT&CK for ICS overlap: +--------------------------------------+---------------------------------------------------------------------------------------------------+ + Asset Name + Description + @@ -171,4 +175,4 @@ ATT&CK for Enterprise's platforms and/or ATT&CK for ICS' assets. There were nine + + networks together by encapsulating all data between those networks. VPN servers typically support + + + remote network services that are used by field VPNs to initiate the establishment of the secure + + + VPN tunnel between the field device and server. + -+--------------------------------------+---------------------------------------------------------------------------------------------------+ \ No newline at end of file ++--------------------------------------+---------------------------------------------------------------------------------------------------+ diff --git a/docs/index.rst b/docs/index.rst index 7720451..e3e7a10 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,26 +1,27 @@ Defending Operational Technology (OT) with ATT&CK ================================================= -Defending OT with ATT&CK provides a customized collection of `MITRE ATT&CK® `_ techniques -tailored to the attack surface and threat model for OT environments. The collection of +Defending OT with ATT&CK provides a customized collection of `MITRE ATT&CK® `_ techniques +tailored to the attack surface and threat model for OT environments. The collection of threats contained in the ATT&CK knowledgebase, including historical attacks against OT, -are used to define a reference architecture and technology domains of interest for OT. -The resultant collection can be used by organizations that use OT to evaluate and employ +are used to define a reference architecture and technology domains of interest for OT. +The resultant collection can be used by organizations that use OT to evaluate and employ security controls for real-world adversary behaviors. This project is created and maintained by `MITRE Engenuity Center for Threat-Informed Defense (Center) `_ -and is funded by our research participants, in futherance 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 -Center's `Defending IaaS with ATT&CK `_ project by +and is funded by our research participants, in futherance 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 +Center's `Defending IaaS with ATT&CK `_ project by using the methodology and tooling created under that project as a basis, and provides another collection -of resources cyber defenders can use to understand and make threat-informed decisions for techniques that -could be used within an IT/OT hybrid architecture and environment. +of resources cyber defenders can use to understand and make threat-informed decisions for techniques that +could be used within an IT/OT hybrid architecture and environment. .. image:: _static/defending-ot.jpg :align: center :scale: 50% | + .. toctree:: :maxdepth: 2 :caption: Contents diff --git a/make/sphinx.mk b/make/sphinx.mk index d70e4d1..0ce40e0 100644 --- a/make/sphinx.mk +++ b/make/sphinx.mk @@ -1,5 +1,5 @@ SOURCEDIR = docs/ -BUILDDIR = docs/_build/ +BUILDDIR = docs/_build .PHONY: docs docs-html docs-pdf @@ -18,4 +18,3 @@ docs-pdf: ## Generate PDF documentation. docs-server: ## Run server for local editing of docs. sphinx-autobuild -b dirhtml -a "$(SOURCEDIR)" "$(BUILDDIR)" -sphinx-build -M dirhtml "docs/" "docs/_build/" -W --keep-going \ No newline at end of file