From df0174eacba28e051532757910699f10b242d0e7 Mon Sep 17 00:00:00 2001
From: Mike Salvatore <mike.s.salvatore@gmail.com>
Date: Fri, 19 Nov 2021 16:46:48 -0500
Subject: [PATCH] Agent: Add IPuppet

---
 monkey/infection_monkey/i_puppet.py | 88 +++++++++++++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 monkey/infection_monkey/i_puppet.py

diff --git a/monkey/infection_monkey/i_puppet.py b/monkey/infection_monkey/i_puppet.py
new file mode 100644
index 000000000..46181f509
--- /dev/null
+++ b/monkey/infection_monkey/i_puppet.py
@@ -0,0 +1,88 @@
+import abc
+import threading
+from collections import namedtuple
+from enum import Enum
+from typing import Dict, Optional, Tuple
+
+
+class PortStatus(Enum):
+    OPEN = 1
+    CLOSED = 2
+
+
+PortScanData = namedtuple("PortScanData", ["port", "status", "banner", "service"])
+
+
+class IPuppet(metaclass=abc.ABCMeta):
+    @abc.abstractmethod
+    def run_sys_info_collector(self, name: str) -> Dict:
+        """
+        Runs a system info collector
+        :param str name: The name of the system info collector to run
+        :return: A dictionary containing the information collected from the system
+        :rtype: Dict
+        """
+
+    @abc.abstractmethod
+    def run_pba(self, name: str, options: Dict) -> None:
+        """
+        Runs a post-breach action (PBA)
+        :param str name: The name of the post-breach action to run
+        :param Dict options: A dictionary containing options that modify the behavior of the PBA
+        """
+
+    @abc.abstractmethod
+    def ping(self, host: str) -> Tuple[bool, Optional[str]]:
+        """
+        Sends a ping (ICMP packet) to a remote host
+        :param str host: The domain name or IP address of a host
+        :return: A tuple that contains whether or not the host responded and the host's inferred
+                 operating system
+        :rtype: Tuple[bool, Optional[str]]
+        """
+
+    @abc.abstractmethod
+    def scan_tcp_port(self, host: str, port: int) -> PortScanData:
+        """
+        Scans a TCP port on a remote host
+        :param str host: The domain name or IP address of a host
+        :param int port: A TCP port number to scan
+        :return: The data collected by scanning the provided host:port combination
+        :rtype: PortScanData
+        """
+
+    @abc.abstractmethod
+    def fingerprint(self, name: str, host: str) -> Dict:
+        """
+        Runs a fingerprinter against a remote host
+        :param str name: The name of the fingerprinter to run
+        :param str host: The domain name or IP address of a host
+        :return: A dictionary containing the information collected by the fingerprinter
+        :rtype: Dict
+        """
+
+    @abc.abstractmethod
+    def exploit_host(self, name: str, host: str, options: dict, interrupt: threading.Event) -> bool:
+        """
+        Runs an exploiter against a remote host
+        :param str name: The name of the exploiter to run
+        :param str host: The domain name or IP address of a host
+        :param Dict options: A dictionary containing options that modify the behavior of the
+                             exploiter
+        :return: True if exploitation was successful, False otherwise
+        :rtype: bool
+        """
+
+    @abc.abstractmethod
+    def run_payload(self, name: str, options: dict, interrupt: threading.Event) -> None:
+        """
+        Runs a payload
+        :param str name: The name of the payload to run
+        :param Dict options: A dictionary containing options that modify the behavior of the payload
+        """
+
+    @abc.abstractmethod
+    def cleanup(self) -> None:
+        """
+        Revert any changes made to the system by the puppet.
+        """