chrome/common/extensions/permissions/chrome_permission_message_provider.h

   1 // Copyright 2013 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_COMMON_EXTENSIONS_PERMISSIONS_CHROME_PERMISSION_MESSAGE_PROVIDER_H_
   6 #define CHROME_COMMON_EXTENSIONS_PERMISSIONS_CHROME_PERMISSION_MESSAGE_PROVIDER_H_
   7
   8 #include <set>
   9
  10 #include "base/basictypes.h"
  11 #include "base/gtest_prod_util.h"
  12 #include "base/strings/string16.h"
  13 #include "extensions/common/permissions/permission_message_provider.h"
  14
  15 namespace extensions {
  16
  17 // Tested in two places:
  18 // 1. chrome_permission_message_provider_unittest.cc, which is a regular unit
  19 //    test for this class
  20 // 2. chrome/browser/extensions/permission_messages_unittest.cc, which is an
  21 //    integration test that ensures messages are correctly generated for
  22 //    extensions created through the extension system.
  23 class ChromePermissionMessageProvider : public PermissionMessageProvider {
  24  public:
  25   ChromePermissionMessageProvider();
  26   ~ChromePermissionMessageProvider() override;
  27
  28   // PermissionMessageProvider implementation.
  29   PermissionMessages GetPermissionMessages(
  30       const PermissionIDSet& permissions) const override;
  31   bool IsPrivilegeIncrease(const PermissionSet* old_permissions,
  32                            const PermissionSet* new_permissions,
  33                            Manifest::Type extension_type) const override;
  34   PermissionIDSet GetAllPermissionIDs(
  35       const PermissionSet* permissions,
  36       Manifest::Type extension_type) const override;
  37
  38  private:
  39   // Adds any permission IDs from API permissions to |permission_ids|.
  40   void AddAPIPermissions(const PermissionSet* permissions,
  41                          PermissionIDSet* permission_ids) const;
  42
  43   // Adds any permission IDs from manifest permissions to |permission_ids|.
  44   void AddManifestPermissions(const PermissionSet* permissions,
  45                               PermissionIDSet* permission_ids) const;
  46
  47   // Adds any permission IDs from host permissions to |permission_ids|.
  48   void AddHostPermissions(const PermissionSet* permissions,
  49                           PermissionIDSet* permission_ids,
  50                           Manifest::Type extension_type) const;
  51
  52   // Returns true if |new_permissions| has an elevated API or manifest privilege
  53   // level compared to |old_permissions|.
  54   bool IsAPIOrManifestPrivilegeIncrease(
  55       const PermissionSet* old_permissions,
  56       const PermissionSet* new_permissions) const;
  57
  58   // Returns true if |new_permissions| has more host permissions compared to
  59   // |old_permissions|.
  60   bool IsHostPrivilegeIncrease(
  61       const PermissionSet* old_permissions,
  62       const PermissionSet* new_permissions,
  63       Manifest::Type extension_type) const;
  64
  65   DISALLOW_COPY_AND_ASSIGN(ChromePermissionMessageProvider);
  66 };
  67
  68 }  // namespace extensions
  69
  70 #endif  // CHROME_COMMON_EXTENSIONS_PERMISSIONS_CHROME_PERMISSION_MESSAGE_PROVIDER_H_