v0.5.0 update for Mythic3.3

CHANGELOG.md

@@ -1,4 +1,17 @@
 
+## [v0.5.0] - 2024-07-09
+
+### Changed
+
+- This is updated to work with Mythic 3.3+ and will cause some issues with Mythic 3.2 and below
+- New Auth
+- New Eventing
+- New Build/C2/Command parameter options of ChooseOneCustom and FileMultiple
+- New Logging options
+- Added MythicRPCAPITokenCreate
+- Added MythicRPCCallbackNextCheckinRange
+- Added MythicRPCFilebrowserParsePath
+
 ## [v0.4.19] - 2024-04-29
 
 ### Changed

README.md

@@ -13,7 +13,7 @@ pip install mythic-container
 
 ## How to use
 
-Use it with Mythic version 3.0.0.
+Use it with Mythic version 3.3.0.
 
 For the main execution of the heartbeat and service functionality, simply import and start the service:
 ```
@@ -24,4 +24,4 @@ mythic_container.mythic_service.start_and_run_forever()
 
 ## Where is the code?
 
-The code for this PyPi package can be found at https://github.com/MythicMeta/Mythic_Container 
+The code for this PyPi package can be found at https://github.com/MythicMeta/MythicContainerPyPi

mythic_container/AuthBase.py

@@ -0,0 +1,299 @@
+from collections.abc import Callable, Awaitable
+from typing import Union
+
+import mythic_container
+from .logging import logger
+import base64
+import json
+from .MythicCommandBase import PTTaskMessageTaskData
+from .SharedClasses import ContainerOnStartMessage, ContainerOnStartMessageResponse
+
+
+class GetIDPMetadataMessage:
+    def __init__(self,
+                 container_name: str = "",
+                 server_name: str = "",
+                 idp_name: str = "",
+                 **kwargs):
+        self.ContainerName = container_name
+        self.ServerName = server_name
+        self.IDPName = idp_name
+
+    def to_json(self):
+        return {
+            "container_name": self.ContainerName,
+            "server_name": self.ServerName,
+            "idp_name": self.IDPName
+        }
+
+
+class GetIDPMetadataMessageResponse:
+    def __init__(self,
+                 Success: bool = True,
+                 Error: str = "",
+                 Metadata: str = "",
+                 **kwargs):
+        self.Success = Success
+        self.Error = Error
+        self.Metadata = Metadata
+
+    def to_json(self):
+        return {
+            "success": self.Success,
+            "error": self.Error,
+            "metadata": self.Metadata
+        }
+
+
+class GetIDPRedirectMessage:
+    def __init__(self,
+                 container_name: str = "",
+                 server_name: str = "",
+                 idp_name: str = "",
+                 request_url: str = "",
+                 request_headers: dict = {},
+                 request_cookies: dict = {},
+                 request_query: dict = {}):
+        self.ContainerName = container_name
+        self.ServerName = server_name
+        self.IDPName = idp_name
+        self.RequestURL = request_url
+        self.RequestHeaders = request_headers
+        self.RequestCookies = request_cookies
+        self.RequestQuery = request_query
+
+    def to_json(self):
+        return {
+            "container_name": self.ContainerName,
+            "server_name": self.ServerName,
+            "idp_name": self.IDPName,
+            "request_url": self.RequestURL,
+            "request_headers": self.RequestHeaders,
+            "request_cookies": self.RequestCookies,
+            "request_query": self.RequestQuery
+        }
+
+
+class GetIDPRedirectMessageResponse:
+    def __init__(self,
+                 Success: bool = True,
+                 Error: str = "",
+                 RedirectURL: str = "",
+                 RedirectHeaders: dict = {},
+                 RedirectCookies: dict = {}):
+        self.Success = Success
+        self.Error = Error
+        self.RedirectURL = RedirectURL
+        self.RedirectHeaders = RedirectHeaders
+        self.RedirectCookies = RedirectCookies
+
+    def to_json(self):
+        return {
+            "success": self.Success,
+            "error": self.Error,
+            "redirect_url": self.RedirectURL,
+            "redirect_headers": self.RedirectHeaders,
+            "redirect_cookies": self.RedirectCookies
+        }
+
+
+class GetNonIDPMetadataMessage:
+    def __init__(self,
+                 container_name: str = "",
+                 server_name: str = "",
+                 nonidp_name: str = "",
+                 **kwargs):
+        self.ContainerName = container_name
+        self.ServerName = server_name
+        self.NonIDPName = nonidp_name
+
+    def to_json(self):
+        return {
+            "container_name": self.ContainerName,
+            "server_name": self.ServerName,
+            "nonidp_name": self.NonIDPName
+        }
+
+
+class GetNonIDPMetadataMessageResponse:
+    def __init__(self,
+                 Success: bool = True,
+                 Error: str = "",
+                 Metadata: str = "",
+                 **kwargs):
+        self.Success = Success
+        self.Error = Error
+        self.Metadata = Metadata
+
+    def to_json(self):
+        return {
+            "success": self.Success,
+            "error": self.Error,
+            "metadata": self.Metadata
+        }
+
+
+class GetNonIDPRedirectMessage:
+    def __init__(self,
+                 container_name: str = "",
+                 server_name: str = "",
+                 nonidp_name: str = ""):
+        self.ContainerName = container_name
+        self.ServerName = server_name
+        self.NonIDPName = nonidp_name
+
+    def to_json(self):
+        return {
+            "container_name": self.ContainerName,
+            "server_name": self.ServerName,
+            "nonidp_name": self.NonIDPName,
+        }
+
+
+class GetNonIDPRedirectMessageResponse:
+    def __init__(self,
+                 Success: bool = True,
+                 Error: str = "",
+                 RequestFields: [str] = []):
+        self.Success = Success
+        self.Error = Error
+        self.RequestFields = RequestFields
+
+    def to_json(self):
+        return {
+            "success": self.Success,
+            "error": self.Error,
+            "request_fields": self.RequestFields,
+        }
+
+
+class ProcessIDPResponseMessage:
+    def __init__(self,
+                 container_name: str = "",
+                 server_name: str = "",
+                 idp_name: str = "",
+                 request_url: str = "",
+                 request_headers: dict = {},
+                 request_cookies: dict = {},
+                 request_query: dict = {},
+                 request_body: str = ""):
+        self.ContainerName = container_name
+        self.ServerName = server_name
+        self.IDPName = idp_name
+        self.RequestURL = request_url
+        self.RequestHeaders = request_headers
+        self.RequestCookies = request_cookies
+        self.RequestQuery = request_query
+        self.RequestBody = request_body
+
+    def to_json(self):
+        return {
+            "container_name": self.ContainerName,
+            "server_name": self.ServerName,
+            "idp_name": self.IDPName,
+            "request_url": self.RequestURL,
+            "request_headers": self.RequestHeaders,
+            "request_cookies": self.RequestCookies,
+            "request_query": self.RequestQuery,
+            "request_body": self.RequestBody
+        }
+
+
+class ProcessIDPResponseMessageResponse:
+    def __init__(self,
+                 SuccessfulAuthentication: bool = False,
+                 Error: str = "",
+                 Email: str = "", ):
+        self.SuccessfulAuthentication = SuccessfulAuthentication
+        self.Error = Error
+        self.Email = Email
+
+    def to_json(self):
+        return {
+            "successful_authentication": self.SuccessfulAuthentication,
+            "error": self.Error,
+            "email": self.Email,
+        }
+
+
+class ProcessNonIDPResponseMessage:
+    def __init__(self,
+                 container_name: str = "",
+                 server_name: str = "",
+                 idp_name: str = "",
+                 request_values: dict = {}):
+        self.ContainerName = container_name
+        self.ServerName = server_name
+        self.IDPName = idp_name
+        self.RequestValues = request_values
+
+    def to_json(self):
+        return {
+            "container_name": self.ContainerName,
+            "server_name": self.ServerName,
+            "idp_name": self.IDPName,
+            "request_values": self.RequestValues
+        }
+
+
+class ProcessNonIDPResponseMessageResponse:
+    def __init__(self,
+                 SuccessfulAuthentication: bool = False,
+                 Error: str = "",
+                 Email: str = "", ):
+        self.SuccessfulAuthentication = SuccessfulAuthentication
+        self.Error = Error
+        self.Email = Email
+
+    def to_json(self):
+        return {
+            "successful_authentication": self.SuccessfulAuthentication,
+            "error": self.Error,
+            "email": self.Email,
+        }
+
+
+class Auth:
+    """Auth definition class for performing custom auth within Mythic
+
+
+    Attributes:
+        name:
+            name for this auth service that appears in the Mythic UI
+        description:
+            description about what this auth service provides that appears in the Mythic UI
+        idp_services:
+            list of names of IDP services you want to expose into the Mythic UI for users to select
+        non_idp_services:
+            list of names of Non-IDP auth options you want to expose into the Mythic UI for users to select
+
+    Functions:
+
+    """
+    name: str = ""
+    description: str = ""
+    idp_services: [str] = []
+    non_idp_services: [str] = []
+
+    get_idp_metadata: Callable[[GetIDPMetadataMessage], Awaitable[GetIDPMetadataMessageResponse]] = None
+    get_idp_redirect: Callable[[GetIDPRedirectMessage], Awaitable[GetIDPRedirectMessageResponse]] = None
+    process_idp_response: Callable[[ProcessIDPResponseMessage], Awaitable[ProcessIDPResponseMessageResponse]] = None
+    get_non_idp_metadata: Callable[[GetNonIDPMetadataMessage], Awaitable[GetNonIDPMetadataMessageResponse]] = None
+    get_non_idp_redirect: Callable[[GetNonIDPRedirectMessage], Awaitable[GetNonIDPRedirectMessageResponse]] = None
+    process_non_idp_response: Callable[[ProcessNonIDPResponseMessage], Awaitable[ProcessNonIDPResponseMessageResponse]] = None
+
+    async def on_container_start(self, message: ContainerOnStartMessage) -> ContainerOnStartMessageResponse:
+        return ContainerOnStartMessageResponse(ContainerName=self.name)
+
+    def get_sync_message(self):
+        idp_subs = [json.dumps({"name": x, "type": "idp"}) for x in self.idp_services]
+        non_idp_subs = [json.dumps({"name": x, "type": "nonidp"}) for x in self.non_idp_services]
+        return {
+            "name": self.name,
+            "type": "auth",
+            "description": self.description,
+            "subscriptions": idp_subs + non_idp_subs
+        }
+
+
+authServices: dict[str, Auth] = {}