oxbrbtx/PrimAITE
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

#2837 - Minor structure reshuffle to address confusion around the listen_on_ports variable [skip ci]

Browse Source
This commit is contained in:
Charlie Crane
2024-09-04 20:46:35 +01:00
parent 16e0df5cfc
commit ba737c57a8
18 changed files with 49 additions and 100 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
docs/source/simulation_components/system/applications/c2_suite.rst
View File

@@ -254,6 +254,9 @@ Via Configuration
C2 Beacon Configuration C2 Beacon Configuration
======================= =======================
``Common Configuration``
""""""""""""""""""""""""
.. include:: ../common/common_configuration.rst .. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: C2Beacon .. |SOFTWARE_NAME| replace:: C2Beacon
@@ -311,9 +314,3 @@ C2 Server Configuration
======================= =======================
*The C2 Server does not currently offer any unique configuration options and will configure itself to match the C2 beacon's network behaviour.* *The C2 Server does not currently offer any unique configuration options and will configure itself to match the C2 beacon's network behaviour.*
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: C2Server
.. |SOFTWARE_NAME_BACKTICK| replace:: ``C2Server``

4
docs/source/simulation_components/system/applications/data_manipulation_bot.rst
View File

@@ -158,10 +158,6 @@ If not using the data manipulation bot manually, it needs to be used with a data
Configuration Configuration
============= =============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: DataManipulationBot
.. |SOFTWARE_NAME_BACKTICK| replace:: ``DataManipulationBot``
``server_ip`` ``server_ip``
""""""""""""" """""""""""""

5
docs/source/simulation_components/system/applications/database_client.rst
View File

@@ -90,11 +90,6 @@ Via Configuration
Configuration Configuration
============= =============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: DatabaseClient
.. |SOFTWARE_NAME_BACKTICK| replace:: ``DatabaseClient``
``db_server_ip`` ``db_server_ip``
"""""""""""""""" """"""""""""""""

3
docs/source/simulation_components/system/applications/dos_bot.rst
View File

@@ -98,6 +98,9 @@ Via Configuration
Configuration Configuration
============= =============
``Common Configuration``
""""""""""""""""""""""""
.. include:: ../common/common_configuration.rst .. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: DoSBot .. |SOFTWARE_NAME| replace:: DoSBot

8
docs/source/simulation_components/system/applications/nmap.rst
View File

@@ -346,10 +346,8 @@ Perform a full box scan on all ports, over both TCP and UDP, on a whole subnet:
| 192.168.1.13 | 219 | ARP | UDP | | 192.168.1.13 | 219 | ARP | UDP |
+--------------+------+-----------------+----------+ +--------------+------+-----------------+----------+
Configuration
=============
.. include:: ../common/common_configuration.rst ``Common Attributes``
"""""""""""""""""""""
.. |SOFTWARE_NAME| replace:: NMAP See :ref:`Common Configuration`
.. |SOFTWARE_NAME_BACKTICK| replace:: ``NMAP``

4
docs/source/simulation_components/system/applications/ransomware_script.rst
View File

@@ -72,10 +72,6 @@ Configuration
The RansomwareScript inherits configuration options such as ``fix_duration`` from its parent class. However, for the ``RansomwareScript`` the most relevant option is ``server_ip``. The RansomwareScript inherits configuration options such as ``fix_duration`` from its parent class. However, for the ``RansomwareScript`` the most relevant option is ``server_ip``.
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: RansomwareScript
.. |SOFTWARE_NAME_BACKTICK| replace:: ``RansomwareScript``
``server_ip`` ``server_ip``
""""""""""""" """""""""""""

4
docs/source/simulation_components/system/applications/web_browser.rst
View File

@@ -92,10 +92,6 @@ Via Configuration
Configuration Configuration
============= =============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: WebBrowser
.. |SOFTWARE_NAME_BACKTICK| replace:: ``WebBrowser``
``target_url`` ``target_url``
"""""""""""""" """"""""""""""

42
docs/source/simulation_components/system/common/common_configuration.rst
View File

@@ -2,35 +2,38 @@
© Crown-owned copyright 2024, Defence Science and Technology Laboratory UK © Crown-owned copyright 2024, Defence Science and Technology Laboratory UK
``ref`` .. _Common Configuration:
=======
Human readable name used as reference for the |SOFTWARE_NAME_BACKTICK|. Not used in code. Common Configuration
--------------------
``type`` ref
======== """
The type of software that should be added. To add |SOFTWARE_NAME| this must be |SOFTWARE_NAME_BACKTICK|. Human readable name used as reference for the software class. Not used in code.
``options`` type
=========== """"
The type of software that should be added. To add the required software, this must be it's name.
options
"""""""
The configuration options are the attributes that fall under the options for an application. The configuration options are the attributes that fall under the options for an application.
fix_duration
""""""""""""
``fix_duration``
""""""""""""""""
Optional. Default value is ``2``. Optional. Default value is ``2``.
The number of timesteps the |SOFTWARE_NAME| will remain in a ``FIXING`` state before going into a ``GOOD`` state. The number of timesteps the software will remain in a ``FIXING`` state before going into a ``GOOD`` state.
``listen_on_ports`` listen_on_ports
""""""""""""""""""" ^^^^^^^^^^^^^^^
The set of ports to listen on. This is in addition to the main port the software is designated. This can either be Optional. The set of ports to listen on. This is in addition to the main port the software is designated. This can either be
the string name of ports or the port integers the string name of ports or the port integers
Example: Example:
@@ -40,11 +43,8 @@ Example:
simulation: simulation:
network: network:
nodes: nodes:
- hostname: client - hostname: [hostname]
type: computer type: [Node Type]
ip_address: 192.168.10.11
subnet_mask: 255.255.255.0
default_gateway: 192.168.10.1
services: services:
- type: [Service Type] - type: [Service Type]
options: options:

