summaryrefslogtreecommitdiffstats
path: root/toolkit/components/passwordmgr/nsILoginManagerCrypto.idl
blob: 8af36a258bce8ea3d81fb03d20be7244f83aaf4b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */


#include "nsISupports.idl"

[scriptable, uuid(2030770e-542e-40cd-8061-cd9d4ad4227f)]

interface nsILoginManagerCrypto : nsISupports {

  const unsigned long ENCTYPE_BASE64 = 0; // obsolete
  const unsigned long ENCTYPE_SDR = 1;

  /**
   * encrypt
   *
   * @param plainText
   *        The string to be encrypted.
   *
   * Encrypts the specified string, returning the ciphertext value.
   *
   * NOTE: The current implemention of this inferface simply uses NSS/PSM's
   * "Secret Decoder Ring" service. It is not recommended for general
   * purpose encryption/decryption.
   *
   * Can throw if the user cancels entry of their master password.
   */
  AString encrypt(in AString plainText);

  /**
   * decrypt
   *
   * @param cipherText
   *        The string to be decrypted.
   *
   * Decrypts the specified string, returning the plaintext value.
   *
   * Can throw if the user cancels entry of their master password, or if the
   * cipherText value can not be successfully decrypted (eg, if it was
   * encrypted with some other key).
   */
  AString decrypt(in AString cipherText);

  /**
   * uiBusy
   *
   * True when a master password prompt is being displayed.
   */
  readonly attribute boolean uiBusy;

  /**
   * isLoggedIn
   *
   * Current login state of the token used for encryption. If the user is
   * not logged in, performing a crypto operation will result in a master
   * password prompt.
   */
  readonly attribute boolean isLoggedIn;

  /**
   * defaultEncType
   *
   * Default encryption type used by an implementation of this interface.
   */
  readonly attribute unsigned long defaultEncType;
};