| OLD | NEW |
| (Empty) |
| 1 // Copyright (c) 2010 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 WEBKIT_GLUE_PLUGINS_PLUGIN_GROUP_H_ | |
| 6 #define WEBKIT_GLUE_PLUGINS_PLUGIN_GROUP_H_ | |
| 7 #pragma once | |
| 8 | |
| 9 #include <map> | |
| 10 #include <set> | |
| 11 #include <string> | |
| 12 #include <vector> | |
| 13 | |
| 14 #include "base/gtest_prod_util.h" | |
| 15 #include "base/scoped_ptr.h" | |
| 16 #include "base/string16.h" | |
| 17 | |
| 18 class DictionaryValue; | |
| 19 class FilePath; | |
| 20 class Version; | |
| 21 struct WebPluginInfo; | |
| 22 | |
| 23 namespace NPAPI { | |
| 24 class PluginList; | |
| 25 }; | |
| 26 | |
| 27 // Hard-coded version ranges for plugin groups. | |
| 28 struct VersionRangeDefinition { | |
| 29 // Matcher for lowest version matched by this range (inclusive). May be empty | |
| 30 // to match everything iff |version_matcher_high| is also empty. | |
| 31 const char* version_matcher_low; | |
| 32 // Matcher for highest version matched by this range (exclusive). May be empty | |
| 33 // to match anything higher than |version_matcher_low|. | |
| 34 const char* version_matcher_high; | |
| 35 const char* min_version; // Minimum secure version. | |
| 36 }; | |
| 37 | |
| 38 // Hard-coded definitions of plugin groups. | |
| 39 struct PluginGroupDefinition { | |
| 40 const char* identifier; // Unique identifier for this group. | |
| 41 const char* name; // Name of this group. | |
| 42 const char* name_matcher; // Substring matcher for the plugin name. | |
| 43 const VersionRangeDefinition* versions; // List of version ranges. | |
| 44 const size_t num_versions; // Size of the array |versions| points to. | |
| 45 const char* update_url; // Location of latest secure version. | |
| 46 }; | |
| 47 | |
| 48 // Run-time structure to hold version range information. | |
| 49 struct VersionRange { | |
| 50 public: | |
| 51 explicit VersionRange(VersionRangeDefinition definition); | |
| 52 VersionRange(const VersionRange& other); | |
| 53 VersionRange& operator=(const VersionRange& other); | |
| 54 ~VersionRange(); | |
| 55 | |
| 56 std::string low_str; | |
| 57 std::string high_str; | |
| 58 std::string min_str; | |
| 59 scoped_ptr<Version> low; | |
| 60 scoped_ptr<Version> high; | |
| 61 scoped_ptr<Version> min; | |
| 62 private: | |
| 63 void InitFrom(const VersionRange& other); | |
| 64 }; | |
| 65 | |
| 66 // A PluginGroup can match a range of versions of a specific plugin (as defined | |
| 67 // by matching a substring of its name). | |
| 68 // It contains all WebPluginInfo structs (at least one) matching its definition. | |
| 69 // In addition, it knows about a security "baseline", i.e. the minimum version | |
| 70 // of a plugin that is needed in order not to exhibit known security | |
| 71 // vulnerabilities. | |
| 72 | |
| 73 class PluginGroup { | |
| 74 public: | |
| 75 // Used by about:plugins to disable Reader plugin when internal PDF viewer is | |
| 76 // enabled. | |
| 77 static const char* kAdobeReaderGroupName; | |
| 78 | |
| 79 PluginGroup(const PluginGroup& other); | |
| 80 | |
| 81 ~PluginGroup(); | |
| 82 | |
| 83 PluginGroup& operator=(const PluginGroup& other); | |
| 84 | |
| 85 // Configures the set of plugin name patterns for disabling plugins via | |
| 86 // enterprise configuration management. | |
| 87 static void SetPolicyDisabledPluginPatterns(const std::set<string16>& set); | |
| 88 | |
| 89 // Tests to see if a plugin is on the blacklist using its name as | |
| 90 // the lookup key. | |
| 91 static bool IsPluginNameDisabledByPolicy(const string16& plugin_name); | |
| 92 | |
| 93 // Tests to see if a plugin is on the blacklist using its path as | |
| 94 // the lookup key. | |
| 95 static bool IsPluginPathDisabledByPolicy(const FilePath& plugin_path); | |
| 96 | |
| 97 // Returns true if the given plugin matches this group. | |
| 98 bool Match(const WebPluginInfo& plugin) const; | |
| 99 | |
| 100 // Adds the given plugin to this group. Provide the position of the | |
| 101 // plugin as given by PluginList so we can display its priority. | |
| 102 void AddPlugin(const WebPluginInfo& plugin, int position); | |
| 103 | |
| 104 // Enables/disables this group. This enables/disables all plugins in the | |
| 105 // group. | |
| 106 void Enable(bool enable); | |
| 107 | |
| 108 // Returns whether the plugin group is enabled or not. | |
| 109 bool Enabled() const { return enabled_; } | |
| 110 | |
| 111 // Returns a unique identifier for this group, if one is defined, or the empty | |
| 112 // string otherwise. | |
| 113 const std::string& identifier() const { return identifier_; } | |
| 114 | |
| 115 // Returns this group's name, or the filename without extension if the name | |
| 116 // is empty. | |
| 117 string16 GetGroupName() const; | |
| 118 | |
| 119 // Returns the description of the highest-priority plug-in in the group. | |
| 120 const string16& description() const { return description_; } | |
| 121 | |
| 122 // Returns a DictionaryValue with data to display in the UI. | |
| 123 DictionaryValue* GetDataForUI() const; | |
| 124 | |
| 125 // Returns a DictionaryValue with data to save in the preferences. | |
| 126 DictionaryValue* GetSummary() const; | |
| 127 | |
| 128 // Returns the update URL. | |
| 129 std::string GetUpdateURL() const { return update_url_; } | |
| 130 | |
| 131 // Returns true if the highest-priority plugin in this group has known | |
| 132 // security problems. | |
| 133 bool IsVulnerable() const; | |
| 134 | |
| 135 // Disables all plugins in this group that are older than the | |
| 136 // minimum version. | |
| 137 void DisableOutdatedPlugins(); | |
| 138 | |
| 139 // Parse a version string as used by a plug-in. This method is more lenient | |
| 140 // in accepting weird version strings than Version::GetFromString(). | |
| 141 static Version* CreateVersionFromString(const string16& version_string); | |
| 142 | |
| 143 private: | |
| 144 typedef std::map<std::string, PluginGroup*> PluginMap; | |
| 145 | |
| 146 friend class NPAPI::PluginList; | |
| 147 friend class PluginGroupTest; | |
| 148 friend class TableModelArrayControllerTest; | |
| 149 friend class PluginExceptionsTableModelTest; | |
| 150 | |
| 151 // Generates the (short) identifier string for the given plugin. | |
| 152 static std::string GetIdentifier(const WebPluginInfo& wpi); | |
| 153 | |
| 154 // Generates the long identifier (based on the full file path) for the given | |
| 155 // plugin, to be called when the short identifier is not unique. | |
| 156 static std::string GetLongIdentifier(const WebPluginInfo& wpi); | |
| 157 | |
| 158 // Creates a PluginGroup from a PluginGroupDefinition. The caller takes | |
| 159 // ownership of the created PluginGroup. | |
| 160 static PluginGroup* FromPluginGroupDefinition( | |
| 161 const PluginGroupDefinition& definition); | |
| 162 | |
| 163 // Creates a PluginGroup from a WebPluginInfo. The caller takes ownership of | |
| 164 // the created PluginGroup. | |
| 165 static PluginGroup* FromWebPluginInfo(const WebPluginInfo& wpi); | |
| 166 | |
| 167 // Returns |true| if |version| is contained in [low, high) of |range|. | |
| 168 static bool IsVersionInRange(const Version& version, | |
| 169 const VersionRange& range); | |
| 170 | |
| 171 // Returns |true| iff |plugin_version| is both contained in |version_range| | |
| 172 // and declared outdated (== vulnerable) by it. | |
| 173 static bool IsPluginOutdated(const Version& plugin_version, | |
| 174 const VersionRange& version_range); | |
| 175 | |
| 176 PluginGroup(const string16& group_name, | |
| 177 const string16& name_matcher, | |
| 178 const std::string& update_url, | |
| 179 const std::string& identifier); | |
| 180 | |
| 181 void InitFrom(const PluginGroup& other); | |
| 182 | |
| 183 // Set the description and version for this plugin group from the | |
| 184 // given plug-in. | |
| 185 void UpdateDescriptionAndVersion(const WebPluginInfo& plugin); | |
| 186 | |
| 187 // Updates the active plugin in the group. The active plugin is the first | |
| 188 // enabled one, or if all plugins are disabled, simply the first one. | |
| 189 void UpdateActivePlugin(const WebPluginInfo& plugin); | |
| 190 | |
| 191 static std::set<string16>* policy_disabled_plugin_patterns_; | |
| 192 | |
| 193 std::string identifier_; | |
| 194 string16 group_name_; | |
| 195 string16 name_matcher_; | |
| 196 string16 description_; | |
| 197 std::string update_url_; | |
| 198 bool enabled_; | |
| 199 std::vector<VersionRange> version_ranges_; | |
| 200 scoped_ptr<Version> version_; | |
| 201 std::vector<WebPluginInfo> web_plugin_infos_; | |
| 202 std::vector<int> web_plugin_positions_; | |
| 203 }; | |
| 204 | |
| 205 #endif // WEBKIT_GLUE_PLUGINS_PLUGIN_GROUP_H_ | |
| OLD | NEW |