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
|
// Copyright 2015 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_PROXIMITY_AUTH_REMOTE_DEVICE_LIFE_CYCLE_H
#define COMPONENTS_PROXIMITY_AUTH_REMOTE_DEVICE_LIFE_CYCLE_H
#include "base/macros.h"
#include "components/proximity_auth/remote_device.h"
namespace proximity_auth {
class Authenticator;
class Messenger;
class ConnectionFinder;
// Controls the life cycle of connecting and authenticating to a remote device.
// After the life cycle is started, it can be in the following states:
// FINDING_CONNECTION:
// Continuiously attempts to create a connection to the remote device.
// After connecting, transitions to the AUTHENTICATING state.
// AUTHENTICATING:
// Verifies that the connected device has the correct credentials. On
// success, transitions to SECURE_CHANNEL_ESTABLISHED; otherwise,
// transitions to AUTHENTICATION_FAILED.
// SECURE_CHANNEL_ESTABLISHED:
// Can send and receive messages securely from the remote device. Upon
// disconnection, transitions to FINDING_CONNECTION.
// AUTHENTICATION_FAILED:
// Recovery state after authentication fails. After a brief wait,
// transition to FINDING_CONNECTION.
// To stop the life cycle and clean up the connection, simply destroying this
// object.
class RemoteDeviceLifeCycle {
public:
// The possible states in the life cycle.
enum class State {
STOPPED,
FINDING_CONNECTION,
AUTHENTICATING,
SECURE_CHANNEL_ESTABLISHED,
AUTHENTICATION_FAILED,
};
// Interface for observing changes to the life cycle.
class Observer {
public:
virtual ~Observer() {}
// Called when the state in the life cycle changes.
virtual void OnLifeCycleStateChanged(State old_state, State new_state) = 0;
};
virtual ~RemoteDeviceLifeCycle() {}
// Starts the life cycle.
virtual void Start() = 0;
// Returns the RemoteDevice instance that this life cycle manages.
virtual RemoteDevice GetRemoteDevice() const = 0;
// Returns the current state of in the life cycle.
virtual State GetState() const = 0;
// Returns the client for sending and receiving messages. This function will
// only return an instance if the state is SECURE_CHANNEL_ESTABLISHED;
// otherwise, it will return nullptr.
virtual Messenger* GetMessenger() = 0;
// Adds an observer.
virtual void AddObserver(Observer* observer) = 0;
// Removes an observer.
virtual void RemoveObserver(Observer* observer) = 0;
};
} // namespace proximity_auth
#endif // COMPONENTS_PROXIMITY_AUTH_REMOTE_DEVICE_LIFE_CYCLE_H
|
