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
|
// 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_SUPERVISED_USER_SUPERVISED_USER_SYNC_SERVICE_H_
#define CHROME_BROWSER_SUPERVISED_USER_SUPERVISED_USER_SYNC_SERVICE_H_
#include <string>
#include <vector>
#include "base/callback_forward.h"
#include "base/memory/scoped_ptr.h"
#include "base/observer_list.h"
#include "base/prefs/pref_change_registrar.h"
#include "chrome/browser/supervised_user/supervised_user_sync_service_observer.h"
#include "chrome/browser/supervised_user/supervised_users.h"
#include "components/keyed_service/core/keyed_service.h"
#include "sync/api/syncable_service.h"
namespace base {
class DictionaryValue;
}
namespace user_prefs {
class PrefRegistrySyncable;
}
class PrefService;
class SupervisedUserSyncService : public KeyedService,
public syncer::SyncableService {
public:
// For use with GetSupervisedUsersAsync() below.
typedef base::Callback<void(const base::DictionaryValue*)>
SupervisedUsersCallback;
// Dictionary keys for entry values of |prefs::kSupervisedUsers|.
static const char kAcknowledged[];
static const char kChromeAvatar[];
static const char kChromeOsAvatar[];
static const char kMasterKey[];
static const char kPasswordSignatureKey[];
static const char kPasswordEncryptionKey[];
static const char kName[];
// Represents a non-existing avatar on Chrome and Chrome OS.
static const int kNoAvatar;
virtual ~SupervisedUserSyncService();
static void RegisterProfilePrefs(user_prefs::PrefRegistrySyncable* registry);
// Extracts the avatar index from the input |avatar_str| and set
// |avatar_index| to hold the extracted value. Returns true if the
// index was extracted successfully and false otherwise.
// |avatar_str| should have the format: "chrome-avatar-index:INDEX"
// where INDEX is the integer to be extracted. |avatar_str| can be empty
// in case there is no avatar synced for a supervised user in which case
// |avatar_index| is set to -1.
static bool GetAvatarIndex(const std::string& avatar_str,
int* avatar_index);
// Given an |avatar_index|, it returns a string of the form:
// "chrome-avatar-index:INDEX" where INDEX = |avatar_index|.
// It is exposed for testing purposes only.
static std::string BuildAvatarString(int avatar_index);
void AddObserver(SupervisedUserSyncServiceObserver* observer);
void RemoveObserver(SupervisedUserSyncServiceObserver* observer);
void AddSupervisedUser(const std::string& id,
const std::string& name,
const std::string& master_key,
const std::string& signature_key,
const std::string& encryption_key,
int avatar_index);
void UpdateSupervisedUser(const std::string& id,
const std::string& name,
const std::string& master_key,
const std::string& signature_key,
const std::string& encryption_key,
int avatar_index);
void DeleteSupervisedUser(const std::string& id);
// Updates the supervised user avatar only if the supervised user has
// no avatar and |avatar_index| is set to some value other than
// |kNoAvatar|. If |avatar_index| equals |kNoAvatar| and the
// supervised user has an avatar, it will be cleared. However,
// to clear an avatar call the convenience method
// |ClearSupervisedUserAvatar()|.
// Returns true if the avatar value is changed (either updated or cleared)
// and false otherwise.
bool UpdateSupervisedUserAvatarIfNeeded(const std::string& id,
int avatar_index);
void ClearSupervisedUserAvatar(const std::string& id);
// Returns a dictionary containing all supervised users supervised by this
// custodian. This method should only be called once this service has started
// syncing supervised users (i.e. has finished its initial merge of local and
// server-side data, via MergeDataAndStartSyncing), as the stored data might
// be outdated before that.
const base::DictionaryValue* GetSupervisedUsers();
// Calls the passed |callback| with a dictionary containing all supervised
// users managed by this custodian.
void GetSupervisedUsersAsync(const SupervisedUsersCallback& callback);
// KeyedService implementation:
virtual void Shutdown() override;
// SyncableService implementation:
virtual syncer::SyncMergeResult MergeDataAndStartSyncing(
syncer::ModelType type,
const syncer::SyncDataList& initial_sync_data,
scoped_ptr<syncer::SyncChangeProcessor> sync_processor,
scoped_ptr<syncer::SyncErrorFactory> error_handler) override;
virtual void StopSyncing(syncer::ModelType type) override;
virtual syncer::SyncDataList GetAllSyncData(syncer::ModelType type) const
override;
virtual syncer::SyncError ProcessSyncChanges(
const tracked_objects::Location& from_here,
const syncer::SyncChangeList& change_list) override;
private:
friend class SupervisedUserSyncServiceFactory;
// Use |SupervisedUserSyncServiceFactory::GetForProfile(...)| to get an
// instance of this service.
explicit SupervisedUserSyncService(PrefService* prefs);
void OnLastSignedInUsernameChange();
scoped_ptr<base::DictionaryValue> CreateDictionary(
const std::string& name,
const std::string& master_key,
const std::string& signature_key,
const std::string& encryption_key,
int avatar_index);
void UpdateSupervisedUserImpl(const std::string& id,
const std::string& name,
const std::string& master_key,
const std::string& signature_key,
const std::string& encryption_key,
int avatar_index,
bool add_user);
void NotifySupervisedUserAcknowledged(const std::string& supervised_user_id);
void NotifySupervisedUsersSyncingStopped();
void NotifySupervisedUsersChanged();
void DispatchCallbacks();
PrefService* prefs_;
PrefChangeRegistrar pref_change_registrar_;
scoped_ptr<syncer::SyncChangeProcessor> sync_processor_;
scoped_ptr<syncer::SyncErrorFactory> error_handler_;
ObserverList<SupervisedUserSyncServiceObserver> observers_;
std::vector<SupervisedUsersCallback> callbacks_;
DISALLOW_COPY_AND_ASSIGN(SupervisedUserSyncService);
};
#endif // CHROME_BROWSER_SUPERVISED_USER_SUPERVISED_USER_SYNC_SERVICE_H_
|
