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
|
// Copyright 2022 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROMEOS_ASH_COMPONENTS_NETWORK_MANAGED_CELLULAR_PREF_HANDLER_H_
#define CHROMEOS_ASH_COMPONENTS_NETWORK_MANAGED_CELLULAR_PREF_HANDLER_H_
#include "base/component_export.h"
#include "base/memory/raw_ptr.h"
#include "base/observer_list.h"
#include "base/observer_list_types.h"
#include "chromeos/ash/components/network/policy_util.h"
#include "components/prefs/pref_service.h"
class PrefService;
class PrefRegistrySimple;
namespace ash {
class NetworkStateHandler;
// This class provides the ability to store and query prefs for managed cellular
// networks.
class COMPONENT_EXPORT(CHROMEOS_NETWORK) ManagedCellularPrefHandler {
public:
class Observer : public base::CheckedObserver {
public:
~Observer() override = default;
// Invoked when metadata of a managed eSIM profile is added or removed.
virtual void OnManagedCellularPrefChanged() = 0;
};
ManagedCellularPrefHandler();
ManagedCellularPrefHandler(const ManagedCellularPrefHandler&) = delete;
ManagedCellularPrefHandler& operator=(const ManagedCellularPrefHandler&) =
delete;
virtual ~ManagedCellularPrefHandler();
static void RegisterLocalStatePrefs(PrefRegistrySimple* registry);
void Init(NetworkStateHandler* network_state_handler);
void SetDevicePrefs(PrefService* device_prefs);
// Persistes the eSIM metadata for a managed cellular network to device prefs.
// If |sync_stub_networks| is set true,
// NetworkStateHandler::SyncStubCellularNetworks() will be called.
void AddESimMetadata(const std::string& iccid,
const std::string& name,
const policy_util::SmdxActivationCode& activation_code,
bool sync_stub_networks = true);
// Returns the persisted eSIM metadata that corresponds to ICCID |iccid|, if
// it exists, otherwise returns |nullptr|.
const base::Value::Dict* GetESimMetadata(const std::string& iccid);
// Removes the persisted eSIM metadata that corresponds to ICCID |iccid|. This
// should only be done when the eSIM profile is removed from the device.
void RemoveESimMetadata(const std::string& iccid);
// Returns whether there is persisted eSIM metadata that corresponds to ICCID
// |iccid|, and whether this metadata indicates that the eSIM is actively
// managed. If the eSIM was installed by policy, but the policy was
// subsequently removed, the metadata will still exist but will indicate that
// the profile is not actively managed.
bool IsESimManaged(const std::string& iccid);
// Updates the eSIM metadata that corresponds to ICCID |iccid|, if it exists,
// to reflect that there is no longer an active policy for the relevant eSIM.
// This allows the eSIM metadata for eSIM profiles that were installed by
// policy to be persisted even after the policy is removed.
void SetPolicyMissing(const std::string& iccid);
// Marks cellular network with iccid |iccid| as migrated to the APN revamp
// feature. See (b/162365553).
virtual void AddApnMigratedIccid(const std::string& iccid);
// Return true if the |iccid| has been migrated to the APN Revamp feature.
virtual bool ContainsApnMigratedIccid(const std::string& iccid) const;
void AddObserver(Observer* observer);
void RemoveObserver(Observer* observer);
bool HasObserver(Observer* observer) const;
private:
// This change migrates the existing prefs, the ICCID and SM-DP+ pairs, to the
// new eSIM metadata format that includes the ICCID, SM-DX activation code,
// and name of the network as provided by policy. Since the previous format
// did not contain a name the migrated entries will not contain a name until
// subsequent policy application. This will overwrite existing entries and
// should only be called once.
void MigrateExistingPrefs();
void NotifyManagedCellularPrefChanged();
raw_ptr<NetworkStateHandler> network_state_handler_ = nullptr;
// Initialized to null and set once SetDevicePrefs() is called.
raw_ptr<PrefService> device_prefs_ = nullptr;
base::ObserverList<Observer> observer_list_;
};
} // namespace ash
#endif // CHROMEOS_ASH_COMPONENTS_NETWORK_MANAGED_CELLULAR_PREF_HANDLER_H_
|
