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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
|
// Copyright 2020 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 COMPONENTS_POLICY_CORE_BROWSER_POLICY_CONVERSIONS_CLIENT_H_
#define COMPONENTS_POLICY_CORE_BROWSER_POLICY_CONVERSIONS_CLIENT_H_
#include <set>
#include <string>
#include "base/memory/scoped_refptr.h"
#include "base/values.h"
#include "build/branding_buildflags.h"
#include "build/build_config.h"
#include "build/chromeos_buildflags.h"
#include "components/policy/core/browser/policy_conversions.h"
#include "components/policy/core/common/schema.h"
#include "components/policy/policy_export.h"
#include "third_party/abseil-cpp/absl/types/optional.h"
namespace policy {
class ConfigurationPolicyHandlerList;
class PolicyErrorMap;
class PolicyService;
class Schema;
class SchemaMap;
class SchemaRegistry;
using PoliciesSet = std::set<std::string>;
// PolicyConversionsClient supplies embedder-specific information that is needed
// by the PolicyConversions class. It also provides common utilities and
// helpers needed to compute and format policy information. Embedders must
// subclass PolicyConversionsClient and provide an instance to
// PolicyConversions.
class POLICY_EXPORT PolicyConversionsClient {
public:
PolicyConversionsClient();
virtual ~PolicyConversionsClient();
// Set to get policy types as human friendly string instead of enum integer.
// Policy types includes policy source, policy scope and policy level.
// Enabled by default.
void EnableConvertTypes(bool enabled);
// Set to get dictionary policy value as JSON string.
// Disabled by default.
void EnableConvertValues(bool enabled);
// Set to get device local account policies on ChromeOS.
// Disabled by default.
void EnableDeviceLocalAccountPolicies(bool enabled);
// Set to get device basic information on ChromeOS.
// Disabled by default.
void EnableDeviceInfo(bool enabled);
// Set to enable pretty print for all JSON string.
// Enabled by default.
void EnablePrettyPrint(bool enabled);
// Set to get all user scope policies.
// Enabled by default.
void EnableUserPolicies(bool enabled);
// Set to drop the policies of which value is a default one set by the policy
// provider. Disabled by default.
void SetDropDefaultValues(bool enabled);
#if BUILDFLAG(IS_WIN) && BUILDFLAG(GOOGLE_CHROME_BRANDING)
// Sets the updater policies.
void SetUpdaterPolicies(std::unique_ptr<PolicyMap> policies);
// Returns true if this client is able to return information on the updater's
// policies.
bool HasUpdaterPolicies() const;
base::Value GetUpdaterPolicies();
// Sets the updater policy schemas.
void SetUpdaterPolicySchemas(PolicyConversions::PolicyToSchemaMap schemas);
#endif // BUILDFLAG(IS_WIN) && BUILDFLAG(GOOGLE_CHROME_BRANDING)
// Converts the given |value| to JSON, respecting the configuration
// preferences that were set on this client.
std::string ConvertValueToJSON(const base::Value& value) const;
// Returns policies for Chrome browser. Must only be called if
// |HasUserPolicies()| returns true.
base::Value GetChromePolicies();
// Returns precedence-related policies for Chrome browser. Must only be called
// if |HasUserPolicies()| returns true.
base::Value GetPrecedencePolicies();
// Returns an array containing the ordered precedence strings.
base::Value GetPrecedenceOrder();
// Returns true if this client is able to return information on user
// policies.
virtual bool HasUserPolicies() const = 0;
// Returns policies for Chrome extensions.
virtual base::Value GetExtensionPolicies(PolicyDomain policy_domain) = 0;
#if BUILDFLAG(IS_CHROMEOS_ASH)
// Returns policies for ChromeOS device.
virtual base::Value GetDeviceLocalAccountPolicies() = 0;
// Returns device specific information if this device is enterprise managed.
virtual base::Value GetIdentityFields() = 0;
#endif
// Returns the embedder's PolicyService.
virtual PolicyService* GetPolicyService() const = 0;
// Returns the embedder's SchemaRegistry.
virtual SchemaRegistry* GetPolicySchemaRegistry() const = 0;
// Returns the embedder's ConfigurationPolicyHandlerList.
virtual const ConfigurationPolicyHandlerList* GetHandlerList() const = 0;
protected:
// Returns a copy of |value|. If necessary (which is specified by
// |convert_values_enabled_|), converts some values to a representation that
// i18n_template.js will display.
base::Value CopyAndMaybeConvert(const base::Value& value,
const absl::optional<Schema>& schema) const;
// Creates a description of the policy |policy_name| using |policy| and the
// optional errors in |errors| to determine the status of each policy.
// |known_policy_schemas| contains |Schema|s for known policies in the same
// policy namespace of |map|. |deprecated_policies| holds deprecated policies.
// |future_policies| holds unreleased policies. A policy without an entry in
// |known_policy_schemas| is an unknown policy.
base::Value GetPolicyValue(
const std::string& policy_name,
const PolicyMap::Entry& policy,
const PoliciesSet& deprecated_policies,
const PoliciesSet& future_policies,
PolicyErrorMap* errors,
const absl::optional<PolicyConversions::PolicyToSchemaMap>&
known_policy_schemas) const;
// Returns a description of each policy in |map| as Value, using the
// optional errors in |errors| to determine the status of each policy.
// |known_policy_schemas| contains |Schema|s for known policies in the same
// policy namespace of |map|. |deprecated_policies| holds deprecated policies.
// |future_policies| holds unreleased policies. A policy in |map| but without
// an entry |known_policy_schemas| is an unknown policy.
base::Value GetPolicyValues(
const PolicyMap& map,
PolicyErrorMap* errors,
const PoliciesSet& deprecated_policies,
const PoliciesSet& future_policies,
const absl::optional<PolicyConversions::PolicyToSchemaMap>&
known_policy_schemas) const;
// Returns the Schema for |policy_name| if that policy is known. If the policy
// is unknown, returns |absl::nullopt|.
absl::optional<Schema> GetKnownPolicySchema(
const absl::optional<PolicyConversions::PolicyToSchemaMap>&
known_policy_schemas,
const std::string& policy_name) const;
absl::optional<PolicyConversions::PolicyToSchemaMap> GetKnownPolicies(
const scoped_refptr<SchemaMap> schema_map,
const PolicyNamespace& policy_namespace) const;
// Returns whether this client was configured to get device local account
// policies on ChromeOS.
bool GetDeviceLocalAccountPoliciesEnabled() const;
// Returns whether this client was configured to get device basic information
// on ChromeOS.
bool GetDeviceInfoEnabled() const;
// Returns whether this client was configured to get all user scope policies.
bool GetUserPoliciesEnabled() const;
private:
friend class PolicyConversionsClientTest;
#if BUILDFLAG(IS_WIN) && BUILDFLAG(GOOGLE_CHROME_BRANDING)
std::unique_ptr<PolicyMap> updater_policies_;
absl::optional<PolicyConversions::PolicyToSchemaMap> updater_policy_schemas_;
#endif // BUILDFLAG(GOOGLE_CHROME_BRANDING) && BUILDFLAG(IS_WIN)
bool convert_types_enabled_ = true;
bool convert_values_enabled_ = false;
bool device_local_account_policies_enabled_ = false;
bool device_info_enabled_ = false;
bool pretty_print_enabled_ = true;
bool user_policies_enabled_ = true;
bool drop_default_values_enabled_ = false;
};
} // namespace policy
#endif // COMPONENTS_POLICY_CORE_BROWSER_POLICY_CONVERSIONS_CLIENT_H_
|
