1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
// 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.
#ifndef CHROME_BROWSER_EXTENSIONS_EXTENSION_MANAGEMENT_INTERNAL_H_
#define CHROME_BROWSER_EXTENSIONS_EXTENSION_MANAGEMENT_INTERNAL_H_
#include <string>
#include <vector>
#include "base/macros.h"
#include "chrome/browser/extensions/extension_management.h"
#include "extensions/common/manifest.h"
#include "extensions/common/permissions/api_permission_set.h"
namespace base {
class DictionaryValue;
class Version;
} // namespace base
namespace extensions {
class URLPatternSet;
namespace internal {
// Class to hold extension management settings for one or a group of
// extensions. Settings can be applied to an individual extension identified
// by an ID, a group of extensions with specific |update_url| or all
// extensions at once.
// The settings applied to all extensions are the default settings and can be
// overridden by per-extension or per-update-url settings.
// There are multiple fields in this class. Unspecified fields in per-extension
// and per-update-url settings will take value from default settings (or merge
// from that, see per-field comments below for details). Unspecified fields in
// default extensions will take the default fall back value instead.
// Since update URL is not directly associated to extension ID, per-extension
// and per-update-url settings might be enforced at the same time, see per-field
// comments below for details.
struct IndividualSettings {
enum ParsingScope {
// Parses the default settings.
SCOPE_DEFAULT = 0,
// Parses the settings for extensions with specified update URL in its
// manifest.
SCOPE_UPDATE_URL,
// Parses the settings for an extension with specified extension ID.
SCOPE_INDIVIDUAL,
};
IndividualSettings();
explicit IndividualSettings(const IndividualSettings* default_settings);
~IndividualSettings();
void Reset();
// Parses the individual settings. |dict| is a sub-dictionary in extension
// management preference and |scope| represents the applicable range of the
// settings, a single extension, a group of extensions or default settings.
// Note that in case of parsing errors, |this| will NOT be left untouched.
// This method is required to be called for SCOPE_DEFAULT first, then
// for SCOPE_INDIVIDUAL and SCOPE_UPDATE_URL.
bool Parse(const base::DictionaryValue* dict, ParsingScope scope);
// Extension installation mode. Setting this to INSTALLATION_FORCED or
// INSTALLATION_RECOMMENDED will enable extension auto-loading (only
// applicable to single extension), and in this case the |update_url| must
// be specified, containing the update URL for this extension.
// Note that |update_url| will be ignored for INSTALLATION_ALLOWED and
// INSTALLATION_BLOCKED installation mode.
// This setting will override the default settings, and unspecified
// setting will take value from default settings.
// In case this setting is specified in both per-extensions and
// per-update-url settings, per-extension settings will override
// per-update-url settings.
ExtensionManagement::InstallationMode installation_mode;
std::string update_url;
// Permissions block list for extensions. This setting won't grant permissions
// to extensions automatically. Instead, this setting will provide a list of
// blocked permissions for each extension. That is, if an extension requires a
// permission which has been blacklisted, this extension will not be allowed
// to load. And if it contains a blocked permission as optional requirement,
// it will be allowed to load (of course, with permission granted from user if
// necessary), but conflicting permissions will be dropped. This setting will
// merge from the default settings, and unspecified settings will take value
// from default settings.
// In case this setting is specified in both per-extensions and per-update-url
// settings, both settings will be enforced.
APIPermissionSet blocked_permissions;
// Minimum version required for an extensions, applies to per-extension
// settings only. Extension (with specified extension ID) with version older
// than the specified minimum version will be disabled.
scoped_ptr<base::Version> minimum_version_required;
private:
DISALLOW_COPY_AND_ASSIGN(IndividualSettings);
};
// Global extension management settings, applicable to all extensions.
struct GlobalSettings {
GlobalSettings();
~GlobalSettings();
void Reset();
// Settings specifying which URLs are allowed to install extensions, will be
// enforced only if |has_restricted_install_sources| is set to true.
URLPatternSet install_sources;
bool has_restricted_install_sources;
// Settings specifying all allowed app/extension types, will be enforced
// only of |has_restricted_allowed_types| is set to true.
std::vector<Manifest::Type> allowed_types;
bool has_restricted_allowed_types;
private:
DISALLOW_COPY_AND_ASSIGN(GlobalSettings);
};
} // namespace internal
} // namespace extensions
#endif // CHROME_BROWSER_EXTENSIONS_EXTENSION_MANAGEMENT_INTERNAL_H_
|
