// This file was extracted from the TCG Published
// Trusted Platform Module Library
// Part 4: Supporting Routines
// Family "2.0"
// Level 00 Revision 01.16
// October 30, 2014
#define DA_C
#include "InternalRoutines.h"
//
//
// Functions
//
// DAPreInstall_Init()
//
// This function initializes the DA parameters to their manufacturer-default values. The default values are
// determined by a platform-specific specification.
// This function should not be called outside of a manufacturing or simulation environment.
// The DA parameters will be restored to these initial values by TPM2_Clear().
//
void
DAPreInstall_Init(
void
)
{
gp.failedTries = 0;
gp.maxTries = 3;
gp.recoveryTime = 1000; // in seconds (~16.67 minutes)
gp.lockoutRecovery = 1000; // in seconds
gp.lockOutAuthEnabled = TRUE; // Use of lockoutAuth is enabled
// Record persistent DA parameter changes to NV
NvWriteReserved(NV_FAILED_TRIES, &gp.failedTries);
NvWriteReserved(NV_MAX_TRIES, &gp.maxTries);
NvWriteReserved(NV_RECOVERY_TIME, &gp.recoveryTime);
NvWriteReserved(NV_LOCKOUT_RECOVERY, &gp.lockoutRecovery);
NvWriteReserved(NV_LOCKOUT_AUTH_ENABLED, &gp.lockOutAuthEnabled);
return;
}
//
//
// DAStartup()
//
// This function is called by TPM2_Startup() to initialize the DA parameters. In the case of Startup(CLEAR),
// use of lockoutAuth will be enabled if the lockout recovery time is 0. Otherwise, lockoutAuth will not be
// enabled until the TPM has been continuously powered for the lockoutRecovery time.
// This function requires that NV be available and not rate limiting.
//
void
DAStartup(
STARTUP_TYPE type // IN: startup type
)
{
// For TPM Reset, if lockoutRecovery is 0, enable use of lockoutAuth.
if(type == SU_RESET)
{
if(gp.lockoutRecovery == 0)
{
gp.lockOutAuthEnabled = TRUE;
// Record the changes to NV
NvWriteReserved(NV_LOCKOUT_AUTH_ENABLED, &gp.lockOutAuthEnabled);
}
}
// If DA has not been disabled and the previous shutdown is not orderly
// failedTries is not already at its maximum then increment 'failedTries'
if( gp.recoveryTime != 0
&& g_prevOrderlyState == SHUTDOWN_NONE
&& gp.failedTries < gp.maxTries)
{
gp.failedTries++;
// Record the change to NV
NvWriteReserved(NV_FAILED_TRIES, &gp.failedTries);
}
// Reset self healing timers
s_selfHealTimer = g_time;
s_lockoutTimer = g_time;
return;
}
//
//
// DARegisterFailure()
//
// This function is called when a authorization failure occurs on an entity that is subject to dictionary-attack
// protection. When a DA failure is triggered, register the failure by resetting the relevant self-healing timer
// to the current time.
//
void
DARegisterFailure(
TPM_HANDLE handle // IN: handle for failure
)
{
// Reset the timer associated with lockout if the handle is the lockout auth.
if(handle == TPM_RH_LOCKOUT)
s_lockoutTimer = g_time;
else
s_selfHealTimer = g_time;
//
return;
}
//
//
// DASelfHeal()
//
// This function is called to check if sufficient time has passed to allow decrement of failedTries or to re-
// enable use of lockoutAuth.
// This function should be called when the time interval is updated.
//
void
DASelfHeal(
void
)
{
// Regular auth self healing logic
// If no failed authorization tries, do nothing. Otherwise, try to
// decrease failedTries
if(gp.failedTries != 0)
{
// if recovery time is 0, DA logic has been disabled. Clear failed tries
// immediately
if(gp.recoveryTime == 0)
{
gp.failedTries = 0;
// Update NV record
NvWriteReserved(NV_FAILED_TRIES, &gp.failedTries);
}
else
{
UINT64 decreaseCount;
// In the unlikely event that failedTries should become larger than
// maxTries
if(gp.failedTries > gp.maxTries)
gp.failedTries = gp.maxTries;
// How much can failedTried be decreased
decreaseCount = ((g_time - s_selfHealTimer) / 1000) / gp.recoveryTime;
if(gp.failedTries <= (UINT32) decreaseCount)
// should not set failedTries below zero
gp.failedTries = 0;
else
gp.failedTries -= (UINT32) decreaseCount;
// the cast prevents overflow of the product
s_selfHealTimer += (decreaseCount * (UINT64)gp.recoveryTime) * 1000;
if(decreaseCount != 0)
// If there was a change to the failedTries, record the changes
// to NV
NvWriteReserved(NV_FAILED_TRIES, &gp.failedTries);
}
}
// LockoutAuth self healing logic
// If lockoutAuth is enabled, do nothing. Otherwise, try to see if we
// may enable it
if(!gp.lockOutAuthEnabled)
{
// if lockout authorization recovery time is 0, a reboot is required to
// re-enable use of lockout authorization. Self-healing would not
// apply in this case.
if(gp.lockoutRecovery != 0)
//
{
if(((g_time - s_lockoutTimer)/1000) >= gp.lockoutRecovery)
{
gp.lockOutAuthEnabled = TRUE;
// Record the changes to NV
NvWriteReserved(NV_LOCKOUT_AUTH_ENABLED, &gp.lockOutAuthEnabled);
}
}
}
return;
}