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
|
// Copyright 2021 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_WEBAUTHN_CABLEV2_DEVICES_H_
#define CHROME_BROWSER_WEBAUTHN_CABLEV2_DEVICES_H_
#include <array>
#include <memory>
#include <string_view>
#include <vector>
#include "base/containers/span.h"
#include "device/fido/fido_constants.h"
#include "third_party/icu/source/common/unicode/locid.h"
class PrefService;
class Profile;
namespace base {
class Time;
}
namespace syncer {
class DeviceInfo;
}
namespace user_prefs {
class PrefRegistrySyncable;
}
namespace device::cablev2 {
struct Pairing;
}
namespace cablev2 {
// RegisterProfilePrefs registers any preferences used by these functions. This
// must be called at browser startup otherwise the preferences won't be
// usable.
void RegisterProfilePrefs(user_prefs::PrefRegistrySyncable* registry);
// PairingFromSyncedDevice parses a `Pairing` from Sync's information about a
// device. This is exposed for testing.
std::unique_ptr<device::cablev2::Pairing> PairingFromSyncedDevice(
const syncer::DeviceInfo* device,
const base::Time& now);
// KnownDevices reflects the browser's knowledge of known caBLEv2 devices.
// caBLEv2 is the protocol used when phones are acting as security keys. (Except
// for the case where accounts.google.com is using caBLEv1, but Chrome doesn't
// store any state for caBLEv1.)
//
// There are two sources of caBLEv2 pairing information: DeviceInfo entries in
// Sync, and information sent by the phone during a QR-initiated transaction.
// DeviceInfo state is managed by Sync. Information from phones is kept in
// preferences. These sources are referred to in variable names as "synced"
// and "linked" devices.
//
// (Preferences may be synced, and thus information about "linked" phones may be
// synced around. But that is separate from learning about phones because they
// are signed into the same account and are publishing DeviceInfo records into
// Sync.)
//
// Call `FromProfile` to load the information from sync data and preferences.
// Alternatively, for testing, information can be added directly to the
// vectors.
struct KnownDevices {
KnownDevices();
~KnownDevices();
KnownDevices(const KnownDevices&) = delete;
KnownDevices(const KnownDevices&&) = delete;
KnownDevices& operator=(const KnownDevices&) = delete;
// FromProfile returns a `KnownDevices` by extracting them from the
// Sync data and preferencs of `browser_context`.
static std::unique_ptr<KnownDevices> FromProfile(Profile* profile);
// Names returns a list of all names (which may contain duplicates).
std::vector<std::string_view> Names() const;
std::vector<std::unique_ptr<device::cablev2::Pairing>> synced_devices;
std::vector<std::unique_ptr<device::cablev2::Pairing>> linked_devices;
};
// MergeDevices returns a merged and sorted list of pairings, suitable for
// display in UI. There may be sequential `Pairing`s with the same name.
// These should be merged before display and are returned in priority order for
// connections. Devices are sorted by name based on the given locale, which
// should be `icu::Locale::getDefault` in real code but should be a fixed locale
// in tests.
std::vector<std::unique_ptr<device::cablev2::Pairing>> MergeDevices(
std::unique_ptr<KnownDevices>,
const icu::Locale* locale);
// AddPairing records `pairing` in `pref_service`, displacing any existing
// pairing with the same public key. The name in `pairing` will be updated to
// avoid colliding with any existing pairing in `profile`. (Incognito profiles
// are expected to be filtered out before calling this function, but it's
// harmless to write devices into a transient `PrefService`.)
void AddPairing(Profile* profile,
std::unique_ptr<device::cablev2::Pairing> pairing);
// DeletePairingByPublicKey erases a pairing from `pref_service` by public key.
void DeletePairingByPublicKey(
PrefService* pref_service,
std::array<uint8_t, device::kP256X962Length> public_key);
// RenamePairing updates the linked phone from `pref_service` with the given
// public key so that its name is `new_name`. If `new_name` collides with
// `existing_names`, however, then it'll be updated so that it doesn't. Returns
// true on success and false if no linked phone matching `public_key` was
// found.
bool RenamePairing(
PrefService* pref_service,
const std::array<uint8_t, device::kP256X962Length>& public_key,
const std::string& new_name,
base::span<const std::string_view> existing_names);
} // namespace cablev2
#endif // CHROME_BROWSER_WEBAUTHN_CABLEV2_DEVICES_H_
|
