Skip to content

Latest commit

 

History

History

verifier-risczero

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Marlin Oyster Logo

Attestation Verifier - RiscZero

This project implements a RiscZero based AWS Nitro Enclave attestation verifier.

While it produces zero false positives, it does not aim to produce zero false negatives, i.e. it could reject theoretically valid attestations. Instead, it asserts specific attestation formats that are actually used in order to optimize proving time. It also does not verify any extensions in the certificates as it was deemed unnecessary.

Build

Install the RiscZero tooling before proceeding further.

Note: Requires CUDA by default. It is possible to disable CUDA by disabling the relevant feature in host/Cargo.toml, but the proof generation process could take hours on a CPU.

cargo build --release

Reproducible builds

Reproducible builds are enabled for the guest to produce a consistent GUEST_ID.

Expected GUEST_ID: 0xe3a724c82707d022c50fcb8e8c807f54dc9a11b73a83462b52b6d725462f83e7

Usage

$ ./target/release/host --help
GUEST: 0xe3a724c82707d022c50fcb8e8c807f54dc9a11b73a83462b52b6d725462f83e7
Usage: host --url <URL>

Options:
  -u, --url <URL>  
  -h, --help       Print help
  -V, --version    Print version

It takes in a URL to an attestation server producing binary attestations.

Journal format

The journal contains bytes in the following order:

  • 8 byte timestamp in milliseconds from the attestation
  • 48 byte PCR0
  • 48 byte PCR1
  • 48 byte PCR2
  • 96 byte public key from the root certificate
  • 1 byte length of the public key from the attestation
  • N byte public key from the attestation
  • 2 byte length of the user data
  • N byte user data

Directory Structure

project_name
├── Cargo.toml
├── host
│   ├── Cargo.toml                     <-- [Disable CUDA here]
│   └── src
│       └── main.rs                    <-- [Host code goes here]
└── methods
    ├── Cargo.toml
    ├── build.rs                       <-- [Reproducible guest builds stuff here]
    ├── guest
    │   ├── Cargo.toml
    │   └── src
    │       └── method_name.rs         <-- [Guest code goes here]
    └── src
        └── lib.rs

License

This project is licensed under the GNU AGPLv3 or any later version. See LICENSE.txt.