Updated following PR

This commit is contained in:
Archer.Bowen
2024-07-17 15:07:37 +01:00
parent e9d9cea739
commit 8bc84e33be
4 changed files with 24 additions and 24 deletions

View File

@@ -39,7 +39,7 @@ PrimAITE incorporates the following features:
Architecture Architecture
^^^^^^^^^^^^ ^^^^^^^^^^^^
PrimAITE is a Python application and will operate on multiple Operating Systems (Windows, Linux and Mac); PrimAITE is a Python application and will operate on multiple Operating Systems (Windows, Linux and macOS);
a comprehensive installation and user guide is provided with each release to support its usage. a comprehensive installation and user guide is provided with each release to support its usage.
Configuration of PrimAITE is achieved via included YAML files which support full control over the network / system laydown being modelled, background pattern of life, adversarial (red agent) behaviour, and step and episode count. Configuration of PrimAITE is achieved via included YAML files which support full control over the network / system laydown being modelled, background pattern of life, adversarial (red agent) behaviour, and step and episode count.
@@ -66,11 +66,11 @@ Training & Evaluation Capability
PrimAITE provides a training and evaluation capability to AI agents in the context of cyber-attack, via its Gymnasium / Ray RLlib compliant interface. PrimAITE provides a training and evaluation capability to AI agents in the context of cyber-attack, via its Gymnasium / Ray RLlib compliant interface.
Scenarios can be constructed to reflect network / system laydowns consisting of any configuration of nodes (e.g., PCs, servers etc.) and the networking equipment and links between them. Scenarios can be constructed to reflect network / system laydowns consisting of any configuration of nodes (e.g. PCs, servers etc.) and the networking equipment and links between them.
All nodes can be configured to contain applications, services, folders and files (and their status). All nodes can be configured to contain applications, services, folders and files (and their status).
Traffic flows between services and applications as directed by an ‘execution definition,’ with the traffic flow on the network governed by the network equipment (switches, routers and firewalls) and the ACL rules and routing tables they employ. Traffic flows between services and applications as directed by an ‘execution definition’ with the traffic flow on the network governed by the network equipment (switches, routers and firewalls) and the ACL rules and routing tables they employ.
Highlights of PrimAITE’s training and evaluation capability are: Highlights of PrimAITE’s training and evaluation capability are:

View File

@@ -103,14 +103,14 @@ or
`--output-sys-logs` or `-sys` `--output-sys-logs` or `-sys`
----------------------------- -----------------------------
The outputting of system logs can be overridden by dev-mode. The output of system logs can be overridden by dev-mode.
By default, this is set to False By default, this is set to False
Enabling system logs Enabling system logs
"""""""""""""""""""" """"""""""""""""""""
To enable outputting of system logs To enable output of system logs
.. code-block:: .. code-block::
@@ -125,7 +125,7 @@ or
Disabling system logs Disabling system logs
""""""""""""""""""""" """""""""""""""""""""
To disable outputting of system logs To disable output of system logs
.. code-block:: .. code-block::
@@ -140,7 +140,7 @@ or
Enabling agent logs Enabling agent logs
"""""""""""""""""""" """"""""""""""""""""
To enable outputting of system logs To enable output of system logs
.. code-block:: .. code-block::
@@ -155,7 +155,7 @@ or
Disabling system logs Disabling system logs
""""""""""""""""""""" """""""""""""""""""""
To disable outputting of system logs To disable output of system logs
.. code-block:: .. code-block::
@@ -170,14 +170,14 @@ or
`--output-pcap-logs` or `-pcap` `--output-pcap-logs` or `-pcap`
------------------------------- -------------------------------
The outputting of packet capture logs can be overridden by dev-mode. The output of packet capture logs can be overridden by dev-mode.
By default, this is set to False By default, this is set to False
Enabling PCAP logs Enabling PCAP logs
"""""""""""""""""" """"""""""""""""""
To enable outputting of packet capture logs To enable output of packet capture logs
.. code-block:: .. code-block::
@@ -192,7 +192,7 @@ or
Disabling PCAP logs Disabling PCAP logs
""""""""""""""""""" """""""""""""""""""
To disable outputting of packet capture logs To disable output of packet capture logs
.. code-block:: .. code-block::
@@ -207,14 +207,14 @@ or
`--output-to-terminal` or `-t` `--output-to-terminal` or `-t`
------------------------------ ------------------------------
The outputting of system logs to the terminal can be overridden by dev-mode. The output of system logs to the terminal can be overridden by dev-mode.
By default, this is set to False By default, this is set to False
Enabling system log output to terminal Enabling system log output to terminal
"""""""""""""""""""""""""""""""""""""" """"""""""""""""""""""""""""""""""""""
To enable outputting of system logs to terminal To enable output of system logs to terminal
.. code-block:: .. code-block::
@@ -229,7 +229,7 @@ or
Disabling system log output to terminal Disabling system log output to terminal
""""""""""""""""""""""""""""""""""""""" """""""""""""""""""""""""""""""""""""""
To disable outputting of system logs to terminal To disable output of system logs to terminal
.. code-block:: .. code-block::

