Wire easy unlock settings UI

chrome/common/extensions/api/easy_unlock_private.idl

 // Copyright 2014 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.
 
 // <code>chrome.easyUnlockPrivate</code> API that provides hooks to Chrome to
 // be used by Easy Unlock component app.
 [nodoc] namespace easyUnlockPrivate {
   // Signature algorithms supported by the crypto library methods used by
   // Easy Unlock.
   enum SignatureType {
@@ skipping 26 matching lines @@
     // A phone eligible to unlock the device is detected, but it is not allowed
     // to unlock the device because it doesn't have lock screen enabled.
     PHONE_UNLOCKABLE,
     // A phone eligible to unlock the device is detected, but it's not close
     // enough to be allowed to unlock the device.
     PHONE_NOT_NEARBY,
     // The devie can be unlocked using Easy Unlock.
     AUTHENTICATED
   };
 
+  // Type of a permit. All lower case to match permit.PermitRecord.Type.
+  enum PermitType {access, license};
+
   // Options that can be passed to |unwrapSecureMessage| method.
   dictionary UnwrapSecureMessageOptions {
     // The data associated with the message. For the message to be succesfully
     // verified, the message should have been created with the same associated
     // data.
     ArrayBuffer? associatedData;
 
     // The encryption algorithm that should be used to decrypt the message.
     // Should not be set for a cleartext message.
     EncryptionType? encryptType;
@@ skipping 22 matching lines @@
     // The encryption algorithm that should be used to encrypt the message.
     // Should not be set for a cleartext message.
     EncryptionType? encryptType;
 
     // The algorithm to be used to sign the message.
     // Defaults to |HMAC_SHA256|. |ECDSA_P256_SHA256| can currently be used
     // only with cleartext messages.
     SignatureType? signType;
   };
 
+  // A permit record contains the credentials used to request or grant
+  // authorization of a permit.
+  dictionary PermitRecord {
+    // ID of the permit, which identifies the service/application that these
+    // permit records are used in.
+    DOMString permitId;
+
+    // An identifier for this record that should be unique among all other
+    // records of the same permit.
+    DOMString id;
+
+    // Type of the record.
+    PermitType type;
+
+    // Websafe base64 encoded payload data of the record.
+    DOMString data;
+  };
+
+  // Device information that can be authenticated for Easy unlock.
+  dictionary Device {
+    // The Bluetooth address of the device.
+    DOMString bluetoothAddress;
+
+    // The name of the device.
+    DOMString? name;
+
+    // The permit record of the device.
+    PermitRecord? permitRecord;
+
+    // Websafe base64 encoded persistent symmetric key.
+    DOMString? psk;
+  };
+
   // Callback for crypto methods that return a single array buffer.
   callback DataCallback = void(optional ArrayBuffer data);
 
   // An empty callback used purely for signalling success vs. failure.
   callback EmptyCallback = void();
 
   // Callback for the getStrings() method.
   callback GetStringsCallback = void(object strings);
 
   // Callback for method that generates an encryption key pair.
   callback KeyPairCallback = void(optional ArrayBuffer public_key,
                                   optional ArrayBuffer private_key);
 
+  // Callback for the getPermitAccess() method.
+  callback GetPermitAccessCallback = void(optional PermitRecord permitAccess);
+
+  // Callback for the getRemoteDevices() method.
+  callback GetRemoteDevicesCallback = void(Device[] devices);
+
   interface Functions {
     // Gets localized strings required to render the API.
     //
     // |callback| : Called with a dictionary mapping names to resource strings.
     // TODO(isherman): This is essentially copied from identity_private.idl.
     //                 Perhaps this should be extracted to a common API instead?
     static void getStrings(GetStringsCallback callback);
 
     // Generates a ECDSA key pair for P256 curve.
     // Public key will be in format recognized by secure wire transport protocol
@@ skipping 56 matching lines @@
     // registering the device with the Bluetooth daemon, making it available for
     // future outgoing connections.
     // |deviceAddress|: The Bluetooth address of the device to connect to.
     // |callback|: Called to indicate success or failure.
     static void seekBluetoothDeviceByAddress(DOMString deviceAddress,
                                              optional EmptyCallback callback);
 
     // Updates the screenlock state to reflect the Easy Unlock app state.
     static void updateScreenlockState(State state,
                                       optional EmptyCallback callback);
+
+    // Saves the permit record for the local device.
+    // |permitAccess|: The permit record to be saved.
+    // |callback|: Called to indicate success or failure.
+    static void setPermitAccess(PermitRecord permitAccess,
+                                optional EmptyCallback callback);
+
+    // Gets the permit record for the local device.
+    static void getPermitAccess(GetPermitAccessCallback callback);
+
+    // Clears the permit record for the local device.
+    static void clearPermitAccess(optional EmptyCallback callback);
+
+    // Saves the remote device list.
+    // |devices|: The list of remote devices to be saved.
+    // |callback|: Called to indicate success or failure.
+    static void setRemoteDevices(Device[] devices,
+                                 optional EmptyCallback callback);
+
+    // Gets the remote device list.
+    static void getRemoteDevices(GetRemoteDevicesCallback callback);
   };
 };