cros: Added a new function to quick unlock api for checking unfinished pins.

chrome/common/extensions/api/quick_unlock_private.idl

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Use the <code>chrome.quickUnlockPrivate</code> API to change the active quick
 // unlock modes and to change their respective credentials.
 //
 // Quick unlock only supports unlocking an account that has already been signed
 // in.
 //
 // The quick unlock authentication facilities are not available through this
 // API; they are built directly into the lock screen.
 
 [platforms=("chromeos"),
  implemented_in="chrome/browser/chromeos/extensions/quick_unlock_private/quick_unlock_private_api.h"]
 namespace quickUnlockPrivate {
   // TODO(jdufault): Add more quick unlock modes, such as a pattern unlock.
   enum QuickUnlockMode {
     PIN
   };
 
+  // The problems a given PIN might have.
+  enum CredentialProblem {
+    TOO_SHORT,
+    TOO_LONG,
+    TOO_WEAK,
+    CONTAINS_NONDIGIT
+  };
+
+  dictionary CredentialCheck {
+    // The given PINs errors. Users cannot proceed with an error.
+    CredentialProblem[] errors;
+    // THe given PINs warnings. Users can, but are not advised to proceed with
+    // a warning.
+    CredentialProblem[] warnings;
+    // The minimum allowed length for a PIN.
+    long minLength;
+    // The maximum allowed length for a PIN. A value of 0 indicates no maximum
+    // length.
+    long maxLength;
+  };

[stevenjb, 2016/11/30 18:13:58]

It seems a little awkward to me that we return the min/max pin length along with
the credential check result. It seems like the UI might want to request that
information independently (e.g. to prevent submitting an invalid pin).

Maybe add a getCredentialRequirements method instead and just provide the
min/max length there?

[sammiequon, 2016/11/30 23:03:42]

Done.

+
   callback BooleanResultCallback = void (boolean value);
   callback ModesCallback = void (QuickUnlockMode[] modes);
+  callback CredentialCheckCallback = void (CredentialCheck check);
 
   interface Functions {
     // Returns the set of quick unlock modes that are available for the user to
     // use. Some quick unlock modes may be disabled by policy.
     static void getAvailableModes(ModesCallback onComplete);
 
     // Returns the quick unlock modes that are currently enabled and usable on
     // the lock screen.
     static void getActiveModes(ModesCallback onComplete);
 
+    // Checks if the given credential can be used for the given unlock mode.
+    // Enterprise policy can change credential requirements.
+    // |mode|: The quick unlock mode that is used.
+    // |credential|: The given credential.
+    // |onComplete|: Called with a list of warnings and errors the given
+    // |credential| has (if any). Allow provides extra information needed to be
+    // displayed.
+    static void checkCredential(QuickUnlockMode mode,
+                                DOMString credential,
+                                CredentialCheckCallback onComplete);
+
     // Update the set of quick unlock modes that are currently active/enabled.
     // |accountPassword|: The password associated with the account (e.g. the
     // GAIA password). This is required to change the quick unlock credentials.
     // |modes|: The quick unlock modes that should be active.
     // |credentials|: The associated credential for each mode. To keep
     // the credential the same for the associated mode, pass an empty string.
     // |onComplete|: Called with true if the quick unlock state was updated,
     // false otherwise. The update is treated as a single atomic operation.
     static void setModes(DOMString accountPassword,
                          QuickUnlockMode[] modes, DOMString[] credentials,
                          BooleanResultCallback onComplete);
   };
 
   interface Events {
     // Called after the active set of quick unlock modes has changed.
     // |activeModes|: The set of quick unlock modes which are now active.
     static void onActiveModesChanged(QuickUnlockMode[] activeModes);
   };
 };