Agent: refactor mimikatz_cred_collector to credential collector

monkey/infection_monkey/credential_collectors/__init__.py

@@ -0,0 +1,6 @@
+from .i_credential_collector import ICredentialCollector
+from .credential_components.nt_hashes import NTHashes
+from .credential_components.password import Password
+from .credential_components.ssh_keypair import SSHKeypair
+from .credential_components.username import Username
+from .credentials import Credentials

monkey/infection_monkey/credential_collectors/credential_components/nt_hashes.py

@@ -0,0 +1,9 @@
+from ..credential_types import CredentialTypes
+from .i_credential_component import ICredentialComponent
+
+
+class NTHashes(ICredentialComponent):
+    def __init__(self, ntlm_hash: str, lm_hash: str):
+        super().__init__(
+            type=CredentialTypes.NTLM_HASH, content={"ntlm_hash": ntlm_hash, "lm_hash": lm_hash}
+        )

monkey/infection_monkey/credential_collectors/credential_components/ntlm_hash.py

@@ -1,8 +0,0 @@
-from ..credential_types import CredentialTypes
-
-from .i_credential_component import ICredentialComponent
-
-
-class NtlmHash(ICredentialComponent):
-    def __init__(self, content: dict):
-        super().__init__(type=CredentialTypes.NTLM_HASH, content=content)

monkey/infection_monkey/credential_collectors/credential_components/password.py

@@ -1,8 +1,7 @@
 from ..credential_types import CredentialTypes
-
 from .i_credential_component import ICredentialComponent
 
 
 class Password(ICredentialComponent):
-    def __init__(self, content: dict):
+    def __init__(self, password: str):
-        super().__init__(type=CredentialTypes.PASSWORD, content=content)
+        super().__init__(type=CredentialTypes.PASSWORD, content={"password": password})

monkey/infection_monkey/credential_collectors/credential_components/ssh_keypair.py

@@ -1,8 +1,7 @@
 from ..credential_types import CredentialTypes
-
 from .i_credential_component import ICredentialComponent
 
 
 class SSHKeypair(ICredentialComponent):
     def __init__(self, content: dict):
-        super().__init__(type=CredentialTypes.KEYPAIR, content=content)
+        super().__init__(type=CredentialTypes.SSH_KEYPAIR, content=content)

monkey/infection_monkey/credential_collectors/credential_components/username.py

@@ -1,8 +1,7 @@
 from ..credential_types import CredentialTypes
-
 from .i_credential_component import ICredentialComponent
 
 
 class Username(ICredentialComponent):
-    def __init__(self, content: dict):
+    def __init__(self, username: str):
-        super().__init__(type=CredentialTypes.USERNAME, content=content)
+        super().__init__(type=CredentialTypes.USERNAME, content={"username": username})

monkey/infection_monkey/credential_collectors/credential_types.py

@@ -2,7 +2,7 @@ from enum import Enum
 
 
 class CredentialTypes(Enum):
-    KEYPAIR = 1
+    SSH_KEYPAIR = 1
     USERNAME = 2
     PASSWORD = 3
     NTLM_HASH = 4

monkey/infection_monkey/system_info/windows_cred_collector/mimikatz_cred_collector.py

@@ -1,25 +1,38 @@
 from typing import List
 
+from infection_monkey.credential_collectors import (
+    Credentials,
+    ICredentialCollector,
+    NTHashes,
+    Password,
+    Username,
+)
 from infection_monkey.system_info.windows_cred_collector import pypykatz_handler
 from infection_monkey.system_info.windows_cred_collector.windows_credentials import (
     WindowsCredentials,
 )
 
 
-class MimikatzCredentialCollector(object):
+class MimikatzCredentialCollector(ICredentialCollector):
-    @staticmethod
+    def collect_credentials(self) -> Credentials:
-    def get_creds():
         creds = pypykatz_handler.get_windows_creds()
-        return MimikatzCredentialCollector.cred_list_to_cred_dict(creds)
+        return MimikatzCredentialCollector.to_credentials(creds)
 
     @staticmethod
-    def cred_list_to_cred_dict(creds: List[WindowsCredentials]):
+    def to_credentials(win_creds: List[WindowsCredentials]) -> Credentials:
-        cred_dict = {}
+        creds_obj = Credentials(identities=[], secrets=[])
-        for cred in creds:
+        for win_cred in win_creds:
-            # TODO: This should be handled by the island, not the agent. There is already similar
+
-            #       code in monkey_island/cc/models/report/report_dal.py.
+            if win_cred.username:
-            # Lets not use "." and "$" in keys, because it will confuse mongo.
+                identity = Username(win_cred.username)
-            # Ideally we should refactor island not to use a dict and simply parse credential list.
+                creds_obj.identities.append(identity)
-            key = cred.username.replace(".", ",").replace("$", "")
+
-            cred_dict.update({key: cred.to_dict()})
+            if win_cred.password:
-        return cred_dict
+                password = Password(win_cred.password)
+                creds_obj.secrets.append(password)
+
+            if win_cred.lm_hash or win_cred.ntlm_hash:
+                hashes = NTHashes(ntlm_hash=win_cred.ntlm_hash, lm_hash=win_cred.lm_hash)
+                creds_obj.secrets.append(hashes)
+
+        return creds_obj