mirror of
https://github.com/volatilityfoundation/volatility3.git
synced 2026-08-17 20:35:40 +02:00
Plugins: categorize windows.drivermodule as a malware plugin
This commit is contained in:
SolitudePy
@@ -1,101 +1,20 @@
|
||||
# This file is Copyright 2019 Volatility Foundation and licensed under the Volatility Software License 1.0
|
||||
# This file is Copyright 2025 Volatility Foundation and licensed under the Volatility Software License 1.0
|
||||
# which is available at https://www.volatilityfoundation.org/license/vsl-v1.0
|
||||
#
|
||||
from typing import Iterator, List, Tuple
|
||||
from volatility3.framework import renderers, interfaces
|
||||
from volatility3.framework.configuration import requirements
|
||||
from volatility3.framework.renderers import format_hints
|
||||
from volatility3.plugins.windows import ssdt, driverscan, modules
|
||||
import logging
|
||||
from volatility3.framework import interfaces, deprecation
|
||||
from volatility3.plugins.windows.malware import drivermodule
|
||||
|
||||
# built in Windows-components that trigger false positives
|
||||
KNOWN_DRIVERS = ["ACPI_HAL", "PnpManager", "RAW", "WMIxWDM", "Win32k", "Fs_Rec"]
|
||||
vollog = logging.getLogger(__name__)
|
||||
|
||||
|
||||
class DriverModule(interfaces.plugins.PluginInterface):
|
||||
"""Determines if any loaded drivers were hidden by a rootkit"""
|
||||
class DriverModule(
|
||||
interfaces.plugins.PluginInterface,
|
||||
deprecation.PluginRenameClass,
|
||||
replacement_class=drivermodule.DriverModule,
|
||||
removal_date="2026-06-07",
|
||||
):
|
||||
"""Determines if any loaded drivers were hidden by a rootkit (deprecated)."""
|
||||
|
||||
_required_framework_version = (2, 0, 0)
|
||||
_version = (1, 0, 0)
|
||||
|
||||
@classmethod
|
||||
def get_requirements(cls) -> List[interfaces.configuration.RequirementInterface]:
|
||||
return [
|
||||
requirements.ModuleRequirement(
|
||||
name="kernel",
|
||||
description="Windows kernel",
|
||||
architectures=["Intel32", "Intel64"],
|
||||
),
|
||||
requirements.VersionRequirement(
|
||||
name="ssdt", component=ssdt.SSDT, version=(2, 0, 0)
|
||||
),
|
||||
requirements.VersionRequirement(
|
||||
name="driverscan", component=driverscan.DriverScan, version=(2, 0, 0)
|
||||
),
|
||||
requirements.VersionRequirement(
|
||||
name="modules", component=modules.Modules, version=(3, 0, 0)
|
||||
),
|
||||
]
|
||||
|
||||
def _generator(self) -> Iterator[Tuple]:
|
||||
"""
|
||||
Attempt to match each driver's start code address to a known kernel module
|
||||
A common rootkit technique is to register drivers from modules that are hidden,
|
||||
which allows us to detect the disconnect between a malicious driver and its hidden module.
|
||||
"""
|
||||
collection = ssdt.SSDT.build_module_collection(
|
||||
context=self.context,
|
||||
kernel_module_name=self.config["kernel"],
|
||||
)
|
||||
|
||||
kernel_space_start = modules.Modules.get_kernel_space_start(
|
||||
self.context, self.config["kernel"]
|
||||
)
|
||||
|
||||
for driver in driverscan.DriverScan.scan_drivers(
|
||||
self.context,
|
||||
self.config["kernel"],
|
||||
):
|
||||
# We want starts of 0 as rootkits often set this value
|
||||
# greater than 0 but less than the kernel space start is smear/terminated though
|
||||
if 0 < driver.DriverStart < kernel_space_start:
|
||||
continue
|
||||
|
||||
# we do not care about actual symbol names, we just want to know if the driver points to a known module
|
||||
module_symbols = list(
|
||||
collection.get_module_symbols_by_absolute_location(driver.DriverStart)
|
||||
)
|
||||
if not module_symbols:
|
||||
(
|
||||
driver_name,
|
||||
service_key,
|
||||
name,
|
||||
) = driverscan.DriverScan.get_names_for_driver(driver)
|
||||
|
||||
# drivers without any names will not produce useful output
|
||||
if not driver_name and not service_key and not name:
|
||||
continue
|
||||
|
||||
known_exception = driver_name in KNOWN_DRIVERS
|
||||
|
||||
yield (
|
||||
0,
|
||||
(
|
||||
format_hints.Hex(driver.vol.offset),
|
||||
known_exception,
|
||||
driver_name or renderers.NotAvailableValue(),
|
||||
service_key or renderers.NotAvailableValue(),
|
||||
name or renderers.NotAvailableValue(),
|
||||
),
|
||||
)
|
||||
|
||||
def run(self) -> renderers.TreeGrid:
|
||||
return renderers.TreeGrid(
|
||||
[
|
||||
("Offset", format_hints.Hex),
|
||||
("Known Exception", bool),
|
||||
("Driver Name", str),
|
||||
("Service Key", str),
|
||||
("Alternative Name", str),
|
||||
],
|
||||
self._generator(),
|
||||
)
|
||||
|
||||
@@ -0,0 +1,101 @@
|
||||
# This file is Copyright 2019 Volatility Foundation and licensed under the Volatility Software License 1.0
|
||||
# which is available at https://www.volatilityfoundation.org/license/vsl-v1.0
|
||||
#
|
||||
from typing import Iterator, List, Tuple
|
||||
from volatility3.framework import renderers, interfaces
|
||||
from volatility3.framework.configuration import requirements
|
||||
from volatility3.framework.renderers import format_hints
|
||||
from volatility3.plugins.windows import ssdt, driverscan, modules
|
||||
|
||||
# built in Windows-components that trigger false positives
|
||||
KNOWN_DRIVERS = ["ACPI_HAL", "PnpManager", "RAW", "WMIxWDM", "Win32k", "Fs_Rec"]
|
||||
|
||||
|
||||
class DriverModule(interfaces.plugins.PluginInterface):
|
||||
"""Determines if any loaded drivers were hidden by a rootkit"""
|
||||
|
||||
_required_framework_version = (2, 0, 0)
|
||||
_version = (1, 0, 0)
|
||||
|
||||
@classmethod
|
||||
def get_requirements(cls) -> List[interfaces.configuration.RequirementInterface]:
|
||||
return [
|
||||
requirements.ModuleRequirement(
|
||||
name="kernel",
|
||||
description="Windows kernel",
|
||||
architectures=["Intel32", "Intel64"],
|
||||
),
|
||||
requirements.VersionRequirement(
|
||||
name="ssdt", component=ssdt.SSDT, version=(2, 0, 0)
|
||||
),
|
||||
requirements.VersionRequirement(
|
||||
name="driverscan", component=driverscan.DriverScan, version=(2, 0, 0)
|
||||
),
|
||||
requirements.VersionRequirement(
|
||||
name="modules", component=modules.Modules, version=(3, 0, 0)
|
||||
),
|
||||
]
|
||||
|
||||
def _generator(self) -> Iterator[Tuple]:
|
||||
"""
|
||||
Attempt to match each driver's start code address to a known kernel module
|
||||
A common rootkit technique is to register drivers from modules that are hidden,
|
||||
which allows us to detect the disconnect between a malicious driver and its hidden module.
|
||||
"""
|
||||
collection = ssdt.SSDT.build_module_collection(
|
||||
context=self.context,
|
||||
kernel_module_name=self.config["kernel"],
|
||||
)
|
||||
|
||||
kernel_space_start = modules.Modules.get_kernel_space_start(
|
||||
self.context, self.config["kernel"]
|
||||
)
|
||||
|
||||
for driver in driverscan.DriverScan.scan_drivers(
|
||||
self.context,
|
||||
self.config["kernel"],
|
||||
):
|
||||
# We want starts of 0 as rootkits often set this value
|
||||
# greater than 0 but less than the kernel space start is smear/terminated though
|
||||
if 0 < driver.DriverStart < kernel_space_start:
|
||||
continue
|
||||
|
||||
# we do not care about actual symbol names, we just want to know if the driver points to a known module
|
||||
module_symbols = list(
|
||||
collection.get_module_symbols_by_absolute_location(driver.DriverStart)
|
||||
)
|
||||
if not module_symbols:
|
||||
(
|
||||
driver_name,
|
||||
service_key,
|
||||
name,
|
||||
) = driverscan.DriverScan.get_names_for_driver(driver)
|
||||
|
||||
# drivers without any names will not produce useful output
|
||||
if not driver_name and not service_key and not name:
|
||||
continue
|
||||
|
||||
known_exception = driver_name in KNOWN_DRIVERS
|
||||
|
||||
yield (
|
||||
0,
|
||||
(
|
||||
format_hints.Hex(driver.vol.offset),
|
||||
known_exception,
|
||||
driver_name or renderers.NotAvailableValue(),
|
||||
service_key or renderers.NotAvailableValue(),
|
||||
name or renderers.NotAvailableValue(),
|
||||
),
|
||||
)
|
||||
|
||||
def run(self) -> renderers.TreeGrid:
|
||||
return renderers.TreeGrid(
|
||||
[
|
||||
("Offset", format_hints.Hex),
|
||||
("Known Exception", bool),
|
||||
("Driver Name", str),
|
||||
("Service Key", str),
|
||||
("Alternative Name", str),
|
||||
],
|
||||
self._generator(),
|
||||
)
|
||||
Reference in New Issue
Block a user