Initial RemoteCommandService

components/policy/proto/device_management_backend.proto

 // 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.
 
 syntax = "proto2";
 
 option optimize_for = LITE_RUNTIME;
 
 package enterprise_management;
 
@@ skipping 436 matching lines @@
 
   // The time at which the command was executed, if the the result is
   // RESULT_SUCCESS.
   optional int64 timestamp = 3;
 
   // Extra information sent to server as result of execution, might be a
   // serialization of another protobuf.
   optional bytes payload = 4;
 }
 
+message DeviceRemoteCommandRequest {
+  // The command id of the last command received from the server until

[bartfab (slow), 2015/02/28 00:01:26]

Nit: s/id/ID/

[binjin, 2015/02/28 02:18:08]

Done.

+  // now.  Omitted if no commands have been received yet.
+  optional int64 last_command_unique_id = 1;
+
+  // The execution results of previously fetched commands.
+  // The client should send back the command result whenever possible.

[bartfab (slow), 2015/02/28 00:01:27]

Nit: s/the/a/

[binjin, 2015/02/28 02:18:08]

Done.

+  repeated RemoteCommandResult command_results = 2;
+}
+
+message DeviceRemoteCommandResponse {
+  // The queue of pending commands.
+  repeated RemoteCommand commands = 1;
+}
+
 // Request from device to server for reading policies.
 message DevicePolicyRequest {
   // The policy fetch request.  If this field exists, the request must
   // comes from a non-TT client.  The repeated field allows client to
   // request multiple policies for better performance.
   repeated PolicyFetchRequest request = 3;
 }
 
 // Response from server to device for reading policies.
 message DevicePolicyResponse {
@@ skipping 460 matching lines @@
 //     * cert_upload
 //     * check_device_pairing
 //     * device_pairing
 //     * device_state_retrieval
 //     * enterprise_check
 //     * ping
 //     * policy
 //     * register
 //     * status
 //     * unregister
+//     * remote_commands
 //
 //   * devicetype: MUST BE "1" for Android or "2" for Chrome OS.
 //   * apptype: MUST BE Android or Chrome.
 //   * deviceid: MUST BE no more than 64-char in [\x21-\x7E].
 //   * agent: MUST BE a string of characters.
 // * HTTP Authorization header MUST be in the following formats:

[bartfab (slow), 2015/02/28 00:01:26]

What format should the header have for remote command requests?

[binjin, 2015/03/09 16:31:56]

Done.

 //   * For register and ping requests
 //     Authorization: GoogleLogin auth=<auth cookie for Mobile Sync>
 //
 //   * For unregister, policy, status, and cert_upload requests
 //      Authorization: GoogleDMToken token=<dm token from register>
 //
 //   * The Authorization header isn't used for enterprise_check
 //     request, nor for register requests using OAuth. In the latter case,
 //     the OAuth token is passed in the "oauth" parameter.
 //
 // DeviceManagementRequest should only contain one request which matches the
 // HTTP query parameter - request, as listed below. Other requests within the
 // container will be ignored.
 //   cert_upload: cert_upload_request
 //   check_device_pairing: check_device_pairing_request
 //   device_pairing: device_pairing_request
 //   device_state_retrieval: device_state_retrieval_request
 //   enterprise_check: auto_enrollment_request
 //   ping: policy_request
 //   policy: policy_request
 //   register: register_request
 //   status: device_status_report_request or session_status_report_request
 //   unregister: unregister_request
+//   remote_commands: remote_command_request
 //
 //
 message DeviceManagementRequest {
   // Register request.
   optional DeviceRegisterRequest register_request = 1;
 
   // Unregister request.
   optional DeviceUnregisterRequest unregister_request = 2;
 
   // Policy request.
@@ skipping 16 matching lines @@
   optional DeviceStateRetrievalRequest device_state_retrieval_request = 9;
 
   // Device state key update.
   optional DeviceStateKeyUpdateRequest device_state_key_update_request = 10;
 
   // Pair two devices.
   optional DevicePairingRequest device_pairing_request = 11;
 
   // Check if two devices are paired.
   optional CheckDevicePairingRequest check_device_pairing_request = 12;
+
+  // Remote command fetching.
+  optional DeviceRemoteCommandRequest remote_command_request = 13;
 }
 
 // Response from server to device.
 //
 // The server uses the following numbers as HTTP status codes
 // to report top-level errors.
 //
 // 200 OK: valid response is returned to client.
 // 400 Bad Request: invalid argument.
 // 401 Unauthorized: invalid auth cookie or DM token.
@@ skipping 34 matching lines @@
   optional DeviceServiceApiAccessResponse service_api_access_response = 10;
 
   // Device-state retrieval.
   optional DeviceStateRetrievalResponse device_state_retrieval_response = 11;
 
   // Response to device pairing request.
   optional DevicePairingResponse device_pairing_response = 12;
 
   // Response to check device pairing request.
   optional CheckDevicePairingResponse check_device_pairing_response = 13;
+
+  // Response to remote command request.
+  optional DeviceRemoteCommandResponse remote_command_response = 14;
 }