chrome/common/extensions/api/cryptotoken_private.idl

   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 // <code>chrome.cryptotokenPrivate</code> API that provides hooks to Chrome to
   6 // be used by cryptotoken component extension.
   7 namespace cryptotokenPrivate {
   8
   9   // Possible results from requesting user permission.
  10   enum PermissionResult {
  11     // User expclitly allowed
  12     ALLOWED,
  13     // User explicitly denied
  14     DENIED,
  15     // Inconclusive, e.g. the tab was closed or navigated away
  16     DISMISSED
  17   };
  18
  19   // Callback for permission prompt
  20   callback PermissionCallback = void(PermissionResult result);
  21
  22   // Explicitly gathers approval from the user that an origin in a tab may
  23   // to talk to their security keys. This may be used e.g. before registering a
  24   // key, since it creates a stable identifier for that particular key, even
  25   // across browser instances.
  26   // |tabId| is the tab id from the chrome.tabs API, and |securityOrigin| is the
  27   // origin as seen by the extension, to verify that it is correct and has not
  28   // been navigated away from.
  29   interface Functions {
  30     static void requestPermission(long tabId,
  31                                   DOMString securityOrigin,
  32                                   PermissionCallback callback);
  33   };
  34 };