An implementation of chrome.socket.secure().

chrome/common/extensions/api/sockets_tcp.idl

 // 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.
 
 // Use the <code>chrome.sockets.tcp</code> API to send and receive data over the
 // network using TCP connections. This API supersedes the TCP functionality
 // previously found in the <code>chrome.socket</code> API. Note that the socket
 // ids created from this namespace are not compatible with ids created in other
 // namespaces.
 namespace sockets.tcp {
@@ skipping 62 matching lines @@
   // Callback from the <code>setKeepAliveCallback<code> method.
   // |result| : The result code returned from the underlying network call.
   // A negative value indicates an error.
   callback SetKeepAliveCallback = void (long result);
 
   // Callback from the <code>setNodeDelay<code> method.
   // |result| : The result code returned from the underlying network call.
   // A negative value indicates an error.
   callback SetNoDelayCallback = void (long result);
 
+  dictionary TLSVersionConstraints {
+    DOMString? min;
+    DOMString? max;
+  };
+
+  dictionary SecureOptions {
+    TLSVersionConstraints? tlsVersion;
+  };
+
+  callback SecureCallback = void (long result);
+
   // Result of the <code>getInfo</code> method.
   dictionary SocketInfo {
     // The socket identifier.
     long socketId;
 
     // Flag indicating whether the socket is left open when the application is
     // suspended (see <code>SocketProperties.persistent</code>).
     boolean persistent;
 
     // Application-defined string associated with the socket.
@@ skipping 135 matching lines @@
 
     // Retrieves the state of the given socket.
     // |socketId| : The socket identifier.
     // |callback| : Called when the socket state is available.
     static void getInfo(long socketId,
                         GetInfoCallback callback);
 
     // Retrieves the list of currently opened sockets owned by the application.
     // |callback| : Called when the list of sockets is available.
     static void getSockets(GetSocketsCallback callback);
+
+    // Start a TLS client connection over the socket.
+    // |socketId| : The existing, connected socket to use.
+    // |options| : Constraints and parameters for the TLS connection.
+    // |callback| : Called when the connection attempt is complete.
+    static void secure(long socketId,
+                       optional SecureOptions options,
+                       SecureCallback callback);

[rpaquay, 2013/12/16 20:18:46]

nit: can you move this method between "disconnect" and "send". (trying to keep
methods in order they are called from a client app).

[lally, 2013/12/16 22:20:07]

Done.

   };
 
   interface Events {
     // Event raised when data has been received for a given socket.
     // |info| : The event data.
     static void onReceive(ReceiveInfo info);
 
     // Event raised when a network error occured while the runtime was waiting
     // for data on the socket address and port. Once this event is raised, the
     // socket is set to <code>paused</code> and no more <code>onReceive</code>
     // events are raised for this socket.
     // |info| : The event data.
     static void onReceiveError(ReceiveErrorInfo info);
   };
 };