OLD | NEW |
---|---|
1 // Copyright 2016 The Chromium Authors. All rights reserved. | 1 // Copyright 2016 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 // Use the <code>chrome.quickUnlockPrivate</code> API to change the active quick | 5 // Use the <code>chrome.quickUnlockPrivate</code> API to change the active quick |
6 // unlock modes and to change their respective credentials. | 6 // unlock modes and to change their respective credentials. |
7 // | 7 // |
8 // Quick unlock only supports unlocking an account that has already been signed | 8 // Quick unlock only supports unlocking an account that has already been signed |
9 // in. | 9 // in. |
10 // | 10 // |
11 // The quick unlock authentication facilities are not available through this | 11 // The quick unlock authentication facilities are not available through this |
12 // API; they are built directly into the lock screen. | 12 // API; they are built directly into the lock screen. |
13 | 13 |
14 [platforms=("chromeos"), | 14 [platforms=("chromeos"), |
15 implemented_in="chrome/browser/chromeos/extensions/quick_unlock_private/quick_u nlock_private_api.h"] | 15 implemented_in="chrome/browser/chromeos/extensions/quick_unlock_private/quick_u nlock_private_api.h"] |
16 namespace quickUnlockPrivate { | 16 namespace quickUnlockPrivate { |
17 // TODO(jdufault): Add more quick unlock modes, such as a pattern unlock. | 17 // TODO(jdufault): Add more quick unlock modes, such as a pattern unlock. |
18 enum QuickUnlockMode { | 18 enum QuickUnlockMode { |
19 PIN | 19 PIN |
20 }; | 20 }; |
21 | 21 |
22 enum CredentialProblem { | |
23 TOO_SHORT, | |
24 TOO_LONG, | |
25 TOO_WEAK, | |
26 CONTAINS_NONDIGIT | |
27 }; | |
28 | |
29 dictionary CredentialCheck { | |
30 CredentialProblem[] errors; | |
31 CredentialProblem[] warnings; | |
32 long? minLength; | |
jdufault
2016/11/01 18:56:44
API implementation is currently always providing a
sammiequon
2016/11/02 18:05:25
0 stands for infinite, so this should non-nullable
| |
33 long? maxLength; | |
34 }; | |
35 | |
22 callback BooleanResultCallback = void (boolean value); | 36 callback BooleanResultCallback = void (boolean value); |
23 callback ModesCallback = void (QuickUnlockMode[] modes); | 37 callback ModesCallback = void (QuickUnlockMode[] modes); |
38 callback CredentialCheckCallback = void (CredentialCheck check); | |
24 | 39 |
25 interface Functions { | 40 interface Functions { |
26 // Returns the set of quick unlock modes that are available for the user to | 41 // Returns the set of quick unlock modes that are available for the user to |
27 // use. Some quick unlock modes may be disabled by policy. | 42 // use. Some quick unlock modes may be disabled by policy. |
28 static void getAvailableModes(ModesCallback onComplete); | 43 static void getAvailableModes(ModesCallback onComplete); |
29 | 44 |
30 // Returns the quick unlock modes that are currently enabled and usable on | 45 // Returns the quick unlock modes that are currently enabled and usable on |
31 // the lock screen. | 46 // the lock screen. |
32 static void getActiveModes(ModesCallback onComplete); | 47 static void getActiveModes(ModesCallback onComplete); |
33 | 48 |
49 // Checks if the given credential can be used for the given unlock mode. | |
50 // Enterprise policy can change credential requirements. | |
51 static void checkCredential(QuickUnlockMode mode, | |
52 DOMString credential, | |
53 CredentialCheckCallback onComplete); | |
54 | |
34 // Update the set of quick unlock modes that are currently active/enabled. | 55 // Update the set of quick unlock modes that are currently active/enabled. |
35 // |accountPassword|: The password associated with the account (e.g. the | 56 // |accountPassword|: The password associated with the account (e.g. the |
36 // GAIA password). This is required to change the quick unlock credentials. | 57 // GAIA password). This is required to change the quick unlock credentials. |
37 // |modes|: The quick unlock modes that should be active. | 58 // |modes|: The quick unlock modes that should be active. |
38 // |credentials|: The associated credential for each mode. To keep | 59 // |credentials|: The associated credential for each mode. To keep |
39 // the credential the same for the associated mode, pass an empty string. | 60 // the credential the same for the associated mode, pass an empty string. |
40 // |onComplete|: Called with true if the quick unlock state was updated, | 61 // |onComplete|: Called with true if the quick unlock state was updated, |
41 // false otherwise. The update is treated as a single atomic operation. | 62 // false otherwise. The update is treated as a single atomic operation. |
42 static void setModes(DOMString accountPassword, | 63 static void setModes(DOMString accountPassword, |
43 QuickUnlockMode[] modes, DOMString[] credentials, | 64 QuickUnlockMode[] modes, DOMString[] credentials, |
44 BooleanResultCallback onComplete); | 65 BooleanResultCallback onComplete); |
45 }; | 66 }; |
46 | 67 |
47 interface Events { | 68 interface Events { |
48 // Called after the active set of quick unlock modes has changed. | 69 // Called after the active set of quick unlock modes has changed. |
49 // |activeModes|: The set of quick unlock modes which are now active. | 70 // |activeModes|: The set of quick unlock modes which are now active. |
50 static void onActiveModesChanged(QuickUnlockMode[] activeModes); | 71 static void onActiveModesChanged(QuickUnlockMode[] activeModes); |
51 }; | 72 }; |
52 }; | 73 }; |
OLD | NEW |