chrome/browser/resources/cryptotoken/gnubbyfactory.js

   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
   5 /**
   6  * @fileoverview Contains a factory interface for creating and opening gnubbies.
   7  */
   8 'use strict';
   9
  10 /**
  11  * A factory for creating and opening gnubbies.
  12  * @interface
  13  */
  14 function GnubbyFactory() {}
  15
  16 /**
  17  * Enumerates gnubbies.
  18  * @param {function(number, Array.<GnubbyDeviceId>)} cb Enumerate callback
  19  */
  20 GnubbyFactory.prototype.enumerate = function(cb) {
  21 };
  22
  23 /** @typedef {function(number, Gnubby=)} */
  24 var FactoryOpenCallback;
  25
  26 /**
  27  * Creates a new gnubby object, and opens the gnubby with the given index.
  28  * @param {GnubbyDeviceId} which The device to open.
  29  * @param {boolean} forEnroll Whether this gnubby is being opened for enrolling.
  30  * @param {FactoryOpenCallback} cb Called with result of opening the gnubby.
  31  * @param {string=} logMsgUrl the url to post log messages to
  32  */
  33 GnubbyFactory.prototype.openGnubby = function(which, forEnroll, cb, logMsgUrl) {
  34 };
  35
  36 /**
  37  * Called during enrollment to check whether a gnubby known not to be enrolled
  38  * is allowed to enroll in its present state. Upon completion of the check, the
  39  * callback is called.
  40  * @param {Gnubby} gnubby The not-enrolled gnubby.
  41  * @param {string} appIdHash The base64-encoded hash of the app id for which
  42  *     the gnubby being enrolled.
  43  * @param {FactoryOpenCallback} cb Called with the result of the prerequisite
  44  *     check. (A non-zero status indicates failure.)
  45  */
  46 GnubbyFactory.prototype.notEnrolledPrerequisiteCheck =
  47     function(gnubby, appIdHash, cb) {
  48 };