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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
/* 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 primary password.
*/
AString encrypt(in AString plainText);
/*
* encryptMany
*
* @param plainTexts
* The strings to be encrypted.
*
* Encrypts the specified strings, similar to encrypt, but returning a promise
* which resolves with the the encrypted strings.
*/
Promise encryptMany(in jsval plainTexts);
/**
* 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 primary 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);
/**
* @param cipherTexts
* The strings to be decrypted.
*
* Decrypts the specified strings, returning the plaintext values.
*
* Can throw if the user cancels entry of their primary password, or if the
* cipherText value can not be successfully decrypted (eg, if it was
* encrypted with some other key).
*/
Promise decryptMany(in jsval cipherTexts);
/**
* uiBusy
*
* True when a primary 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 primary
* password prompt.
*/
readonly attribute boolean isLoggedIn;
/**
* defaultEncType
*
* Default encryption type used by an implementation of this interface.
*/
readonly attribute unsigned long defaultEncType;
};
|
