attester.h

Go to the documentation of this file.

// Copyright (c) Open Enclave SDK contributors.
// Licensed under the MIT License.
 
#ifndef _OE_ATTESTATION_ATTESTER_H
#define _OE_ATTESTATION_ATTESTER_H
 
#ifdef _OE_HOST_H
 
#error "The header attester.h is only available for the enclave."
 
#else // _OE_HOST_H
 
#include <openenclave/bits/evidence.h>
#include <openenclave/bits/result.h>
#include <openenclave/bits/types.h>
 
OE_EXTERNC_BEGIN
 
#define OE_EVIDENCE_FLAGS_EMBED_FORMAT_ID 0x00000001
 
oe_result_t oe_attester_initialize(void);
 
oe_result_t oe_attester_select_format(
    const oe_uuid_t* format_ids,
    size_t format_ids_length,
    oe_uuid_t* selected_format_id);
 
oe_result_t oe_get_evidence(
    const oe_uuid_t* format_id,
    uint32_t flags,
    const void* custom_claims_buffer,
    size_t custom_claims_buffer_size,
    const void* optional_parameters,
    size_t optional_parameters_size,
    uint8_t** evidence_buffer,
    size_t* evidence_buffer_size,
    uint8_t** endorsements_buffer,
    size_t* endorsements_buffer_size);
 
oe_result_t oe_get_attestation_certificate_with_evidence(
    const oe_uuid_t* format_id,
    const unsigned char* subject_name,
    uint8_t* private_key,
    size_t private_key_size,
    uint8_t* public_key,
    size_t public_key_size,
    uint8_t** output_certificate,
    size_t* output_certificate_size);
 
oe_result_t oe_get_attestation_certificate_with_evidence_v2(
    const oe_uuid_t* format_id,
    const unsigned char* subject_name,
    uint8_t* private_key,
    size_t private_key_size,
    uint8_t* public_key,
    size_t public_key_size,
    const void* optional_parameters,
    size_t optional_parameters_size,
    uint8_t** output_certificate,
    size_t* output_certificate_size);
 
oe_result_t oe_free_evidence(uint8_t* evidence_buffer);
 
oe_result_t oe_free_endorsements(uint8_t* endorsements_buffer);
 
oe_result_t oe_attester_shutdown(void);
 
OE_EXTERNC_END
 
#endif // _OE_HOST_H
 
#endif /* _OE_ATTESTATION_ATTESTER_H */