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 PermissionSet* permissions,
  31       Manifest::Type extension_type) const override;
  32   std::vector<base::string16> GetWarningMessages(
  33       const PermissionSet* permissions,
  34       Manifest::Type extension_type) const override;
  35   std::vector<base::string16> GetWarningMessagesDetails(
  36       const PermissionSet* permissions,
  37       Manifest::Type extension_type) const override;
  38   bool IsPrivilegeIncrease(const PermissionSet* old_permissions,
  39                            const PermissionSet* new_permissions,
  40                            Manifest::Type extension_type) const override;
  41
  42  private:
  43   // Gets the permission messages for the API permissions.
  44   std::set<PermissionMessage> GetAPIPermissionMessages(
  45       const PermissionSet* permissions) const;
  46
  47   // Gets the permission messages for the Manifest permissions.
  48   std::set<PermissionMessage> GetManifestPermissionMessages(
  49       const PermissionSet* permissions) const;
  50
  51   // Gets the permission messages for the host permissions.
  52   std::set<PermissionMessage> GetHostPermissionMessages(
  53       const PermissionSet* permissions,
  54       Manifest::Type extension_type) const;
  55
  56   // Returns true if |new_permissions| has an elevated API privilege level
  57   // compared to |old_permissions|.
  58   bool IsAPIPrivilegeIncrease(
  59       const PermissionSet* old_permissions,
  60       const PermissionSet* new_permissions) const;
  61
  62   // Returns true if |new_permissions| has an elevated manifest permission
  63   // privilege level compared to |old_permissions|.
  64   bool IsManifestPermissionPrivilegeIncrease(
  65       const PermissionSet* old_permissions,
  66       const PermissionSet* new_permissions) const;
  67
  68   // Returns true if |new_permissions| has more host permissions compared to
  69   // |old_permissions|.
  70   bool IsHostPrivilegeIncrease(
  71       const PermissionSet* old_permissions,
  72       const PermissionSet* new_permissions,
  73       Manifest::Type extension_type) const;
  74
  75   DISALLOW_COPY_AND_ASSIGN(ChromePermissionMessageProvider);
  76 };
  77
  78 }  // namespace extensions
  79
  80 #endif  // CHROME_COMMON_EXTENSIONS_PERMISSIONS_CHROME_PERMISSION_MESSAGE_PROVIDER_H_