We present a Web3 implementation of the Intel SGX DCAP V3 attestation using on-chain capabilities, available at on-chain Intel SGX DCAP v3 attestation repo. This implementation aims to transition the DCAP attestation verification process from an off-chain entity to a decentralized on-chain environment. However, a notable drawback is its reliance on the contract owner to periodically upload verification collaterals to fulfill the attestation requirements. Additionally, the manually uploaded collaterals lack Trusted Computing Base (TCB) signature verification, rendering them insecure. Any compromise of the contract owner jeopardizes all verification processes.
To address this vulnerability, we introduce an on-chain implementation of the Intel SGX DCAP attestation Provisioning Certification Caching Service (PCCS) here. This service enables both the quote generator and verifier to conveniently fetch and upload collaterals through smart contracts. To enhance security, we incorporate read/write validation for all uploaded collaterals before inserting them to the on-chain PCCS. Simultaneously, we are releasing the Automata DCAP Attestation as the next iteration of the Automata DCAP V3 attestation, as mentioned in the previous paragraph, to streamline the verification process while providing enhanced security and availability guarantees.
Within this repository, two key components are featured:
- Automata DCAP QPL LIB: The customized platform quote provider library when generating and verifying the Intel SGX / TDX DCAP attestation quote. It will try to fetch the necessary collaterals from on-chain PCCS, and if cache miss, it will try to use cloud provider PCCS as the fallback option, and use Intel PCS as the final fallback choice.
- Automata DCAP QPL TOOL: This tool facilitates interaction with the on-chain registry, enabling quote generators to upload necessary collaterals for use in both quote generation and verification processes.
Take Automata SGX Scaffold repo as the example to demonstrate how to use this lib and tool.
- Build the lib with the following commands, you can find the lib at
automata-dcap-qpl/automata-dcap-qpl-lib/target/releasepath.
$ git clone [email protected]:automata-network/automata-dcap-qpl.git
$ cd automata-dcap-qpl-lib
$ cargo build --release
- Move the lib to override the default platform quote provider library, please make sure you already follow the Automata SGX Scaffold tutorial to setup the environment.
$ for f in /usr/lib/x86_64-linux-gnu/libdcap_quoteprov.so*; do sudo mv "$f" "$f.bak"; done
$ cd automata-dcap-qpl/automata-dcap-qpl-lib/target/release
$ sudo cp libautomata_dcap_qpl.so /usr/lib/x86_64-linux-gnu/libdcap_quoteprov.so
- Build and run the SGX Scaffold, find more details at Automata SGX Scaffold repo.
$ cd sgx-scaffold
$ cargo sgx build
$ cargo sgx run
| variables | description | default value |
|---|---|---|
| AUTOMATA_DCAP_COLLATERAL_VERSION | The API version of the collateral and quote | "v3" |
| INTEL_PCS_SUBSCRIPTION_KEY | The subscription key to be used when fallback to Intel PCS API | empty |
Build the tool and upload the necessary collaterals on chain to satisfy the quote generation and verification requirements, you need to prepare a wallet with enough balance in Automata Testnet for the transactions.
Use ./automata-dcap-qpl-tool -h to see the details, or edit the code to set the necessary inputs.
Example: Use the quote to check whether there is any missing collateral on-chain, and the tool will help you to fetch and upsert it before you perform the on-chain verification.
cd automata-dcap-qpl-tool
source env/automata_testnet
./target/release/automata-dcap-qpl-tool --quote_hex <quote hex string> -p <wallet_private_key> --chain_id=$CHAIN_ID --rpc_url=$RPC_URL
See C.1. section in Intel SGX ECDSA Quote Lib Reference DCAP API.
| variables | description | default value |
|---|---|---|
| INTEL_PCS_SUBSCRIPTION_KEY | The subscription key to be used when fallback to Intel PCS API | empty |
- Use Azure PCCS as the fallback option when the collaterals are not available in on-chain PCCS, make sure you're executing the enclave in Azure VM and install the Azure DCAP client.
- Use Intel PCS as the final fallback option, you should specify your
Ocp-Apim-Subscription-KeytoINTEL_PCS_SUBSCRIPTION_KEYenvironment variable before using it.
| Contract | Address |
|---|---|
| DCAP_ATTESTATION | 0xefE368b17D137E86298eec8EbC5502fb56d27832 |
| PCCS_ROUTER | 0xbFDeE7A1f1bFA2267cD0DA50BE76D8c4a3864543 |
| PCCS_Storage | 0xe8599DD2366230B7EfDD526985c64C7325b27569 |
| V3_VERIFIER | 0x67042D171b8B7Da1A4a98Df787bDce79190DAc3c |
| V4_VERIFIER | 0x921B8F6Ec83E405B715111eC1AE8B54A3ea063EB |
| ENCLAVE_ID_DAO | 0x45f91C0d9Cf651785d93fcF7e9E97dE952CdB910 |
| FMSPC_TCB_DAO | 0x9c54C72867b07caF2e6255CE32983c28aFE40F26 |
| PCK_DAO | 0x722525B96b62e182F8A095af0a79d4EA2037795C |
| PCS_DAO | 0xcf171ACd6c0a776f9d3E1F6Cac8067c982Ac6Ce1 |
| ENCLAVE_IDENTITY_HELPER | 0xfd4a34b578B352FE1896CDafaEb0f45f993352Bf |
| FMSPC_TCB_HELPER | 0xC2A662e08A35513596E22D0aC236Ce72e59125EE |
| PCK_HELPER | 0x5213c0e3Ab478dbc83E8afFF8909717332E4f8E1 |
| CRL_HELPER | 0x12C1E13Aa2a238EAb15c2e2b6AC670266bc3C814 |
| Contract | Address |
|---|---|
| DCAP_ATTESTATION | 0xE26E11B257856B0bEBc4C759aaBDdea72B64351F |
| PCCS_ROUTER | 0xb76834729717868fa203b9D90fc88F859A4E594D |
| PCCS_STORAGE | 0xE2636fdbd053da8E798D959304e20fADa934E8c0 |
| V3_VERIFIER | 0xF38a49322cAA0Ead71D4B1cF2afBb6d02BE5FC96 |
| V4_VERIFIER | 0xfF47ecA64898692a86926CDDa794807be3f6567D |
| ENCLAVE_ID_DAO | 0x45f91C0d9Cf651785d93fcF7e9E97dE952CdB910 |
| FMSPC_TCB_DAO | 0x9c54C72867b07caF2e6255CE32983c28aFE40F26 |
| PCK_DAO | 0x31F18aA7B4cbAD7A726BCBF5AB3e286fC0b02A82 |
| PCS_DAO | 0xcf171ACd6c0a776f9d3E1F6Cac8067c982Ac6Ce1 |
| ENCLAVE_IDENTITY_HELPER | 0x13BECaa512713Ac7C2d7a04ba221aD5E02D43DFE |
| FMSPC_TCB_HELPER | 0xc99bF04C31bF3d026B5B47b2574FC19C1459B732 |
| X509_HELPER | 0x3e2fe733E444313A93Fa3f9AEd3bB203048dDE70 |
| X509_CRL_HELPER | 0x2567245dE6E349C8B7AA82fD6FF854b844A0aEF9 |
| Contract | Address |
|---|---|
| DCAP_ATTESTATION | 0x133303659F51d75ED216FD98a0B70CbCD75339b2 |
| PCCS_ROUTER | 0xdE5e69A2ca2556fe46883d754d987703bF28Cc51 |
| V3_VERIFIER | 0x12d7d59Ae1e4dbF83b08C82958Ac3FcEB84fB164 |
| V4_VERIFIER | 0x3Cb24c454a29e796edF47a96dF32DD1855058258 |
| ENCLAVE_ID_DAO | 0x45f91C0d9Cf651785d93fcF7e9E97dE952CdB910 |
| FMSPC_TCB_DAO | 0x9c54C72867b07caF2e6255CE32983c28aFE40F26 |
| PCK_DAO | 0x31F18aA7B4cbAD7A726BCBF5AB3e286fC0b02A82 |
| PCS_DAO | 0xcf171ACd6c0a776f9d3E1F6Cac8067c982Ac6Ce1 |
| Contract | Address |
|---|---|
| DCAP_ATTESTATION | 0x76A3657F2d6c5C66733e9b69ACaDadCd0B68788b |
| PCCS_ROUTER | 0xdc7dcF60b9580980128539Ed805D03BC60F84fd4 |
| V3_VERIFIER | 0x85E156d702bb3e45690DAa812238C1A841E2c3C5 |
| V4_VERIFIER | 0xdc25e1c7ACAdBdE8C1E2c2b9511B7Dbd98B44700 |
| ENCLAVE_ID_DAO | 0x4bb680A5e6Ad6228E7d334903B0Ce10EF60c961C |
| FMSPC_TCB_DAO | 0xF790b1C23e6508A6135Ce88450eC0A59Af0B9896 |
| PCK_DAO | 0x3eA9D905Cb79586C2184f329e6a651D97F2ebee3 |
| PCS_DAO | 0x348DA46aA11188f641f01dbe247b25FFA5FFB9c4 |
- Automata On Chain PCCS
- Automata DCAP Attestation
- Automata On-chain PCCS Reader
- SGX DCAP Caching Service Design Guide
- Intel SGX ECDSA Quote Lib Reference DCAP API
- DCAP ECDSA Orientation
- Intel PCS API
Before You Contribute:
- Raise an Issue: If you find a bug or wish to suggest a feature, please open an issue first to discuss it. Detail the bug or feature so we understand your intention.
- Pull Requests (PR): Before submitting a PR, ensure:
- Your contribution successfully builds.
- It includes tests, if applicable.
Apache License