| OLD | NEW |
| 1 /* Copyright 2013 The Chromium Authors. All rights reserved. | 1 /* Copyright 2013 The Chromium Authors. All rights reserved. |
| 2 * Use of this source code is governed by a BSD-style license that can be | 2 * Use of this source code is governed by a BSD-style license that can be |
| 3 * found in the LICENSE file. | 3 * found in the LICENSE file. |
| 4 */ | 4 */ |
| 5 | 5 |
| 6 /* From private/ppb_platform_verification_private.idl, | 6 /* From private/ppb_platform_verification_private.idl, |
| 7 * modified Thu Sep 12 11:48:28 2013. | 7 * modified Fri Oct 18 15:02:09 2013. |
| 8 */ | 8 */ |
| 9 | 9 |
| 10 #ifndef PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ | 10 #ifndef PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ |
| 11 #define PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ | 11 #define PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ |
| 12 | 12 |
| 13 #include "ppapi/c/pp_bool.h" | 13 #include "ppapi/c/pp_bool.h" |
| 14 #include "ppapi/c/pp_completion_callback.h" | 14 #include "ppapi/c/pp_completion_callback.h" |
| 15 #include "ppapi/c/pp_instance.h" | 15 #include "ppapi/c/pp_instance.h" |
| 16 #include "ppapi/c/pp_macros.h" | 16 #include "ppapi/c/pp_macros.h" |
| 17 #include "ppapi/c/pp_resource.h" | 17 #include "ppapi/c/pp_resource.h" |
| 18 #include "ppapi/c/pp_stdint.h" | 18 #include "ppapi/c/pp_stdint.h" |
| 19 #include "ppapi/c/pp_var.h" | 19 #include "ppapi/c/pp_var.h" |
| 20 | 20 |
| 21 #define PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE_0_1 \ | 21 #define PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE_0_2 \ |
| 22 "PPB_PlatformVerification_Private;0.1" | 22 "PPB_PlatformVerification_Private;0.2" |
| 23 #define PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE \ | 23 #define PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE \ |
| 24 PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE_0_1 | 24 PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE_0_2 |
| 25 | 25 |
| 26 /** | 26 /** |
| 27 * @file | 27 * @file |
| 28 * This file defines the API for platform verification. Currently, it only | 28 * This file defines the API for platform verification. Currently, it only |
| 29 * supports Chrome OS. | 29 * supports Chrome OS. |
| 30 */ | 30 */ |
| 31 | 31 |
| 32 | 32 |
| 33 /** | 33 /** |
| 34 * @addtogroup Interfaces | 34 * @addtogroup Interfaces |
| 35 * @{ | 35 * @{ |
| 36 */ | 36 */ |
| 37 /** | 37 /** |
| 38 * The <code>PPB_PlatformVerification_Private</code> interface allows authorized | 38 * The <code>PPB_PlatformVerification_Private</code> interface allows authorized |
| 39 * services to verify that the underlying platform is trusted. An example of a | 39 * services to verify that the underlying platform is trusted. An example of a |
| 40 * trusted platform is a Chrome OS device in verified boot mode. | 40 * trusted platform is a Chrome OS device in verified boot mode. |
| 41 */ | 41 */ |
| 42 struct PPB_PlatformVerification_Private_0_1 { | 42 struct PPB_PlatformVerification_Private_0_2 { |
| 43 /** | 43 /** |
| 44 * Create() creates a <code>PPB_PlatformVerification_Private</code> object. | 44 * Create() creates a <code>PPB_PlatformVerification_Private</code> object. |
| 45 * | 45 * |
| 46 * @pram[in] instance A <code>PP_Instance</code> identifying one instance of | 46 * @pram[in] instance A <code>PP_Instance</code> identifying one instance of |
| 47 * a module. | 47 * a module. |
| 48 * | 48 * |
| 49 * @return A <code>PP_Resource</code> corresponding to a | 49 * @return A <code>PP_Resource</code> corresponding to a |
| 50 * <code>PPB_PlatformVerification_Private</code> if successful, 0 if creation | 50 * <code>PPB_PlatformVerification_Private</code> if successful, 0 if creation |
| 51 * failed. | 51 * failed. |
| 52 */ | 52 */ |
| 53 PP_Resource (*Create)(PP_Instance instance); | 53 PP_Resource (*Create)(PP_Instance instance); |
| 54 /** | 54 /** |
| 55 * IsPlatformVerification() determines if the provided resource is a | 55 * IsPlatformVerification() determines if the provided resource is a |
| 56 * <code>PPB_PlatformVerification_Private</code>. | 56 * <code>PPB_PlatformVerification_Private</code>. |
| 57 * | 57 * |
| 58 * @param[in] resource A <code>PP_Resource</code> corresponding to a | 58 * @param[in] resource A <code>PP_Resource</code> corresponding to a |
| 59 * <code>PPB_PlatformVerification_Private</code>. | 59 * <code>PPB_PlatformVerification_Private</code>. |
| 60 * | 60 * |
| 61 * @return <code>PP_TRUE</code> if the resource is a | 61 * @return <code>PP_TRUE</code> if the resource is a |
| 62 * <code>PPB_PlatformVerification_Private</code>, <code>PP_FALSE</code> if the | 62 * <code>PPB_PlatformVerification_Private</code>, <code>PP_FALSE</code> if the |
| 63 * resource is invalid or some type other than | 63 * resource is invalid or some type other than |
| 64 * <code>PPB_PlatformVerification_Private</code>. | 64 * <code>PPB_PlatformVerification_Private</code>. |
| 65 */ | 65 */ |
| 66 PP_Bool (*IsPlatformVerification)(PP_Resource resource); | 66 PP_Bool (*IsPlatformVerification)(PP_Resource resource); |
| 67 /** | 67 /** |
| 68 * Check if the underlying host platform can be challenged; i.e., verified as | |
| 69 * a trusted platform. Useful for avoiding unnecessary work on platforms | |
| 70 * which will always fail; i.e. dev mode Chrome OS. | |
| 71 * | |
| 72 * @param[out] can_challenge_platform A <code>PP_Bool</code> which is set to | |
| 73 * <code>PP_TRUE</code> if a platform challenge might pass and | |
| 74 * <code>PP_FALSE</code> if it definitely won't. | |
| 75 * | |
| 76 * @param[in] callback A <code>PP_CompletionCallback</code> to be called after | |
| 77 * the method has been completed. This callback will only run if the return | |
| 78 * code is <code>PP_OK_COMPLETIONPENDING</code>. | |
| 79 * | |
| 80 * @return An int32_t containing an error code from <code>pp_errors.h</code>. | |
| 81 */ | |
| 82 int32_t (*CanChallengePlatform)(PP_Resource instance, | |
| 83 PP_Bool* can_challenge_platform, | |
| 84 struct PP_CompletionCallback callback); | |
| 85 /** | |
| 86 * Requests a platform challenge for a given service id. | 68 * Requests a platform challenge for a given service id. |
| 87 * | 69 * |
| 88 * @param[in] service_id A <code>PP_Var</code> of type | 70 * @param[in] service_id A <code>PP_Var</code> of type |
| 89 * <code>PP_VARTYPE_STRING</code> containing the service_id for the challenge. | 71 * <code>PP_VARTYPE_STRING</code> containing the service_id for the challenge. |
| 90 * | 72 * |
| 91 * @param[in] challenge A <code>PP_Var</code> of type | 73 * @param[in] challenge A <code>PP_Var</code> of type |
| 92 * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the challenge data. | 74 * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the challenge data. |
| 93 * | 75 * |
| 94 * @param[out] signed_data A <code>PP_Var</code> of type | 76 * @param[out] signed_data A <code>PP_Var</code> of type |
| 95 * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the data signed by the | 77 * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the data signed by the |
| (...skipping 15 matching lines...) Expand all Loading... |
| 111 */ | 93 */ |
| 112 int32_t (*ChallengePlatform)(PP_Resource instance, | 94 int32_t (*ChallengePlatform)(PP_Resource instance, |
| 113 struct PP_Var service_id, | 95 struct PP_Var service_id, |
| 114 struct PP_Var challenge, | 96 struct PP_Var challenge, |
| 115 struct PP_Var* signed_data, | 97 struct PP_Var* signed_data, |
| 116 struct PP_Var* signed_data_signature, | 98 struct PP_Var* signed_data_signature, |
| 117 struct PP_Var* platform_key_certificate, | 99 struct PP_Var* platform_key_certificate, |
| 118 struct PP_CompletionCallback callback); | 100 struct PP_CompletionCallback callback); |
| 119 }; | 101 }; |
| 120 | 102 |
| 121 typedef struct PPB_PlatformVerification_Private_0_1 | 103 typedef struct PPB_PlatformVerification_Private_0_2 |
| 122 PPB_PlatformVerification_Private; | 104 PPB_PlatformVerification_Private; |
| 123 /** | 105 /** |
| 124 * @} | 106 * @} |
| 125 */ | 107 */ |
| 126 | 108 |
| 127 #endif /* PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ */ | 109 #endif /* PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ */ |
| 128 | 110 |
| OLD | NEW |