#2257: apply PR suggestions

docs/source/configuration/simulation/nodes/common/common_host_node_attributes.rst

@@ -24,7 +24,7 @@ The IP address that the |NODE| will use as the default gateway. Typically, this
 
 Optional. Default value is ``None``
 
-The IP address of the node which holds an instance of the DNS server. Some applications may use a domain name e.g. the WebBrowser (TODO: WebBrowser page)
+The IP address of the node which holds an instance of the :ref:`DNSServer`. Some applications may use a domain name e.g. the :ref:`WebBrowser`
 
 .. include:: ../software/applications.rst
 

docs/source/configuration/simulation/nodes/firewall.rst

@@ -7,7 +7,7 @@
 ``firewall``
 ============
 
-A basic representation of a network router within the simulation.
+A basic representation of a network firewall within the simulation.
 
 The firewall is similar to how :ref:`Router <router_configuration>` works, with the difference being how firewall has specific ACL rules for inbound and outbound traffic as well as firewall being limited to 3 ports.
 
@@ -133,6 +133,10 @@ example:
         ...
         acl:
             internal_inbound_acl:
+                21: # position 21 on ACL list
+                    action: PERMIT  # allow packets that
+                    src_port: POSTGRES_SERVER   # are emitted from the POSTGRES_SERVER port
+                    dst_port: POSTGRES_SERVER   # are going towards an POSTGRES_SERVER port
                 22: # position 22 on ACL list
                     action: PERMIT  # allow packets that
                     src_port: ARP   # are emitted from the ARP port
@@ -155,6 +159,10 @@ example:
         ...
         acl:
             internal_outbound_acl:
+                21: # position 21 on ACL list
+                    action: PERMIT  # allow packets that
+                    src_port: POSTGRES_SERVER   # are emitted from the POSTGRES_SERVER port
+                    dst_port: POSTGRES_SERVER   # are going towards an POSTGRES_SERVER port
                 22: # position 22 on ACL list
                     action: PERMIT  # allow packets that
                     src_port: ARP   # are emitted from the ARP port
@@ -178,6 +186,18 @@ example:
         ...
         acl:
             dmz_inbound_acl:
+                19: # position 19 on ACL list
+                    action: PERMIT  # allow packets that
+                    src_port: POSTGRES_SERVER   # are emitted from the POSTGRES_SERVER port
+                    dst_port: POSTGRES_SERVER   # are going towards an POSTGRES_SERVER port
+                20: # position 20 on ACL list
+                    action: PERMIT  # allow packets that
+                    src_port: HTTP   # are emitted from the HTTP port
+                    dst_port: HTTP   # are going towards an HTTP port
+                21: # position 21 on ACL list
+                    action: PERMIT  # allow packets that
+                    src_port: HTTPS   # are emitted from the HTTPS port
+                    dst_port: HTTPS   # are going towards an HTTPS port
                 22: # position 22 on ACL list
                     action: PERMIT  # allow packets that
                     src_port: ARP   # are emitted from the ARP port
@@ -200,6 +220,18 @@ example:
         ...
         acl:
             dmz_outbound_acl:
+                19: # position 19 on ACL list
+                    action: PERMIT  # allow packets that
+                    src_port: POSTGRES_SERVER   # are emitted from the POSTGRES_SERVER port
+                    dst_port: POSTGRES_SERVER   # are going towards an POSTGRES_SERVER port
+                20: # position 20 on ACL list
+                    action: PERMIT  # allow packets that
+                    src_port: HTTP   # are emitted from the HTTP port
+                    dst_port: HTTP   # are going towards an HTTP port
+                21: # position 21 on ACL list
+                    action: PERMIT  # allow packets that
+                    src_port: HTTPS   # are emitted from the HTTPS port
+                    dst_port: HTTPS   # are going towards an HTTPS port
                 22: # position 22 on ACL list
                     action: PERMIT  # allow packets that
                     src_port: ARP   # are emitted from the ARP port
@@ -226,6 +258,10 @@ example:
         ...
         acl:
             external_inbound_acl:
+                21: # position 19 on ACL list
+                    action: DENY  # deny packets that
+                    src_port: POSTGRES_SERVER   # are emitted from the POSTGRES_SERVER port
+                    dst_port: POSTGRES_SERVER   # are going towards an POSTGRES_SERVER port
                 22: # position 22 on ACL list
                     action: PERMIT  # allow packets that
                     src_port: ARP   # are emitted from the ARP port

docs/source/simulation_components/system/applications/data_manipulation_bot.rst

@@ -99,7 +99,7 @@ If not using the data manipulation bot manually, it needs to be used with a data
             type: UC2RedObservation
             options:
               nodes:
-                - node_ref: client_1
+                - node_name: client_1
                   observations:
                   - logon_status
                   - operating_status
@@ -116,7 +116,7 @@ If not using the data manipulation bot manually, it needs to be used with a data
               - type: NODE_APPLICATION_EXECUTE
             options:
               nodes:
-              - node_ref: client_1
+              - node_name: client_1
                 applications:
                   - application_ref: data_manipulation_bot
               max_folders_per_node: 1

docs/source/simulation_components/system/list_of_applications.rst

@@ -1,3 +1,7 @@
+.. only:: comment
+
+    © Crown-owned copyright 2023, Defence Science and Technology Laboratory UK
+
 .. toctree::
     :maxdepth: 1
     :glob:

docs/source/simulation_components/system/list_of_services.rst

@@ -1,3 +1,7 @@
+.. only:: comment
+
+    © Crown-owned copyright 2023, Defence Science and Technology Laboratory UK
+
 .. toctree::
     :maxdepth: 1
     :glob:

docs/source/simulation_components/system/services/database_service.rst

@@ -12,7 +12,7 @@ The ``DatabaseService`` provides a SQL database server simulation by extending t
 Key capabilities
 ================
 
-- Creates a database file in the ``Node`` 's ``FileSystem`` upon creation.
+- Creates a database file in the ``FileSystem`` of the ``Node`` (which the ``DatabaseService`` is installed on) upon creation.
 - Handles connecting clients by maintaining a dictionary of connections mapped to session IDs.
 - Authenticates connections using a configurable password.
 - Simulates ``SELECT``, ``DELETE`` and ``INSERT`` SQL queries.

docs/source/simulation_components/system/services/ftp_client.rst

@@ -20,6 +20,7 @@ Key features
     - RETR: retrieves a file from the FTP server
     - QUIT: disconnect from server
 - Leverages the Service base class for install/uninstall, status tracking, etc.
+- :ref:`FTPClient` and ``FTPServer`` utilise port 21 (FTP) throughout all file transfer / request
 
 Usage
 =====
@@ -52,7 +53,7 @@ Python
         hostname="server",
         ip_address="192.168.2.2",
         subnet_mask="255.255.255.0",
-        default_gateway="192.168.1.1Ó",
+        default_gateway="192.168.1.10",
         start_up_duration=0,
     )
     server.power_on()

docs/source/simulation_components/system/services/ftp_server.rst

@@ -17,12 +17,13 @@ Key capabilities
     - STOR: stores a file from client to server
     - RETR: retrieves a file from the FTP server
 - Leverages the Service base class for install/uninstall, status tracking, etc.
+- :ref:`FTPClient` and ``FTPServer`` utilise port 21 (FTP) throughout all file transfer / request
 
 Usage
 =====
 
 - Install on a Node via the ``SoftwareManager`` to start the FTP server service.
-- Service runs on FTP (command) port 21 by default. (TODO: look at in depth implementation of FTP PORT command)
+- Service runs on FTP (command) port 21 by default
 
 Implementation
 ==============