| /* Copyright 2013 The Chromium Authors. All rights reserved. |
| * Use of this source code is governed by a BSD-style license that can be |
| * found in the LICENSE file. |
| */ |
| |
| /* From private/ppb_platform_verification_private.idl, |
| * modified Fri Aug 11 11:47:35 2017. |
| */ |
| |
| #ifndef PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ |
| #define PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ |
| |
| #include "ppapi/c/pp_bool.h" |
| #include "ppapi/c/pp_completion_callback.h" |
| #include "ppapi/c/pp_instance.h" |
| #include "ppapi/c/pp_macros.h" |
| #include "ppapi/c/pp_resource.h" |
| #include "ppapi/c/pp_stdint.h" |
| #include "ppapi/c/pp_var.h" |
| |
| #define PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE_0_3 \ |
| "PPB_PlatformVerification_Private;0.3" |
| #define PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE \ |
| PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE_0_3 |
| |
| /** |
| * @file |
| * This file defines the API for platform verification. Currently, it only |
| * supports Chrome OS. |
| */ |
| |
| |
| /** |
| * @addtogroup Interfaces |
| * @{ |
| */ |
| /** |
| * The <code>PPB_PlatformVerification_Private</code> interface allows authorized |
| * services to verify that the underlying platform is trusted. An example of a |
| * trusted platform is a Chrome OS device in verified boot mode. |
| */ |
| struct PPB_PlatformVerification_Private_0_3 { |
| /** |
| * Create() creates a <code>PPB_PlatformVerification_Private</code> object. |
| * |
| * @pram[in] instance A <code>PP_Instance</code> identifying one instance of |
| * a module. |
| * |
| * @return A <code>PP_Resource</code> corresponding to a |
| * <code>PPB_PlatformVerification_Private</code> if successful, 0 if creation |
| * failed. |
| */ |
| PP_Resource (*Create)(PP_Instance instance); |
| /** |
| * IsPlatformVerification() determines if the provided resource is a |
| * <code>PPB_PlatformVerification_Private</code>. |
| * |
| * @param[in] resource A <code>PP_Resource</code> corresponding to a |
| * <code>PPB_PlatformVerification_Private</code>. |
| * |
| * @return <code>PP_TRUE</code> if the resource is a |
| * <code>PPB_PlatformVerification_Private</code>, <code>PP_FALSE</code> if the |
| * resource is invalid or some type other than |
| * <code>PPB_PlatformVerification_Private</code>. |
| */ |
| PP_Bool (*IsPlatformVerification)(PP_Resource resource); |
| /** |
| * Requests a platform challenge for a given service id. |
| * |
| * @param[in] service_id A <code>PP_Var</code> of type |
| * <code>PP_VARTYPE_STRING</code> containing the service_id for the challenge. |
| * |
| * @param[in] challenge A <code>PP_Var</code> of type |
| * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the challenge data. |
| * |
| * @param[out] signed_data A <code>PP_Var</code> of type |
| * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the data signed by the |
| * platform. |
| * |
| * @param[out] signed_data_signature A <code>PP_Var</code> of type |
| * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the signature of the |
| * signed data block. |
| * |
| * @param[out] platform_key_certificate A <code>PP_Var</code> of type |
| * <code>PP_VARTYPE_STRING</code> that contains the device specific |
| * certificate for the requested service_id. |
| * |
| * @param[in] callback A <code>PP_CompletionCallback</code> to be called after |
| * the platform challenge has been completed. This callback will only run if |
| * the return code is <code>PP_OK_COMPLETIONPENDING</code>. |
| * |
| * @return An int32_t containing an error code from <code>pp_errors.h</code>. |
| */ |
| int32_t (*ChallengePlatform)(PP_Resource instance, |
| struct PP_Var service_id, |
| struct PP_Var challenge, |
| struct PP_Var* signed_data, |
| struct PP_Var* signed_data_signature, |
| struct PP_Var* platform_key_certificate, |
| struct PP_CompletionCallback callback); |
| /** |
| * Requests the device's storage ID. |
| * |
| * @param[out] storage_id A <code>PP_Var</code> of type |
| * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the storage ID. |
| * |
| * @param[in] callback A <code>PP_CompletionCallback</code> to be called after |
| * the storage ID has been obtained. This callback will only run if |
| * the return code is <code>PP_OK_COMPLETIONPENDING</code>. |
| * |
| * @return An int32_t containing an error code from <code>pp_errors.h</code>. |
| */ |
| int32_t (*GetStorageId)(PP_Resource instance, |
| struct PP_Var* storage_id, |
| struct PP_CompletionCallback callback); |
| }; |
| |
| typedef struct PPB_PlatformVerification_Private_0_3 |
| PPB_PlatformVerification_Private; |
| /** |
| * @} |
| */ |
| |
| #endif /* PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ */ |
| |