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 {
     HMAC_SHA256,
     ECDSA_P256_SHA256
   };
 
   // Encryption algorithms supported by the crypto library methods used by
   // Easy Unlock.
   enum EncryptionType {
     AES_256_CBC
   };
 
+  // Type of a permit.
+  enum PermitType {access, license};

[tbarzic, 2014/08/14 17:43:23]

other enums are in all caps

[xiyuan, 2014/08/14 22:09:19]

This has to match the enum defined in permit.PermitRecord.Type. Added a comment.

+
   // 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 {
+    // The id of the permit record.
+    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;
+
+    // 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;
+
+    // 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 52 matching lines @@
     // Connects to the SDP service on a device, given just the device's
     // Bluetooth address. This function is useful as a faster alternative to
     // Bluetooth discovery, when you already know the remote device's Bluetooth
     // address. A successful call to this function has the side-effect of
     // 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);
+
+    // 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);
+  };
+
+  interface Events {
+    // Fired when a turn-off flow has finished successfully.
+    static void onTurnOffFlowFinished();
   };
 };