Files
chipsec-chipsec/chipsec/modules/common/spi_lock.py
T
BrentHoltsclaw e7b2c983ec Cleanup imports within modules directory
Signed-off-by: BrentHoltsclaw <brent.holtsclaw@intel.com>
2020-01-23 15:07:44 -08:00

76 lines
3.0 KiB
Python

#CHIPSEC: Platform Security Assessment Framework
#Copyright (c) 2010-2020, Intel Corporation
#
#This program is free software; you can redistribute it and/or
#modify it under the terms of the GNU General Public License
#as published by the Free Software Foundation; Version 2.
#
#This program is distributed in the hope that it will be useful,
#but WITHOUT ANY WARRANTY; without even the implied warranty of
#MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
#GNU General Public License for more details.
#
#You should have received a copy of the GNU General Public License
#along with this program; if not, write to the Free Software
#Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
#
#Contact information:
#chipsec@intel.com
#
"""
The configuration of the SPI controller, including protected ranges (PR0-PR4), is locked by HSFS[FLOCKDN] until reset. If not locked, the controller configuration may be bypassed by reprogramming these registers.
This vulnerability (not setting FLOCKDN) is also checked by other tools, including `flashrom <http://www.flashrom.org/>`_ and Copernicus by MITRE (ref: `Copernicus: Question Your Assumptions about BIOS Security` http://www.mitre.org/capabilities/cybersecurity/overview/cybersecurity-blog/copernicus-question-your-assumptions-about).
This module checks that the SPI Flash Controller configuration is locked.
"""
from chipsec.module_common import BaseModule, ModuleResult, MTAG_BIOS
TAGS = [MTAG_BIOS]
class spi_lock(BaseModule):
def __init__(self):
super(spi_lock, self).__init__()
def is_supported(self):
return self.cs.is_control_defined('FlashLockDown')
def check_spi_lock(self):
self.logger.start_test( "SPI Flash Controller Configuration Locks" )
res = ModuleResult.PASSED
reg_print = True
if self.cs.is_control_defined('SpiWriteStatusDis'):
wrsdis = self.cs.get_control('SpiWriteStatusDis', with_print=reg_print)
if 1 == wrsdis:
self.logger.log_good('SPI write status disable set.')
else:
res = ModuleResult.FAILED
self.logger.log_bad('SPI write status disable not set.')
reg_print = False
flockdn = self.cs.get_control('FlashLockDown', with_print=reg_print)
if 1 == flockdn:
self.logger.log_good( "SPI Flash Controller configuration is locked" )
else:
res = ModuleResult.FAILED
self.logger.log_bad( "SPI Flash Controller configuration is not locked" )
reg_print = False
if res == ModuleResult.FAILED:
self.logger.log_failed_check("SPI Flash Controller not locked correctly.")
elif res == ModuleResult.PASSED:
self.logger.log_passed_check("SPI Flash Controller locked correctly.")
else:
self.logger.log_warn_check("Unable to determine if SPI Flash Controller is locked correctly.")
return res
def run( self, module_argv ):
return self.check_spi_lock()