v3.1.0
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_nodenameconfig key was renamed totarget_router. Users should find-and-replace any instances oftarget_router_nodenamein 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 |