key.js revision cedac228d2dd51db4b79ea1e72c7f249408ee061 
1// Copyright 2014 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5var utils = require('utils');
6
7/**
8 * Enum of possible key types (subset of WebCrypto.KeyType).
9 * @enum {string}
10 */
11var KeyType = {
12  public: 'public',
13  private: 'private'
14};
15
16/**
17 * Enum of possible key usages (subset of WebCrypto.KeyUsage).
18 * @enum {string}
19 */
20var KeyUsage = {
21  sign: 'sign',
22  verify: 'verify'
23};
24
25/**
26 * Implementation of WebCrypto.Key used in enterprise.platformKeys.
27 * @param {KeyType} type The type of the new key.
28 * @param {ArrayBuffer} publicKeySpki The Subject Public Key Info in DER
29 *   encoding.
30 * @param {KeyAlgorithm} algorithm The algorithm identifier.
31 * @param {KeyUsage[]} usages The allowed key usages.
32 * @param {boolean} extractable Whether the key is extractable.
33 * @constructor
34 */
35var KeyImpl = function(type, publicKeySpki, algorithm, usages, extractable) {
36  this.type = type;
37  this.spki = publicKeySpki;
38  this.algorithm = algorithm;
39  this.usages = usages;
40  this.extractable = extractable;
41};
42
43var Key =
44    utils.expose('Key',
45                 KeyImpl,
46                 {readonly:['extractable', 'type', 'algorithm', 'usages']});
47
48/**
49 * Returns |key|'s Subject Public Key Info. Throws an exception if |key| is not
50 * a valid Key object.
51 * @param {Key} key
52 * @return {ArrayBuffer} The Subject Public Key Info in DER encoding of |key|.
53 */
54function getSpki(key) {
55  if (!privates(key))
56    throw new Error('Invalid key object.');
57  var keyImpl = privates(key).impl;
58  if (!keyImpl || !keyImpl.spki)
59    throw new Error('Invalid key object.');
60  return keyImpl.spki;
61}
62
63exports.Key = Key;
64exports.KeyType = KeyType;
65exports.KeyUsage = KeyUsage;
66exports.getSpki = getSpki;
67