Discover Remote Systems

Bases: Action

A high level Red action that discovers active IP addresses of the other hosts in a subnet. It calls the low level action 'Pingsweep'.

Attributes:

Name	Type	Description
subnet	IPv4Network	The ip_address of the target subnet.
session	int	The source session id.
agent	str	The name of the red agent executing the action.

Functions

__init__

__init__(subnet: IPv4Network, session: int, agent: str)

Parameters:

Name	Type	Description	Default
subnet	IPv4Network	The ip_address of the target subnet.	required
session	int	The source session id.	required
agent	str	The name of the red agent executing the action.	required

execute

execute(state: State) -> Observation

Pingsweeps the target subnet for active IP addresses of the other hosts.

Parameters:

Name	Type	Description	Default
state	State	The state of the simulated network at the current step.	required

Returns:

Name	Type	Description
obs	Observation	An observation containing an indication of the action's successful execution as True/False, and any detected host IP addresses on the subnet.