Source code for plaso.parsers.winreg_plugins.usb

# -*- coding: utf-8 -*-
"""File containing a Windows Registry plugin to parse the USB Device key."""

from plaso.containers import events
from plaso.containers import time_events
from plaso.lib import definitions
from plaso.parsers import logger
from plaso.parsers import winreg_parser
from plaso.parsers.winreg_plugins import interface


[docs]class WindowsUSBDeviceEventData(events.EventData): """Windows USB device event data attribute container. Attributes: key_path (str): Windows Registry key path. product (str): product of the USB device. serial (str): serial number of the USB device. subkey_name (str): name of the Windows Registry subkey. vendor (str): vendor of the USB device. """ DATA_TYPE = 'windows:registry:usb' def __init__(self): """Initializes event data.""" super(WindowsUSBDeviceEventData, self).__init__(data_type=self.DATA_TYPE) self.key_path = None self.product = None self.serial = None # TODO: rename subkey_name to something that closer matches its purpose. self.subkey_name = None self.vendor = None
[docs]class USBPlugin(interface.WindowsRegistryPlugin): """USB Windows Registry plugin for last connection time. Also see: https://docs.microsoft.com/en-us/windows-hardware/drivers/usbcon/ """ NAME = 'windows_usb_devices' DATA_FORMAT = 'Windows USB device Registry data' FILTERS = frozenset([ interface.WindowsRegistryKeyPathFilter( 'HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Enum\\USB')])
[docs] def ExtractEvents(self, parser_mediator, registry_key, **kwargs): """Extracts events from a Windows Registry key. Args: parser_mediator (ParserMediator): mediates interactions between parsers and other components, such as storage and dfvfs. registry_key (dfwinreg.WinRegistryKey): Windows Registry key. """ event_data = WindowsUSBDeviceEventData() event_data.key_path = registry_key.path for subkey in registry_key.GetSubkeys(): event_data.subkey_name = subkey.name vendor_identification = None product_identification = None try: subkey_name_parts = subkey.name.split('&') if len(subkey_name_parts) >= 2: vendor_identification = subkey_name_parts[0] product_identification = subkey_name_parts[1] except ValueError as exception: logger.warning( 'Unable to split string: {0:s} with error: {1!s}'.format( subkey.name, exception)) if vendor_identification and product_identification: event_data.vendor = vendor_identification event_data.product = product_identification for devicekey in subkey.GetSubkeys(): event_data.serial = devicekey.name # Last USB connection per USB device recorded in the Registry. event = time_events.DateTimeValuesEvent( devicekey.last_written_time, definitions.TIME_DESCRIPTION_LAST_CONNECTED) parser_mediator.ProduceEventWithEventData(event, event_data)
winreg_parser.WinRegistryParser.RegisterPlugin(USBPlugin)