Adds SecurityContext.usePrivateKeyBytes

sdk/lib/io/security_context.dart

 // Copyright (c) 2015, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.io;
 
 /**
  * The object containing the certificates to trust when making
  * a secure client connection, and the certificate chain and
  * private key to serve from a secure server.
- * 
+ *
  * The [SecureSocket]  and [SecureServer] classes take a SecurityContext
  * as an argument to their connect and bind methods.
  *
  * Certificates and keys can be added to a SecurityContext from PEM files
  * on the disk.  A PEM file contains one or more base-64 encoded DER-serialized
  * ASN1 objects, surrounded with delimiter strings like
  * "-----BEGIN CERTIFICATE -----" and "-----END CERTIFICATE-----".
  * Distinguished encoding rules (DER) is a canonical binary serialization
  * of ASN1 objects into an octet string.
  */
 abstract class SecurityContext {
   external factory SecurityContext();
 
   /**
    * Secure networking classes with an optional `context` parameter
    * use the [defaultContext] object if the parameter is omitted.
    * This object can also be accessed, and modified, directly.
    * Each isolate has a different [defaultContext] object.
    * The [defaultContext] object uses a list of well-known trusted
    * certificate authorities as its trusted roots.  This list is
    * taken from Mozilla, who maintains it as part of Firefox.
    */
   external static SecurityContext get defaultContext;
 
   /**

[kevmoo, 2016/01/25 23:49:29]

Update the changelog w/ both the deprecation and the new API

[zra, 2016/01/25 23:59:38]

I'll update the changelog when I've finished providing alternatives for all of
the calls.

    * Sets the private key for a server certificate or client certificate.
    * A secure connection using this SecurityContext will use this key with
    * the server or client certificate to sign and decrypt messages.
    * [keyFile] is a PEM file containing an encrypted
    * private key, encrypted with [password].  An unencrypted file can be
    * used, but this is not usual.
+   *
+   * This function is deprecated. Use [usePrivateKeyBytes] instead.

[kevmoo, 2016/01/25 23:49:29]

Please put the deprecation warning at the top of the doc comment.

[zra, 2016/01/25 23:59:38]

Done.

    */
+  @deprecated
   void usePrivateKey(String keyFile, {String password});
 
   /**
+   * Sets the private key for a server certificate or client certificate.

[kevmoo, 2016/01/25 23:49:29]

Add a newline here -
https://www.dartlang.org/effective-dart/documentation/#do-make-the-first-sent...

[zra, 2016/01/25 23:59:38]

Done.

+   * A secure connection using this SecurityContext will use this key with
+   * the server or client certificate to sign and decrypt messages.
+   * [keyBytes] is the contents of a PEM file containing an encrypted
+   * private key, encrypted with [password].  An unencrypted file can be
+   * used, but this is not usual.
+   */
+  void usePrivateKeyBytes(List<int> keyBytes, {String password});
+
+  /**
    * Sets the set of trusted X509 certificates used by [SecureSocket]
    * client connections, when connecting to a secure server.
    *
    * There are two ways to set a set of trusted certificates, with a single
    * PEM file, or with a directory containing individual PEM files for
    * certificates.
    *
    * [file] is an optional PEM file containing X509 certificates, usually
    * root certificates from certificate authorities.
    *
@@ skipping 128 matching lines @@
     }
 
     if (bytes.length >= (1 << 13)) {
       throw new ArgumentError(
           'The maximum message length supported is 2^13-1.');
     }
 
     return new Uint8List.fromList(bytes);
   }
 }