SecurityPkg/SecurityPkg.dec

   1 ## @file  SecurityPkg.dec
   2 #  This package includes the security drivers, defintions(including PPIs/PROTOCOLs/GUIDs
   3 #  and library classes) and libraries instances.
   4 #
   5 # Copyright (c) 2009 - 2013, Intel Corporation. All rights reserved.<BR>
   6 # This program and the accompanying materials are licensed and made available under
   7 # the terms and conditions of the BSD License which accompanies this distribution.
   8 # The full text of the license may be found at
   9 # http://opensource.org/licenses/bsd-license.php
  10 #
  11 # THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  12 # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  13 #
  14 ##
  15
  16 [Defines]
  17   DEC_SPECIFICATION              = 0x00010005
  18   PACKAGE_NAME                   = SecurityPkg
  19   PACKAGE_GUID                   = 24369CAC-6AA6-4fb8-88DB-90BF061668AD
  20   PACKAGE_VERSION                = 0.92
  21
  22 [Includes]
  23   Include
  24
  25 [LibraryClasses]
  26   ##  @libraryclass  Definitions for common TPM commands as library API for TPM
  27   #                  module use.
  28   TpmCommLib|Include/Library/TpmCommLib.h
  29   Tpm2CommandLib|Include/Library/Tpm2CommandLib.h
  30   Tpm2DeviceLib|Include/Library/Tpm2DeviceLib.h
  31   TrEEPhysicalPresenceLib|Include/Library/TrEEPhysicalPresenceLib.h
  32   TpmMeasurementLib|Include/Library/TpmMeasurementLib.h
  33
  34 [Guids]
  35   ## Security package token space guid
  36   # Include/Guid/SecurityPkgTokenSpace.h
  37   gEfiSecurityPkgTokenSpaceGuid      = { 0xd3fb176, 0x9569, 0x4d51, { 0xa3, 0xef, 0x7d, 0x61, 0xc6, 0x4f, 0xea, 0xba }}
  38   ## Guid acted as the authenticated variable store header's signature, and to specify the variable list entries put in the EFI system table.
  39   #  Include/Guid/AuthenticatedVariableFormat.h
  40   gEfiAuthenticatedVariableGuid      = { 0xaaf32c78, 0x947b, 0x439a, { 0xa1, 0x80, 0x2e, 0x14, 0x4e, 0xc3, 0x77, 0x92 } }
  41
  42   #  Include/Guid/AuthenticatedVariableFormat.h
  43   gEfiSecureBootEnableDisableGuid    = { 0xf0a30bc7, 0xaf08, 0x4556, { 0x99, 0xc4, 0x0, 0x10, 0x9, 0xc9, 0x3a, 0x44 } }
  44
  45   #  Include/Guid/AuthenticatedVariableFormat.h
  46   gEfiCustomModeEnableGuid           = { 0xc076ec0c, 0x7028, 0x4399, { 0xa0, 0x72, 0x71, 0xee, 0x5c, 0x44, 0x8b, 0x9f } }
  47
  48   #  Include/Guid/AuthenticatedVariableFormat.h
  49   gEfiVendorKeysNvGuid               = { 0x9073e4e0, 0x60ec, 0x4b6e, { 0x99, 0x3, 0x4c, 0x22, 0x3c, 0x26, 0xf, 0x3c } }
  50
  51   #  Include/Guid/AuthenticatedVariableFormat.h
  52   gEfiCertDbGuid                     = { 0xd9bee56e, 0x75dc, 0x49d9, { 0xb4, 0xd7, 0xb5, 0x34, 0x21, 0xf, 0x63, 0x7a } }
  53
  54   ## Include/Guid/TcgEventHob.h
  55   gTcgEventEntryHobGuid              = { 0x2b9ffb52, 0x1b13, 0x416f, { 0xa8, 0x7b, 0xbc, 0x93, 0xd, 0xef, 0x92, 0xa8 }}
  56
  57   ## Include/Guid/MeasuredFvHob.h
  58   gMeasuredFvHobGuid                 = { 0xb2360b42, 0x7173, 0x420a, { 0x86, 0x96, 0x46, 0xca, 0x6b, 0xab, 0x10, 0x60 }}
  59
  60   ## Include/Guid/PhysicalPresenceData.h
  61   gEfiPhysicalPresenceGuid           = { 0xf6499b1, 0xe9ad, 0x493d, { 0xb9, 0xc2, 0x2f, 0x90, 0x81, 0x5c, 0x6c, 0xbc }}
  62
  63   ## Include/Guid/PwdCredentialProviderHii.h
  64   gPwdCredentialProviderGuid         = { 0x78b9ec8b, 0xc000, 0x46c5, { 0xac, 0x93, 0x24, 0xa0, 0xc1, 0xbb, 0x0, 0xce }}
  65
  66   ## Include/Guid/UsbCredentialProviderHii.h
  67   gUsbCredentialProviderGuid         = { 0xd0849ed1, 0xa88c, 0x4ba6, { 0xb1, 0xd6, 0xab, 0x50, 0xe2, 0x80, 0xb7, 0xa9 }}
  68
  69   ## Include/Guid/UserIdentifyManagerHii.h
  70   gUserIdentifyManagerGuid           = { 0x3ccd3dd8, 0x8d45, 0x4fed, { 0x96, 0x2d, 0x2b, 0x38, 0xcd, 0x82, 0xb3, 0xc4 }}
  71
  72   ## Include/Guid/UserProfileManagerHii.h
  73   gUserProfileManagerGuid            = { 0xc35f272c, 0x97c2, 0x465a, { 0xa2, 0x16, 0x69, 0x6b, 0x66, 0x8a, 0x8c, 0xfe }}
  74
  75   ## Include/Guid/TcgConfigHii.h
  76   gTcgConfigFormSetGuid              = { 0xb0f901e4, 0xc424, 0x45de, { 0x90, 0x81, 0x95, 0xe2, 0xb, 0xde, 0x6f, 0xb5 }}
  77
  78   ## Include/Guid/SecureBootConfigHii.h
  79   gSecureBootConfigFormSetGuid       = { 0x5daf50a5, 0xea81, 0x4de2, {0x8f, 0x9b, 0xca, 0xbd, 0xa9, 0xcf, 0x5c, 0x14}}
  80
  81   ## Include/Guid/TrEEPhysicalPresenceData.h
  82   gEfiTrEEPhysicalPresenceGuid = { 0xf24643c2, 0xc622, 0x494e, { 0x8a, 0xd, 0x46, 0x32, 0x57, 0x9c, 0x2d, 0x5b }}
  83
  84   ## Include/Guid/TpmInstance.h
  85   gEfiTpmDeviceInstanceNoneGuid      = { 0x00000000, 0x0000, 0x0000, { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 } }
  86   gEfiTpmDeviceInstanceTpm12Guid     = { 0x8b01e5b6, 0x4f19, 0x46e8, { 0xab, 0x93, 0x1c, 0x53, 0x67, 0x1b, 0x90, 0xcc } }
  87   gEfiTpmDeviceInstanceTpm20DtpmGuid = { 0x286bf25a, 0xc2c3, 0x408c, { 0xb3, 0xb4, 0x25, 0xe6, 0x75, 0x8b, 0x73, 0x17 } }
  88   gEfiTpmDeviceSelectedGuid          = { 0x7f4158d3, 0x74d, 0x456d, { 0x8c, 0xb2, 0x1, 0xf9, 0xc8, 0xf7, 0x9d, 0xaa } }
  89
  90   ## Include/Guid/TrEEConfigHii.h
  91   gTrEEConfigFormSetGuid              = {0xc54b425f, 0xaa79, 0x48b4, { 0x98, 0x1f, 0x99, 0x8b, 0x3c, 0x4b, 0x64, 0x1c }}
  92
  93 [Ppis]
  94   ## Include/Ppi/LockPhysicalPresence.h
  95   gPeiLockPhysicalPresencePpiGuid    = { 0xef9aefe5, 0x2bd3, 0x4031, { 0xaf, 0x7d, 0x5e, 0xfe, 0x5a, 0xbb, 0x9a, 0xd } }
  96
  97   ## Include/Ppi/TpmInitialized.h
  98   gPeiTpmInitializedPpiGuid      = { 0xe9db0d58, 0xd48d, 0x47f6, { 0x9c, 0x6e, 0x6f, 0x40, 0xe8, 0x6c, 0x7b, 0x41 }}
  99
 100   ## Include/Ppi/FirmwareVolumeInfoMeasurementExcluded.h
 101   gEfiPeiFirmwareVolumeInfoMeasurementExcludedPpiGuid = { 0x6e056ff9, 0xc695, 0x4364, { 0x9e, 0x2c, 0x61, 0x26, 0xf5, 0xce, 0xea, 0xae } }
 102
 103 [PcdsFixedAtBuild]
 104   ## Pcd for OptionRom.
 105   #  Image verification policy settings:
 106   #  ALWAYS_EXECUTE                         0x00000000
 107   #  NEVER_EXECUTE                          0x00000001
 108   #  ALLOW_EXECUTE_ON_SECURITY_VIOLATION    0x00000002
 109   #  DEFER_EXECUTE_ON_SECURITY_VIOLATION    0x00000003
 110   #  DENY_EXECUTE_ON_SECURITY_VIOLATION     0x00000004
 111   #  QUERY_USER_ON_SECURITY_VIOLATION       0x00000005
 112   #  NOTE: Do NOT use QUERY_USER_ON_SECURITY_VIOLATION since it violates the UEFI specification and has been removed.
 113   gEfiSecurityPkgTokenSpaceGuid.PcdOptionRomImageVerificationPolicy|0x04|UINT32|0x00000001
 114
 115   ## Pcd for removable media.
 116   #  Removable media include CD-ROM, Floppy, USB and network.
 117   #  Image verification policy settings:
 118   #  ALWAYS_EXECUTE                         0x00000000
 119   #  NEVER_EXECUTE                          0x00000001
 120   #  ALLOW_EXECUTE_ON_SECURITY_VIOLATION    0x00000002
 121   #  DEFER_EXECUTE_ON_SECURITY_VIOLATION    0x00000003
 122   #  DENY_EXECUTE_ON_SECURITY_VIOLATION     0x00000004
 123   #  QUERY_USER_ON_SECURITY_VIOLATION       0x00000005
 124   #  NOTE: Do NOT use QUERY_USER_ON_SECURITY_VIOLATION since it violates the UEFI specification and has been removed.
 125   gEfiSecurityPkgTokenSpaceGuid.PcdRemovableMediaImageVerificationPolicy|0x04|UINT32|0x00000002
 126
 127   ## Pcd for fixed media.
 128   #  Fixed media include hard disk.
 129   #  Image verification policy settings:
 130   #  ALWAYS_EXECUTE                         0x00000000
 131   #  NEVER_EXECUTE                          0x00000001
 132   #  ALLOW_EXECUTE_ON_SECURITY_VIOLATION    0x00000002
 133   #  DEFER_EXECUTE_ON_SECURITY_VIOLATION    0x00000003
 134   #  DENY_EXECUTE_ON_SECURITY_VIOLATION     0x00000004
 135   #  QUERY_USER_ON_SECURITY_VIOLATION       0x00000005
 136   #  NOTE: Do NOT use QUERY_USER_ON_SECURITY_VIOLATION since it violates the UEFI specification and has been removed.
 137   gEfiSecurityPkgTokenSpaceGuid.PcdFixedMediaImageVerificationPolicy|0x04|UINT32|0x00000003
 138
 139   ## Defer Image Load policy settings.
 140   #  The policy is bitwise.
 141   #  If bit is set, the image from corresponding device will be trust when loading.
 142   #
 143   # IMAGE_UNKNOWN                         0x00000001
 144   # IMAGE_FROM_FV                         0x00000002
 145   # IMAGE_FROM_OPTION_ROM                 0x00000004
 146   # IMAGE_FROM_REMOVABLE_MEDIA            0x00000008
 147   # IMAGE_FROM_FIXED_MEDIA                0x00000010
 148   gEfiSecurityPkgTokenSpaceGuid.PcdDeferImageLoadPolicy|0x0000001F|UINT32|0x0000004
 149
 150   ## The token file name used to save credential in USB credential provider driver.
 151   #  The specified file should be saved at the root directory of USB storage disk.
 152   gEfiSecurityPkgTokenSpaceGuid.PcdFixedUsbCredentialProviderTokenFileName|L"Token.bin"|VOID*|0x00000005
 153
 154   ## The size of Append variable buffer. This buffer is reserved for runtime use, OS can append data into one existing variable.
 155   gEfiSecurityPkgTokenSpaceGuid.PcdMaxAppendVariableSize|0x2000|UINT32|0x30000005
 156
 157   ## This PCD specifies the type of TCG platform that contains TPM chip.
 158   #  This PCD is only avaiable when PcdTpmPhysicalPresence is TRUE.
 159   #  If 0, TCG platform type is PC client.
 160   #  If 1, TCG platform type is server.
 161   gEfiSecurityPkgTokenSpaceGuid.PcdTpmPlatformClass|0|UINT8|0x00000006
 162
 163   ## The PCD is used to control whether to support hiding the TPM.
 164   #  If TRUE, PcdHideTpm controls whether to hide the TPM.
 165   gEfiSecurityPkgTokenSpaceGuid.PcdHideTpmSupport|FALSE|BOOLEAN|0x00000007
 166
 167 [PcdsDynamic, PcdsDynamicEx]
 168   ## The PCD is used to control whether to hide the TPM.
 169   gEfiSecurityPkgTokenSpaceGuid.PcdHideTpm|FALSE|BOOLEAN|0x00010002
 170
 171 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
 172   ## This PCD indicates the presence or absence of the platform operator.
 173   gEfiSecurityPkgTokenSpaceGuid.PcdTpmPhysicalPresence|TRUE|BOOLEAN|0x00010001
 174
 175 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
 176   ## This PCD indicates whether to set TPM physicalPresenceLifetimeLock bit.
 177   ## Once this bit is set, it can not be cleared (It is locked for TPM life time).
 178   gEfiSecurityPkgTokenSpaceGuid.PcdPhysicalPresenceLifetimeLock|FALSE|BOOLEAN|0x00010003
 179
 180 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
 181   ## This PCD is used to specify the default value for physicalPresenceCMDEnable bit when setting physicalPresenceLifetimeLock bit.
 182   ## If PcdPhysicalPresenceCmdEnable is set to TRUE, physicalPresenceCMDEnable bit will be set, else this bit will be cleared.
 183   gEfiSecurityPkgTokenSpaceGuid.PcdPhysicalPresenceCmdEnable|TRUE|BOOLEAN|0x00010004
 184
 185 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
 186   ## This PCD is used to specify the default value for physicalPresenceHWEnable bit when setting physicalPresenceLifetimeLock bit.
 187   ## If PcdPhysicalPresenceHwEnable is set to TRUE, physicalPresenceHWEnable bit will be set, else this bit will be cleared.
 188   gEfiSecurityPkgTokenSpaceGuid.PcdPhysicalPresenceHwEnable|TRUE|BOOLEAN|0x00010005
 189
 190 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
 191   ## This PCD indicates if debugger exists.
 192   gEfiSecurityPkgTokenSpaceGuid.PcdFirmwareDebuggerInitialized|FALSE|BOOLEAN|0x00010009
 193
 194   ## This PCD indicates the TPM2 initializatin policy.
 195   ## 0: No initialization needed - most likely used for chipset SRTM sloution, in which TPM is already initialized.
 196   ## 1: Initialization needed.
 197   gEfiSecurityPkgTokenSpaceGuid.PcdTpm2InitializationPolicy|1|UINT8|0x0001000A
 198
 199   ## This PCD indicates the TPM initializatin policy.
 200   ## 0: No initialization needed - most likely used for chipset SRTM sloution, in which TPM is already initialized.
 201   ## 1: Initialization needed.
 202   gEfiSecurityPkgTokenSpaceGuid.PcdTpmInitializationPolicy|1|UINT8|0x0001000B
 203
 204   ## This PCD indicates the TPM2 SelfTest policy.
 205   ## 0: No SelfTest needed - most likely used for fTPM, because it might already be tested.
 206   ## 1: SelfTest needed.
 207   gEfiSecurityPkgTokenSpaceGuid.PcdTpm2SelfTestPolicy|1|UINT8|0x0001000C
 208
 209   ## This PCD indicates the TPM2 SCRTM policy.
 210   ##   0: No SCRTM needed - In this case, it is already done.
 211   ##   1: SCRTM done by BIOS.
 212   gEfiSecurityPkgTokenSpaceGuid.PcdTpm2ScrtmPolicy|1|UINT8|0x0001000D
 213
 214   ## This PCD indicates the TPM SCRTM policy.
 215   ##   0: No SCRTM needed - In this case, it is already done.
 216   ##   1: SCRTM done by BIOS.
 217   gEfiSecurityPkgTokenSpaceGuid.PcdTpmScrtmPolicy|1|UINT8|0x0001000E
 218
 219   ## Guid name to identify TPM instance
 220   ## TPM_DEVICE_INTERFACE_NONE means disable
 221   ## TPM_DEVICE_INTERFACE_TPM12 means TPM1.2 DTPM
 222   ## TPM_DEVICE_INTERFACE_DTPM2 means TPM2 DTPM
 223   gEfiSecurityPkgTokenSpaceGuid.PcdTpmInstanceGuid |{ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }|VOID*|0x0001000F
 224
 225   ## This PCD indicates the TPM2 Hash mask.
 226   ##   BIT0: SHA1
 227   ##   BIT1: SHA256
 228   ##   BIT2: SHA384
 229   ##   BIT3: SHA512
 230   ## If this bit is set, that means this algorithm is needed to extend to PCR.
 231   ## If this bit is clear, that means this algorithm is NOT needed to extend to PCR.
 232   ## 0xFFFFFFFF means extend all.
 233   gEfiSecurityPkgTokenSpaceGuid.PcdTpm2HashMask|0xFFFFFFFF|UINT32|0x00010010
 234
 235   ## This PCD indicates if BIOS auto detect TPM1.2 or dTPM2.0.
 236   ## 0: No auto detection.
 237   ## 1: Auto detection.
 238   gEfiSecurityPkgTokenSpaceGuid.PcdTpmAutoDetection|TRUE|BOOLEAN|0x00010011
 239
 240   ## This PCD indicates TPM base address.
 241   gEfiSecurityPkgTokenSpaceGuid.PcdTpmBaseAddress|0xFED40000|UINT64|0x00010012