acrn-hypervisor/hypervisor/include
Chen, Gang G fc9ec5d88f hv: Derive decryption key from Seed for Trusty to decrypt attestation keybox
CSE FW uses an AEK (Attestation keybox Encryption Key) to encrypt the keybox
with AES-256-GCM algorithm before sending it to Android/Trusty. This key is
derived from the latest platform Seed by CSE FW with KDF (key derivation function)
HMAC-SHA256. After Trusty retrieves this encrypted keybox over HECI/MEI driver,
Trusty needs the same AEKkey to decrypt it. Hence, before Trusty launches,
Hypervisor derives the same AEK key from Platform Seed with the same algorithm
and the same derivation parameters, then sends this AEK along with Trusty vSeed
to Trusty world memory.

Since Platform Seed is only visible to Hypervisor and it must not be
sent to any guest VM, only Hypervisor can derive this AEK from this
Platform Seed, just like previous per-Trusty virtual Seed derivation.
Please note that Android Attestation Keybox is shared in a single hardware
platform, so all the Trusty instance/world can get the same AEK for
decryption even if there are multiple Android User OS/VMs running
on top of Hypervisor.

v1 --> v2:
	Add detailed description why we need the patch to derive an extra key

v2 --> v3:
	Convert API descriptions to Doxygen

Tracked-On: #1812
Reviewed-by: Bing Zhu <bing.zhu@intel.com>
Reviewed-by: Kai Wang <kai.z.wang@intel.com>
Signed-off-by: Chen Gang G <gang.g.chen@intel.com>
Acked-by: Bing Zhu <bing.zhu@intel.com>
2018-11-20 09:22:37 +08:00
..
arch/x86 hv: separate the PCI CONFIG_ADDR and CONFIG_DATA I/O port handlers 2018-11-19 09:34:34 +08:00
common hv: fix integer violations 2018-11-14 12:46:34 +08:00
debug HV: Add vuart port base address/IRQ Kconfig options 2018-11-16 10:24:48 +08:00
dm hv: fix 'Expression is not Boolean' 2018-11-08 13:04:11 +08:00
lib hv: Derive decryption key from Seed for Trusty to decrypt attestation keybox 2018-11-20 09:22:37 +08:00
public hv: hypercall: remove hcall_set_vm_memory_region 2018-11-08 13:04:27 +08:00
hv_debug.h HV: Added Initial support for SEP/SOCWATCH profiling 2018-10-26 13:39:07 +08:00
hypervisor.h HV:treewide:rename vm data structure 2018-11-05 15:35:49 +08:00