Skip to content

v3.1.0

Choose a tag to compare

@marek-methods marek-methods released this 18 Mar 11:22
· 888 commits to dev since this release

PrimAITE 3.1.0

📰 Headlines 📰

  • 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.

✨ What's New ✨

  • 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

🚀 Improvements 🚀

  • 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.

🐛 Bug Fixes 🐛

  • 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.

⚠️ Breaking Changes ⚠️

  • 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 Compatibility

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
CAOS Version Supports Use Case Compatible Releases
0.7 UC2 v3b7
0.8 UC2 v3b8, v3b9, v3.0.0
0.9 UC2 v3.1.0, v3.2.0