10
docs/source/simulation_components/system/services/database_service.rst
View File

@@ -94,11 +94,6 @@ Via Configuration
Configuration Configuration
============= =============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: DatabaseService
.. |SOFTWARE_NAME_BACKTICK| replace:: ``DatabaseService``
``backup_server_ip`` ``backup_server_ip``
"""""""""""""""""""" """"""""""""""""""""
@@ -114,3 +109,8 @@ This must be a valid octet i.e. in the range of ``0.0.0.0`` and ``255.255.255.25
Optional. Default value is ``None``. Optional. Default value is ``None``.
The password that needs to be provided by connecting clients in order to create a successful connection. The password that needs to be provided by connecting clients in order to create a successful connection.
``Common Configuration``
""""""""""""""""""""""""
Common configuration variables are detailed within :ref:`software`

4
docs/source/simulation_components/system/services/dns_client.rst
View File

@@ -84,10 +84,6 @@ Via Configuration
Configuration Configuration
============= =============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: DNSClient
.. |SOFTWARE_NAME_BACKTICK| replace:: ``DNSClient``
``dns_server`` ``dns_server``
"""""""""""""" """"""""""""""

8
docs/source/simulation_components/system/services/dns_server.rst
View File

@@ -83,13 +83,9 @@ Via Configuration
Configuration Configuration
============= =============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: DNSServer ``domain_mapping``
.. |SOFTWARE_NAME_BACKTICK| replace:: ``DNSServer`` """"""""""""""""""
domain_mapping
""""""""""""""
Domain mapping takes the domain and IP Addresses as a key-value pairs i.e. Domain mapping takes the domain and IP Addresses as a key-value pairs i.e.

5
docs/source/simulation_components/system/services/ftp_client.rst
View File

@@ -82,8 +82,3 @@ Via Configuration
Configuration Configuration
============= =============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: FTPClient
.. |SOFTWARE_NAME_BACKTICK| replace:: ``FTPClient``

5
docs/source/simulation_components/system/services/ftp_server.rst
View File

@@ -81,11 +81,6 @@ Via Configuration
Configuration Configuration
============= =============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: FTPServer
.. |SOFTWARE_NAME_BACKTICK| replace:: ``FTPServer``
``server_password`` ``server_password``
""""""""""""""""""" """""""""""""""""""

5
docs/source/simulation_components/system/services/ntp_client.rst
View File

@@ -80,11 +80,6 @@ Via Configuration
Configuration Configuration
============= =============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: NTPClient
.. |SOFTWARE_NAME_BACKTICK| replace:: ``NTPClient``
``ntp_server_ip`` ``ntp_server_ip``
""""""""""""""""" """""""""""""""""

8
docs/source/simulation_components/system/services/ntp_server.rst
View File

@@ -74,11 +74,3 @@ Via Configuration
services: services:
- ref: ntp_server - ref: ntp_server
type: NTPServer type: NTPServer
Configuration
=============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: NTPServer
.. |SOFTWARE_NAME_BACKTICK| replace:: ``NTPServer``

8
docs/source/simulation_components/system/services/terminal.rst
View File

@@ -173,11 +173,3 @@ Disconnect from Remote Node
term_a_term_b_remote_connection: RemoteTerminalConnection = terminal_a.login(username="admin", password="Admin123!", ip_address="192.168.0.11") term_a_term_b_remote_connection: RemoteTerminalConnection = terminal_a.login(username="admin", password="Admin123!", ip_address="192.168.0.11")
term_a_term_b_remote_connection.disconnect() term_a_term_b_remote_connection.disconnect()
Configuration
=============
.. include:: ../common/common_configuration.rst
.. |SOFTWARE_NAME| replace:: Terminal
.. |SOFTWARE_NAME_BACKTICK| replace:: ``Terminal``

8
docs/source/simulation_components/system/services/web_server.rst
View File

@@ -75,10 +75,8 @@ Via Configuration
- ref: web_server - ref: web_server
type: WebServer type: WebServer
Configuration
=============
.. include:: ../common/common_configuration.rst ``Common Attributes``
"""""""""""""""""""""
.. |SOFTWARE_NAME| replace:: WebServer See :ref:`Common Configuration`
.. |SOFTWARE_NAME_BACKTICK| replace:: ``WebServer``

9
docs/source/simulation_components/system/software.rst
View File

@@ -2,6 +2,8 @@
© Crown-owned copyright 2024, Defence Science and Technology Laboratory UK © Crown-owned copyright 2024, Defence Science and Technology Laboratory UK
.. _software:
Software Software
======== ========
@@ -63,3 +65,10 @@ Processes
######### #########
`To be implemented` `To be implemented`
Common Software Configuration
#############################
Below is a list of the common configuration items within Software components of PrimAITE:
.. include:: common/common_configuration.rst