An implementation of chrome.socket.secure().

extensions/common/api/sockets_tcp.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.
 
 // 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.
 namespace sockets.tcp {
   // The socket properties specified in the <code>create</code> or
   // <code>update</code> function. Each property is optional. If a property
@@ 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 {
+    // The minimum and maximum acceptable versions of TLS. These will
+    // be <code>ssl3</code>, <code>tls1</code>, <code>tls1.1</code>,
+    // or <code>tls1.2</code>.
+    DOMString? min;

[Marijn Kruisselbrink, 2014/07/24 22:44:08]

I'd say that this should be an enum, but apparently our IDL files don't follow
the web idl spec, so those values can't be enum members...

[lally, 2014/07/26 15:25:17]

Acknowledged.

+    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 109 matching lines @@
                         DOMString peerAddress,
                         long peerPort,
                         ConnectCallback callback);
 
     // Disconnects the socket.
     // |socketId| : The socket identifier.
     // |callback| : Called when the disconnect attempt is complete.
     static void disconnect(long socketId,
                            optional DisconnectCallback callback);
 
+    // Start a TLS client connection over the connected TCP client 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);
+
     // Sends data on the given TCP socket.
     // |socketId| : The socket identifier.
     // |data| : The data to send.
     // |callback| : Called when the <code>send</code> operation completes.
     static void send(long socketId,
                      ArrayBuffer data,
                      SendCallback callback);
 
     // Closes the socket and releases the address/port the socket is bound to.
     // Each socket created should be closed after use. The socket id is no
@@ skipping 21 matching lines @@
     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);
   };
 };