14 #error "enclave.h and host.h must not be included in the same compilation unit." 17 #include "bits/defs.h" 55 bool is_first_handler,
222 void __oe_assert_fail(
238 #define oe_assert(EXPR) \ 242 __oe_assert_fail(#EXPR, __FILE__, __LINE__, __FUNCTION__); \ 245 #define oe_assert(EXPR) 248 #if (OE_API_VERSION < 2) 249 #define oe_get_report oe_get_report_v1 251 #define oe_get_report oe_get_report_v2 287 const uint8_t* report_data,
288 size_t report_data_size,
289 const void* opt_params,
290 size_t opt_params_size,
291 uint8_t* report_buffer,
292 size_t* report_buffer_size);
319 const uint8_t* report_data,
320 size_t report_data_size,
321 const void* opt_params,
322 size_t opt_params_size,
323 uint8_t** report_buffer,
324 size_t* report_buffer_size);
333 #if (OE_API_VERSION < 2) 334 #define oe_get_target_info oe_get_target_info_v1 336 #define oe_get_target_info oe_get_target_info_v2 365 const uint8_t* report,
367 void* target_info_buffer,
368 size_t* target_info_size);
391 const uint8_t* report,
393 void** target_info_buffer,
394 size_t* target_info_size);
420 const uint8_t* report,
442 const uint8_t* report,
446 #if (OE_API_VERSION < 2) 447 #define oe_get_seal_key_by_policy oe_get_seal_key_by_policy_v1 449 #define oe_get_seal_key_by_policy oe_get_seal_key_by_policy_v2 484 size_t* key_buffer_size,
486 size_t* key_info_size);
513 uint8_t** key_buffer,
514 size_t* key_buffer_size,
516 size_t* key_info_size);
518 #if (OE_API_VERSION < 2) 519 #define oe_get_seal_key oe_get_seal_key_v1 521 #define oe_get_seal_key oe_get_seal_key_v2 548 const uint8_t* key_info,
549 size_t key_info_size,
551 size_t* key_buffer_size);
576 uint8_t** key_buffer,
577 size_t* key_buffer_size,
579 size_t* key_info_size);
599 const uint8_t* key_info,
600 size_t key_info_size,
601 uint8_t** key_buffer,
602 size_t* key_buffer_size);
627 uint8_t** key_buffer,
628 size_t* key_buffer_size,
630 size_t* key_info_size);
650 const uint8_t* key_info,
651 size_t key_info_size,
652 uint8_t** key_buffer,
653 size_t* key_buffer_size);
666 size_t key_buffer_size,
668 size_t key_info_size);
690 const uint8_t* key_info,
691 size_t key_info_size,
692 uint8_t** key_buffer,
693 size_t* key_buffer_size);
void * oe_host_malloc(size_t size)
Allocate bytes from the host's heap.
void oe_free_report(uint8_t *report_buffer)
Frees a report buffer obtained from oe_get_report.
enum _oe_seal_policy oe_seal_policy_t
This enumeration type defines the policy used to derive a seal key.
oe_result_t oe_get_public_key(const oe_asymmetric_key_params_t *key_params, const uint8_t *key_info, size_t key_info_size, uint8_t **key_buffer, size_t *key_buffer_size)
Returns a public key that is associated with the identity of the enclave.
This file defines the types used by the OE SDK.
void oe_host_free(void *ptr)
Release allocated memory.
oe_result_t oe_random(void *data, size_t size)
Generate a sequence of random bytes.
Structure to hold the parsed form of a report.
Definition: report.h:112
void oe_abort(void)
Abort execution of the enclave.
oe_result_t oe_get_private_key_by_policy(oe_seal_policy_t seal_policy, const oe_asymmetric_key_params_t *key_params, uint8_t **key_buffer, size_t *key_buffer_size, uint8_t **key_info, size_t *key_info_size)
Returns a private key that is associated with the identity of the enclave and the specified policy...
void oe_free_target_info(void *target_info)
Frees target info obtained from oe_get_target_info.
void * oe_host_calloc(size_t nmemb, size_t size)
Allocate zero-filled bytes from the host's heap.
oe_result_t oe_verify_report(const uint8_t *report, size_t report_size, oe_report_t *parsed_report)
Verify the integrity of the report and its signature.
oe_result_t oe_get_seal_key_by_policy_v1(oe_seal_policy_t seal_policy, uint8_t *key_buffer, size_t *key_buffer_size, uint8_t *key_info, size_t *key_info_size)
Get a symmetric encryption key derived from the specified policy and coupled to the enclave platform...
oe_result_t oe_get_report_v2(uint32_t flags, const uint8_t *report_data, size_t report_data_size, const void *opt_params, size_t opt_params_size, uint8_t **report_buffer, size_t *report_buffer_size)
Get a report signed by the enclave platform for use in attestation.
This file defines data structures to set up vectored exception handlers in the enclave.
oe_result_t oe_get_seal_key_v2(const uint8_t *key_info, size_t key_info_size, uint8_t **key_buffer, size_t *key_buffer_size)
Get a symmetric encryption key from the enclave platform using existing key information.
This file defines Open Enclave return codes (results).
enum _oe_result oe_result_t
This enumeration type defines return codes for Open Enclave functions.
char * oe_host_strndup(const char *str, size_t n)
Make a heap copy of a string.
This struct contains the parameters for asymmetric key derivation.
Definition: types.h:198
uint64_t(* oe_vectored_exception_handler_t)(oe_exception_record_t *exception_context)
oe_vectored_exception_handler_t - Function pointer for a vectored exception handler in an enclave...
Definition: exception.h:160
oe_result_t oe_get_report_v1(uint32_t flags, const uint8_t *report_data, size_t report_data_size, const void *opt_params, size_t opt_params_size, uint8_t *report_buffer, size_t *report_buffer_size)
Get a report signed by the enclave platform for use in attestation.
void oe_free_key(uint8_t *key_buffer, size_t key_buffer_size, uint8_t *key_info, size_t key_info_size)
Frees the given key and/or key info.
void oe_free_seal_key(uint8_t *key_buffer, uint8_t *key_info)
Frees a key and/or key info.
This file defines the properties for an enclave.
oe_result_t oe_get_private_key(const oe_asymmetric_key_params_t *key_params, const uint8_t *key_info, size_t key_info_size, uint8_t **key_buffer, size_t *key_buffer_size)
Returns a private key that is associated with the identity of the enclave.
oe_result_t oe_remove_vectored_exception_handler(oe_vectored_exception_handler_t vectored_handler)
Remove an existing vectored exception handler.
oe_result_t oe_get_public_key_by_policy(oe_seal_policy_t seal_policy, const oe_asymmetric_key_params_t *key_params, uint8_t **key_buffer, size_t *key_buffer_size, uint8_t **key_info, size_t *key_info_size)
Returns a public key that is associated with the identity of the enclave and the specified policy...
bool oe_is_within_enclave(const void *ptr, size_t size)
Check whether the given buffer is strictly within the enclave.
oe_result_t oe_get_seal_key_v1(const uint8_t *key_info, size_t key_info_size, uint8_t *key_buffer, size_t *key_buffer_size)
Get a symmetric encryption key from the enclave platform using existing key information.
oe_enclave_t * oe_get_enclave(void)
Obtains the enclave handle.
void * oe_host_realloc(void *ptr, size_t size)
Reallocate bytes from the host's heap.
oe_result_t oe_get_target_info_v2(const uint8_t *report, size_t report_size, void **target_info_buffer, size_t *target_info_size)
Extracts additional platform specific data from the report and writes it to target_info_buffer.
oe_result_t oe_add_vectored_exception_handler(bool is_first_handler, oe_vectored_exception_handler_t vectored_handler)
Register a new vectored exception handler.
oe_result_t oe_parse_report(const uint8_t *report, size_t report_size, oe_report_t *parsed_report)
Parse an enclave report into a standard format for reading.
bool oe_is_outside_enclave(const void *ptr, size_t size)
Check whether the given buffer is strictly outside the enclave.
oe_result_t oe_get_seal_key_by_policy_v2(oe_seal_policy_t seal_policy, uint8_t **key_buffer, size_t *key_buffer_size, uint8_t **key_info, size_t *key_info_size)
Get a symmetric encryption key derived from the specified policy and coupled to the enclave platform...
struct _oe_enclave oe_enclave_t
This is an opaque handle to an enclave returned by oe_create_enclave().
Definition: types.h:134
oe_result_t oe_get_target_info_v1(const uint8_t *report, size_t report_size, void *target_info_buffer, size_t *target_info_size)
Extracts additional platform specific data from the report and writes it to target_info_buffer.
This file defines structures and options passed to oe_get_report functions.