View File

@@ -25,8 +25,8 @@ When a request is resolved, it returns a success status, and optional additional
``data`` can be a dictionary with any arbitrary JSON-like data to describe the outcome of the request. ``data`` can be a dictionary with any arbitrary JSON-like data to describe the outcome of the request.
Request Syntax: Requests:
""""""""""""""" """""""""
Request Syntax Request Syntax
--------------- ---------------

View File

@@ -7,18 +7,18 @@
RansomwareScript RansomwareScript
################### ###################
The ``DataManipulationBot`` class provides functionality to connect to a :ref:`DatabaseService` and set a database's database.db into an ``CORRUPTED`` state. The RansomwareScript class provides functionality to connect to a :ref:`DatabaseService` and set a database's database.db into an ``CORRUPTED`` state.
Overview Overview
======== ========
The ransomware script intends to simulate a generic implementation of ransomware. The ransomware script intends to simulate a generic implementation of ransomware.
Currently, due to simulation restraints, the ransomware script is unable to attack a host's without active database service. Currently, due to simulation restraints, the ransomware script is unable to attack a hosts without an active database service.
The ransomware script is similar to that of the data_manipulation_bot but does not have any separate stages or configurable probabilities. The ransomware script is similar to that of the data_manipulation_bot but does not have any separate stages or configurable probabilities.
Additionally, similarly to the data_manipulation_bot, the ransomware script must be installed on a host with a pre-existing :ref:`DatabaseClient` application installed. Additionally, similar to the data_manipulation_bot, the ransomware script must be installed on a host with a pre-existing :ref:`DatabaseClient` application installed.
Usage Usage
===== =====
@@ -28,12 +28,12 @@ Usage
- Database password (if needed) - Database password (if needed)
- Call ``Execute`` to connect and execute the ransomware script. - Call ``Execute`` to connect and execute the ransomware script.
This application handles connection to the database server and the encryption but it does not handle disconnections. This application handles connections to the database server and the connection made to encrypt the database but it does not handle disconnections.
Implementation Implementation
============== ==============
At current, the ransomware script connects to a :ref:`DatabaseClient` and leverages its connectivity. The host running ``RansomwareScript`` must also have a :ref:`DatabaseClient` installed on it. Currently, the ransomware script connects to a :ref:`DatabaseClient` and leverages its connectivity. The host running ``RansomwareScript`` must also have a :ref:`DatabaseClient` installed on it.
- Uses the Application base class for lifecycle management. - Uses the Application base class for lifecycle management.
- Target IP and other options set via ``configure``. - Target IP and other options set via ``configure``.
@@ -70,7 +70,7 @@ Python
Configuration Configuration
============= =============
The RansomwareScript inherits configuration options such as ``fix_duration`` from it's 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 .. include:: ../common/common_configuration.rst