Home | History | Annotate | Download | only in extensions 
      1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef CHROME_BROWSER_EXTENSIONS_PERMISSIONS_UPDATER_H__
      6 #define CHROME_BROWSER_EXTENSIONS_PERMISSIONS_UPDATER_H__
      7 
      8 #include <string>
      9 
     10 #include "base/memory/ref_counted.h"
     11 
     12 class Profile;
     13 
     14 namespace base {
     15 class DictionaryValue;
     16 }
     17 
     18 namespace extensions {
     19 
     20 class Extension;
     21 class ExtensionPrefs;
     22 class PermissionSet;
     23 
     24 // Updates an Extension's active and granted permissions in persistent storage
     25 // and notifies interested parties of the changes.
     26 class PermissionsUpdater {
     27  public:
     28   explicit PermissionsUpdater(Profile* profile);
     29   ~PermissionsUpdater();
     30 
     31   // Adds the set of |permissions| to the |extension|'s active permission set
     32   // and sends the relevant messages and notifications. This method assumes the
     33   // user has already been prompted, if necessary, for the extra permissions.
     34   void AddPermissions(const Extension* extension,
     35                       const PermissionSet* permissions);
     36 
     37   // Removes the set of |permissions| from the |extension|'s active permission
     38   // set and sends the relevant messages and notifications.
     39   void RemovePermissions(const Extension* extension,
     40                          const PermissionSet* permissions);
     41 
     42   // Adds all permissions in the |extension|'s active permissions to its
     43   // granted permission set.
     44   void GrantActivePermissions(const Extension* extension);
     45 
     46   // Sets the |extension|'s active permissions to |permissions|.
     47   void UpdateActivePermissions(const Extension* extension,
     48                                const PermissionSet* permissions);
     49 
     50  private:
     51   enum EventType {
     52     ADDED,
     53     REMOVED,
     54   };
     55 
     56   // Dispatches specified event to the extension.
     57   void DispatchEvent(const std::string& extension_id,
     58                      const char* event_name,
     59                      const PermissionSet* changed_permissions);
     60 
     61   // Issues the relevant events, messages and notifications when the
     62   // |extension|'s permissions have |changed| (|changed| is the delta).
     63   // Specifically, this sends the EXTENSION_PERMISSIONS_UPDATED notification,
     64   // the ExtensionMsg_UpdatePermissions IPC message, and fires the
     65   // onAdded/onRemoved events in the extension.
     66   void NotifyPermissionsUpdated(EventType event_type,
     67                                 const Extension* extension,
     68                                 const PermissionSet* changed);
     69 
     70   // Gets the ExtensionPrefs for the associated profile.
     71   ExtensionPrefs* GetExtensionPrefs();
     72 
     73   Profile* profile_;
     74 };
     75 
     76 }  // namespace extensions
     77 
     78 #endif  // CHROME_BROWSER_EXTENSIONS_PERMISSIONS_UPDATER_H__
     79