Enable passing cast channel certificate authority keys.

extensions/common/api/cast_channel.idl

 // Copyright 2014 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.
 
 // API for communicating with a Google Cast device over an authenticated
 // channel.
 namespace cast.channel {
 
   // The state of the channel.
   enum ReadyState {
@@ skipping 72 matching lines @@
     // DEPRECATED: The URL to the receiver.  This field will be removed in a
     // future release.
     DOMString url;
 
     // Connection information that was used to establish the channel to the
     // receiver.
     ConnectInfo connectInfo;
 
     // The current state of the channel.
     ReadyState readyState;
-      
+
     // If set, the last error condition encountered by the channel.
     ChannelError? errorState;
   };
 
   // Describes a message sent or received over the channel.  Currently only
   // string messages are supported, although ArrayBuffer and Blob types may be
   // supported in the future.
   dictionary MessageInfo {
     // The message namespace.  A namespace is a URN of the form
     // urn:cast-x:<namespace> that is used to interpret and route Cast messages.
     DOMString namespace_;
 
     // source and destination ids identify the origin and destination of the
     // message.  They are used to route messages between endpoints that share a
     // device-to-device channel.
     //
     // For messages between applications:
     //   - The sender application id is a unique identifier generated on behalf
     //     of the sender application.
     //   - The receiver id is always the the session id for the application.
     //
     // For messages to or from the sender or receiver platform, the special ids
     // 'sender-0' and 'receiver-0' can be used.
-    // 
+    //
     // For messages intended for all endpoints using a given channel, the
     // wildcard destination_id '*' can be used.
     DOMString sourceId;
     DOMString destinationId;
 
     // The content of the message.  Must be either a string or an ArrayBuffer.
     any data;
   };
 
   // Describes a terminal error encountered by the channel with details of the
@@ skipping 22 matching lines @@
 
   // Callback holding the result of a channel operation.
   callback ChannelInfoCallback = void (ChannelInfo result);
 
   // Callback from <code>getLogs</code> method.
   // |log|: compressed serialized raw bytes containing the logs.
   // The log is formatted using protocol buffer.
   // See extensions/browser/api/cast_channel/logging.proto for definition.
   // Compression is in gzip format.
   callback GetLogsCallback = void (ArrayBuffer log);
-  
+
+  // Callback from <code>setAuthorityKeys</code> method.
+  callback SetAuthorityKeysCallback = void (DOMString result);

[mark a. foltz, 2014/10/14 06:15:04]

Why can't this be void ()?  If we need to add an argument to the callback later
that will be backwards compatible.

[vadimgo, 2014/10/14 19:51:25]

Done.

+
   interface Functions {
     // Opens a new channel to the Cast receiver specified by connectInfo.  Only
     // one channel may be connected to same receiver from the same extension at
     // a time.  If the open request is successful, the callback will be invoked
     // with a ChannelInfo with readyState == 'connecting'.  If unsuccessful, the
     // callback will be invoked with a ChannelInfo with channel.readyState ==
     // 'closed', channel.errorState will be set to the error condition, and
     // onError will be fired with error details.
     //
     // TODO(mfoltz): Convert 'any' to ConnectInfo once all clients are updated
@@ skipping 10 matching lines @@
                      MessageInfo message,
                      ChannelInfoCallback callback);
 
     // Requests that the channel be closed and invokes callback with the
     // resulting channel status.  The channel must be in readyState == 'open' or
     // 'connecting'.  If successful, onClose will be fired with readyState ==
     // 'closed'.  If unsuccessful, channel.readyState will be set to 'closed',
     // and channel.errorState will be set to the error condition.
     static void close(ChannelInfo channel,
                       ChannelInfoCallback callback);
-      
+
     // Get logs in compressed serialized format. See GetLogsCallback for
-    // details.  
+    // details.
     // |callback|: If successful, |callback| is invoked with data. Otherwise,
-    // an error will be raised.                
+    // an error will be raised.
     static void getLogs(GetLogsCallback callback);
+
+    // Sets trusted certificate authorities where |signature| is a base64
+    // encoded RSA-PSS signature and |keys| is base64 encoded AuthorityKeys
+    // protobuf.
+    static void setAuthorityKeys(DOMString keys,
+                                 DOMString signature,
+                                 SetAuthorityKeysCallback callback);
   };
 
   // Events on the channel.
   interface Events {
     // Fired when a message is received on an open channel.
     static void onMessage(ChannelInfo channel,
                           MessageInfo message);
 
     // Fired when an error occurs as a result of a channel operation or a
     // network event. |error| contains details of the error.
     static void onError(ChannelInfo channel, ErrorInfo error);
   };
 };