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
|
// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef EXTENSIONS_BROWSER_DISABLE_REASON_H_
#define EXTENSIONS_BROWSER_DISABLE_REASON_H_
#include <limits>
#include "base/containers/flat_set.h"
namespace extensions {
namespace disable_reason {
// Reasons a Chrome extension may be disabled. These are used in histograms, so
// do not remove/reorder entries - only add at the end just before
// DISABLE_REASON_LAST (and update the shift value for it). Also remember to
// update the enum listing in tools/metrics/histograms.xml.
// Also carefully consider if your reason should sync to other devices, and if
// so, add it to kKnownSyncableDisableReasons in
// chrome/browser/extensions/extension_sync_service.cc.
// Finally, consider whether your disable reason applies to component
// extensions. Reference/update the existing list of applicable reasons in
// ExtensionsPrefs::ClearInapplicableDisableReasonsForComponentExtension.
enum DisableReason {
DISABLE_NONE = 0,
DISABLE_USER_ACTION = 1 << 0,
DISABLE_PERMISSIONS_INCREASE = 1 << 1,
DISABLE_RELOAD = 1 << 2,
DISABLE_UNSUPPORTED_REQUIREMENT = 1 << 3,
DISABLE_SIDELOAD_WIPEOUT = 1 << 4,
DEPRECATED_DISABLE_UNKNOWN_FROM_SYNC = 1 << 5,
// DISABLE_PERMISSIONS_CONSENT = 1 << 6, // Deprecated.
// DISABLE_KNOWN_DISABLED = 1 << 7, // Deprecated.
// Disabled because we could not verify the install.
DISABLE_NOT_VERIFIED = 1 << 8,
DISABLE_GREYLIST = 1 << 9,
DISABLE_CORRUPTED = 1 << 10,
DISABLE_REMOTE_INSTALL = 1 << 11,
// DISABLE_INACTIVE_EPHEMERAL_APP = 1 << 12, // Deprecated.
// External extensions might be disabled for user prompting.
DISABLE_EXTERNAL_EXTENSION = 1 << 13,
// Doesn't meet minimum version requirement.
DISABLE_UPDATE_REQUIRED_BY_POLICY = 1 << 14,
// Supervised user needs approval by custodian.
DISABLE_CUSTODIAN_APPROVAL_REQUIRED = 1 << 15,
// Blocked due to management policy.
DISABLE_BLOCKED_BY_POLICY = 1 << 16,
// DISABLE_BLOCKED_MATURE = 1 << 17, // Deprecated.
// DISABLE_REMOTELY_FOR_MALWARE = 1 << 18, // Deprecated.
DISABLE_REINSTALL = 1 << 19,
// Disabled by Safe Browsing extension allowlist enforcement.
DISABLE_NOT_ALLOWLISTED = 1 << 20,
// Deprecated, do not use in new code.
DEPRECATED_DISABLE_NOT_ASH_KEEPLISTED = 1 << 21,
// Disabled by policy when the extension is unpublished from the web store.
DISABLE_PUBLISHED_IN_STORE_REQUIRED_BY_POLICY = 1 << 22,
// Disabled because the extension uses an unsupported manifest version.
DISABLE_UNSUPPORTED_MANIFEST_VERSION = 1 << 23,
// Disabled because the extension is a "developer extension" (for example, an
// unpacked extension) while the developer mode is OFF.
DISABLE_UNSUPPORTED_DEVELOPER_EXTENSION = 1 << 24,
// Disabled because of an unknown reason. This can happen when newer versions
// of the browser sync reasons which are not known to the current version. We
// never actually write this to prefs. This is used to indicate (at runtime)
// that unknown reasons are present in the prefs.
DISABLE_UNKNOWN = 1 << 25,
// This should always be the last value.
DISABLE_REASON_LAST = 1LL << 26,
};
static_assert(DISABLE_REASON_LAST - 1 <= std::numeric_limits<int>::max(),
"The DisableReason bitmask cannot be stored in an int.");
} // namespace disable_reason
// TODO(crbug.com/372186532): Change this to `flat_set<DisableReason>`.
//
// We want the public methods in `ExtensionPrefs` to return / accept a
// `flat_set<DisableReason>` instead of a bitflag. To construct that set, all
// unknown integer values should be collapsed to `DISABLE_UNKNOWN`. Otherwise,
// it will trigger undefined behavior while type casting unknown integers to
// `DisableReason`. This collapsing logic hasn't been added yet. Thus, we can
// not construct a set of `DisableReason` yet. We are constructing a set of
// integers as a stopgap.
//
// The collapsing logic will be added once we are sure that all callers are
// ready to handle it. There might be some callers which need the actual values,
// and not the collapsed value. Such callers will be updated to use dedicated
// code paths to read / write raw integer values (see
// `ExtensionPrefs::DisableReasonRawManipulationPasskey`). Callers which don't
// care about the actual unknown values will be updated to use this type. We
// will ensure that this happens systematically while updating the
// `ExtensionPrefs` method signatures.
using DisableReasonSet = base::flat_set<int>;
// Validates that `reason` is a valid `DisableReason` (i.e. we have an enum
// value for it).
bool IsValidDisableReason(int reason);
// Utility methods to convert a bitflag to a set of integers and vice-versa.
// TODO(crbug.com/372186532): Remove these once we migrate away from bitflags
// completely.
int IntegerSetToBitflag(const base::flat_set<int>& set);
base::flat_set<int> BitflagToIntegerSet(int bit_flag);
} // namespace extensions
#endif // EXTENSIONS_BROWSER_DISABLE_REASON_H_
|
