v3.1.0 #24

marek-methods · 2025-03-18T11:22:49Z

marek-methods
Mar 18, 2025
Maintainer

Ping scan and port scan - PrimAITE includes a new application called NMAP, which allows agents to perform a ping scan or a port scan on the network. This is accompanied by ping / port scan actions which return data back to the agent to dynamically select target nodes.
CAOS v0.9 - PrimAITE 3.1 is compliant with Common Action and Observation Space (CAOS) v0.9. This is a minor change that introduces a new traffic observation on network interfaces. The CAOS v0.9 specification is attached.

Network interface traffic observation - It is possible for the observation space to report network traffic amounts on network interfaces, broken down by protocol, port, and whether the traffic is inbound or outbound. To include this observation component, the network interface observation, or any of its parents must include the key monitored_traffic. For example:
```
observation_space:
  type: NODES
  options:
    # ... other options
    monitored_traffic:
      tcp:
        - DNS
        - HTTP
      icmp:
        - NONE
    # ... other options
```

Agent reward logging - All past agent rewards are now reported within the agent history log file.
Notebooks - Documentation notebooks have been updated to reflect the new changes.

Database client uninstall action - Fixed an issue where the program would enter an infinite loop when using the application uninstall action on the database client in certain circumstances.

target_router_nodename config key was renamed to target_router. Users should find-and-replace any instances of target_router_nodename in the action map part of their config files.

CAOS v0.9 has been developed alongside this release of PrimAITE. The following changes were made from CAOS v0.8 to v0.9:

Corrected BAS-62 -> BAS-70 (APPLICATION:FIX). Had the wrong ID
New BOS-120 and BOS-121 which present inbound and outbound traffic levels per protocol / port on each NIC

This discussion was created from the release v3.1.0.