Exploit Remote Service

Bases: RemoteAction

A Red action that attempts to exploit a service on a given host to gain a user privileged shell.

Attributes:

Name	Type	Description
ip_address	IPv4Address	The ip_address of the target host.
session	int	The source session id.
agent	str	The name of the red agent executing the action.
exploit_action_selector	ExploitActionSelector	A selector that chooses an applicable exploit for the target host, as well as required processes.

Functions

__init__

__init__(ip_address: IPv4Address, session: int, agent: str)

Parameters:

Name	Type	Description	Default
ip_address	IPv4Address	The ip_address of the target host.	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

Attempts to exploit a service on the target host to gain a user privileged shell.

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 the exploit carried out, if successful.