-
Notifications
You must be signed in to change notification settings - Fork 214
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add documentation and test for new oeverify tool #1761
Changes from all commits
84cec04
7eb5540
929a738
f22a1b2
71d2c67
b884a6f
fadfdee
722d833
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -10,17 +10,22 @@ First, the client should connect to the node to verify, specifying the ``/node/q | |
$ curl https://<ccf-node-address>/node/quote --cacert networkcert.pem | ||
{"quotes": [{"mrenclave":"<measurement_hash>, "node_id":<node_id>, "raw":"<hex_encoded_raw_quote>"}]} | ||
|
||
The raw quote should be decoded and output to file for verification via the Open Enclave ``host_verify`` command-line utility: | ||
The raw quote should be decoded and output to file for verification via the Open Enclave ``oeverify`` command-line utility: | ||
|
||
.. code-block:: bash | ||
|
||
$ curl https://<ccf-node-address>/node/quote --cacert networkcert.pem | jq .quotes[0].raw | xxd -r -p > ccf_node_quote.bin | ||
$ curl https://<ccf-node-address>/node/quote --cacert networkcert.pem | jq .raw | xxd -r -p > ccf_node_quote.bin | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. General question here: Do we want to still refer to CCF node's quotes as "quotes" (SGX terminology) or Open Enclave's more generic "evidences"? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Let's stick with quote for now, there's enough renaming going on at the moment, and there's no short term prospect of using anything other than SGX. |
||
|
||
$ /opt/openenclave/bin/host_verify -r ccf_node_quote.bin | ||
Verifying report ccf_node_quote.bin... | ||
Report verification succeeded (0). | ||
$ /opt/openenclave/bin/oeverify -r ccf_node_quote.bin -f LEGACY_REPORT_REMOTE | ||
Verifying evidence ccf_node_quote.bin... | ||
Claims: | ||
Enclave unique_id: <ccf_node_mrenclave> | ||
Enclave signer_id: <ccf_node_mrsigner> | ||
Enclave product_id: <ccf_node_product_id> | ||
Enclave sgx_report_data: <ccf_node_report_data> | ||
Evidence verification succeeded (0) | ||
|
||
.. note:: The ``host_verify`` CLI is included in the Open Enclave ``hostverify`` package available on the `Open Enclave release page <https://github.com/openenclave/openenclave/releases>`_. | ||
.. note:: The ``oeverify`` CLI is included in the Open Enclave ``hostverify`` package available on the `Open Enclave release page <https://github.com/openenclave/openenclave/releases>`_. | ||
|
||
The SGX quotes of all currently trusted nodes can also be retrieved via the ``/node/quotes`` endpoint: | ||
|
||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would prefer we avoid reformatting unless we have an automatic formatter, such as markdownlint.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
https://github.com/DavidAnson/markdownlint looks like a plausible choice.