An implementation of chrome.socket.secure().

extensions/common/api/socket.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.socket</code> API to send and receive data over the
 // network using TCP and UDP connections. <b>Note:</b> Starting with Chrome 33,
 // this API is deprecated in favor of the $(ref:sockets.udp), $(ref:sockets.tcp) and
 // $(ref:sockets.tcpServer) APIs.
 namespace socket {
   enum SocketType {
@@ skipping 11 matching lines @@
   };
 
   callback CreateCallback = void (CreateInfo createInfo);
 
   callback ConnectCallback = void (long result);
 
   callback BindCallback = void (long result);
 
   callback ListenCallback = void (long result);
 
+  callback SecureCallback = void (long result);
+
   dictionary AcceptInfo {
     long resultCode;
     // The id of the accepted socket.
     long? socketId;
   };
 
   callback AcceptCallback = void (AcceptInfo acceptInfo);
 
   dictionary ReadInfo {
     // The resultCode returned from the underlying read() call.
@@ skipping 60 matching lines @@
     // "eth0", "lo", etc.
     DOMString name;
 
     // The available IPv4/6 address.
     DOMString address;
 
     // The prefix length
     long prefixLength;
   };
 
+  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;
+    DOMString? max;
+  };
+
+  dictionary SecureOptions {
+    TLSVersionConstraints? tlsVersion;
+  };
+
   callback RecvFromCallback = void (RecvFromInfo recvFromInfo);
 
   callback SendToCallback = void (WriteInfo writeInfo);
 
   callback SetKeepAliveCallback = void (boolean result);
 
   callback SetNoDelayCallback = void (boolean result);
 
   callback GetInfoCallback = void (SocketInfo result);
 
@@ skipping 205 matching lines @@
     static void setMulticastLoopbackMode(
         long socketId,
         boolean enabled,
         SetMulticastLoopbackModeCallback callback);
 
     // Get the multicast group addresses the socket is currently joined to.
     // |socketId| : The socketId.
     // |callback| : Called with an array of strings of the result.
     static void getJoinedGroups(long socketId,
                                 GetJoinedGroupsCallback callback);
+
+    // Start a TLS client connection over a connected TCP client socket.
+    // |socketId| : The connected socket to use.
+    // |options| : Constraints and parameters for the TLS connection.
+    // |callback| : Called when the TLS connection attempt is complete.
+    static void secure(long socketId,
+                       optional SecureOptions options,
+                       SecureCallback callback);
   };
 
 };