acrn-hypervisor/hypervisor/include/lib
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
..
crypto hv: Derive decryption key from Seed for Trusty to decrypt attestation keybox 2018-11-20 09:22:37 +08:00
atomic.h hv: Remove the up_count_spinlock and use atomic for up_count 2018-11-02 10:43:50 +08:00
bits.h HV:add const to bitmap_test parameter addr 2018-10-25 13:45:14 +08:00
errno.h license: Replace license text with SPDX tag 2018-06-01 10:43:06 +08:00
list.h HV:fix "Pointer param should be declared pointer to const" 2018-10-25 13:45:14 +08:00
mem_mgt.h hv: mmu: remove alloc_page() API 2018-11-02 13:15:48 +08:00
rtl.h hv: fix integer violations 2018-10-31 15:01:57 +08:00
spinlock.h hv: clean up spinlock 2018-09-14 09:44:44 +08:00
sprintf.h fix "Casting operation to a pointer" 2018-11-06 13:37:33 +08:00
types.h hv: remove unused MACROs 2018-09-18 09:43:43 +08:00
util.h hv: clean up some header files 2018-09-13 13:11:57 +08:00