dingelish / SEVAttestation

SEVAttestation

This project contains all the tools and scripts required to perform SEV attestation and injection of a secret.

Dependencies

1. QEMU version 6.1 https://www.qemu.org/download/#source (released on August 24, 2021) - None of the previous versions support attestation and secret injection capabilites

How to run

0. Apply patches and build grub, then include this grub in the patched OVMF build.

1. git clone [e-mail]:khushboo-dfn/SEVAttestation.git

2. cd SEVAttestation

3. Prepare image

   • Get an Ubuntu server image
     wget https://cloud-images.ubuntu.com/focal/current/focal-server-cloudimg-amd64.img (Rename it to ubuntu-server.img)
   • Prepare iso
     • create a metadata file with the desired instance ID and hostname:

      $ cat > metadata.yaml <<EOF  
      instance-id: iid-local01  
      local-hostname: cloudimg  
      EOF
     

     • Next, create a user data file to provide the SSH key to the instance. The example below uses cloud-init’s cloud-config to pass this information to automatically add the key to the default user.

      $ cat > user-data.yaml <<EOF  
      #cloud-config  
      ssh_authorized_keys:  
         - ssh-rsa AAAAB3NzaC1yc2EAAAABIwJJJQEA3I7VUf3l5gSn5uavROsc5HRDpZ ...  
      EOF
     

     • Finally, generate the seed image that combines the metadata and user data files:
       sudo cloud-localds ubuntu-server.iso user-data.yaml metadata.yaml
       Note: In order to test an end-to-end solution for encrypted disk image, following this article: https://opencraft.com/blog/tutorial-encrypting-an-existing-root-partition-in-ubuntu-with-dm-crypt-and-luks/ to encrypt the image. The secret injected will be able to decrypt the image. To test with an already encrypted image, please contact the author.

4. Launch a QEMU image using launch_qemu_image script
   ./launch_qemu_image.sh

5. In another terminal, connect to the QEMU instance using QMP
   telnet 127.0.0.1 5550

6. Run the following commands:
   { "execute": "qmp_capabilities" }
{"return": {}}

   { "execute": "query-sev" }
{"return": {"enabled": true, "api-minor": 22, "handle": 1, "state": "launch-secret", "api-major": 0, "build-id": 13, "policy": 1}}

   { "execute": "query-sev-launch-measure" }
{"return": {"data": "7vHlsVKpvBaUHU5jzpNtfLMFAljbBnVrkqO51p3Ny3sZHribEtvolLvSRs0SqW8a"}}
   Record these results to pass to the script in next step.

7. In a third terminal, prepare a secret using secret.py --passwd <Encryption key>.

8. Run the script to verify attestation
   ./verify_attestation.sh -p secret_file_to_be_injected -m 7vHlsVKpvBaUHU5jzpNtfLMFAljbBnVrkqO51p3Ny3sZHribEtvolLvSRs0SqW8a
   This script assumes sev info parameters, location of qemu and OVMF.fd as default but they can be specified. Run ./verify_attestation.sh -h to find arguments.

9. Inject secret via qmp
   { "execute": "sev-inject-launch-secret", "arguments": { "packet-header": "AAAAAI0M2R8bw40sg0Hu8PsGRf2LGHcBJcECXCFgkTgnHU4VCLMWx8tz8iAEuW4IKQl/BA==", "secret": "usNTvLEGVvtB2rMHCw=="}}
{"return": {}}

10. Continue to launch the guest VM
    { "execute": "cont"}

11. Login with SSH
    ssh -o "StrictHostKeyChecking no" -p 2222 ubuntu@0.0.0.0

Supporting blogs/articles

1. How to mount a cqow image: https://docs.j7k6.org/mount-qcow2-disk-image-linux/
2. Confidential Computing with AMD SEV: https://blog.hansenpartnership.com/building-encrypted-images-for-confidential-computing/#easy-footnote-bottom-2-1196