This patchset is also available at: https://github.com/amdese/linux/commits/snp-certs-v2 and is based on top of kvm/next (d96c77bd4eeb) v1 of these patches were originally included as part of a larger series that went upstream without the certificate support included: https://lore.kernel.org/lkml/20240621134041.3170480-1-michael.roth@xxxxxxx/ Overview -------- The GHCB 2.0 specification defines 2 GHCB request types to allow SNP guests to send encrypted messages/requests to firmware: SNP Guest Requests and SNP Extended Guest Requests. These encrypted messages are used for things like servicing attestation requests issued by the guest. Implementing support for these is required to be fully GHCB-compliant. For the most part, KVM only needs to handle forwarding these requests to firmware (to be issued via the SNP_GUEST_REQUEST firmware command defined in the SEV-SNP Firmware ABI), and then forwarding the encrypted response to the guest. However, in the case of SNP Extended Guest Requests, the host is also able to provide the certificate data corresponding to the endorsement key used by firmware to sign attestation report requests. This certificate data is provided by userspace because: 1) It allows for different keys/key types to be used for each particular guest with requiring any sort of KVM API to configure the certificate table in advance on a per-guest basis. 2) It provides additional flexibility with how attestation requests might be handled during live migration where the certificate data for source/dest might be different. 3) It allows all synchronization between certificates and firmware/signing key updates to be handled purely by userspace rather than requiring some in-kernel mechanism to facilitate it. [1] To support fetching certificate data from userspace, a new KVM exit type is used to fetch the data similarly to KVM_EXIT_MMIO/etc. Since there is potential for more CoCo-related exits, this series implements this as a more general KVM_EXIT_COCO exit type, where individual sub-types can be enabled similarly to how KVM_EXIT_HYPERCALL/KVM_CAP_EXIT_HYPERCALL are handled, and then introduces the KVM_EXIT_COCO_REQ_CERTS sub-type to implement certficate handling. [1] https://lore.kernel.org/kvm/ZS614OSoritrE1d2@xxxxxxxxxx/ Testing ------- For testing this via QEMU, use the following tree: https://github.com/amdese/qemu/commits/snp-certs-wip1 A basic command-line invocation for SNP with certificate data supplied would be: qemu-system-x86_64 -smp 32,maxcpus=255 -cpu EPYC-Milan-v2 -machine q35,confidential-guest-support=sev0,memory-backend=ram1 -object memory-backend-memfd,id=ram1,size=4G,share=true,reserve=false -object sev-snp-guest,id=sev0,cbitpos=51,reduced-phys-bits=1,id-auth=,certs-path=/home/mroth/cert.blob -bios OVMF.fd The format of the certificate blob is defined in the GHCB 2.0 specification, but if it's not being parsed on the guest-side then random data will suffice for testing the KVM bits. Any feedback/review is appreciated. Thanks! -Mike Changes since v1: * Drop subtype-specific error codes. Instead use standard error codes like ENOSPC/etc. and let KVM determine whether a particular error requires special handling for a particular KVM_EXIT_COCO subtype. (Sean) * Introduce special handling for EAGAIN for KVM_EXIT_COCO_REQ_CERTS such that the guest can be instructed to retry if userspace is temporarily unable to immediately lock/provide the certificate data. (Sean) * Move the 'ret' field of struct kvm_exit_coco to the top-level so all sub-types can propagate error codes the same way. * Add more clarifying details in KVM documentation about the suggested file-locking scheme to avoid races between certificate requests and updates to SNP firmware that might modify the endorsement key corresponding to the certificate data. Changes since splitting this off from v15 SNP KVM patchset: * Address clang-reported warnings regarding uninitialized variables * Address a memory leak of the request/response buffer pages, and refactor the code based on Sean's suggestions: https://lore.kernel.org/kvm/ZktbBRLXeOp9X6aH@xxxxxxxxxx/ * Fix SNP Extended Guest Request handling to only attempt to fetch certificates if handling MSG_REQ_REPORT (attestation) message types * Drop KVM_EXIT_VMGEXIT and introduce KVM_EXIT_COCO events instead * Refactor patch layout for easier handling/review ---------------------------------------------------------------- Michael Roth (2): KVM: Introduce KVM_EXIT_COCO exit type KVM: SEV: Add certificate support for SNP_EXTENDED_GUEST_REQUEST events Documentation/virt/kvm/api.rst | 119 ++++++++++++++++++++++++++++++++++++++++ arch/x86/include/asm/kvm_host.h | 1 + arch/x86/kvm/svm/sev.c | 44 +++++++++++++-- arch/x86/kvm/x86.c | 13 +++++ include/uapi/linux/kvm.h | 19 +++++++ include/uapi/linux/sev-guest.h | 8 +++ 6 files changed, 198 insertions(+), 6 deletions(-)
