mukesh agrawal | 8a3188d | 2011-12-01 20:56:44 +0000 | [diff] [blame] | 1 | // Copyright (c) 2012 The Chromium OS Authors. All rights reserved. |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 2 | // Use of this source code is governed by a BSD-style license that can be |
| 3 | // found in the LICENSE file. |
| 4 | |
| 5 | #ifndef SHILL_WIFI_SERVICE_ |
| 6 | #define SHILL_WIFI_SERVICE_ |
| 7 | |
mukesh agrawal | 261daca | 2011-12-02 18:56:56 +0000 | [diff] [blame] | 8 | #include <set> |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 9 | #include <string> |
| 10 | #include <vector> |
| 11 | |
Darin Petkov | 4a09b6b | 2011-07-19 12:52:06 -0700 | [diff] [blame] | 12 | #include "shill/dbus_bindings/supplicant-interface.h" |
Paul Stewart | 26b327e | 2011-10-19 11:38:09 -0700 | [diff] [blame] | 13 | #include "shill/event_dispatcher.h" |
Chris Masone | 2b10554 | 2011-06-22 10:58:09 -0700 | [diff] [blame] | 14 | #include "shill/refptr_types.h" |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 15 | #include "shill/service.h" |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 16 | |
| 17 | namespace shill { |
| 18 | |
Chris Masone | 6791a43 | 2011-07-12 13:23:19 -0700 | [diff] [blame] | 19 | class ControlInterface; |
| 20 | class EventDispatcher; |
mukesh agrawal | 1a05626 | 2011-10-05 14:36:54 -0700 | [diff] [blame] | 21 | class Error; |
Chris Masone | 6791a43 | 2011-07-12 13:23:19 -0700 | [diff] [blame] | 22 | class Manager; |
Thieu Le | 3426c8f | 2012-01-11 17:35:11 -0800 | [diff] [blame] | 23 | class Metrics; |
Chris Masone | 6791a43 | 2011-07-12 13:23:19 -0700 | [diff] [blame] | 24 | |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 25 | class WiFiService : public Service { |
| 26 | public: |
Paul Stewart | 0756db9 | 2012-01-27 08:34:47 -0800 | [diff] [blame] | 27 | // TODO(pstew): Storage constants shouldn't need to be public |
| 28 | // crosbug.com/25813 |
| 29 | static const char kStorageHiddenSSID[]; |
| 30 | static const char kStorageMode[]; |
| 31 | static const char kStoragePassphrase[]; |
| 32 | static const char kStorageSecurity[]; |
| 33 | static const char kStorageSSID[]; |
| 34 | |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 35 | WiFiService(ControlInterface *control_interface, |
| 36 | EventDispatcher *dispatcher, |
Thieu Le | 3426c8f | 2012-01-11 17:35:11 -0800 | [diff] [blame] | 37 | Metrics *metrics, |
Chris Masone | 6791a43 | 2011-07-12 13:23:19 -0700 | [diff] [blame] | 38 | Manager *manager, |
Chris Masone | 2b10554 | 2011-06-22 10:58:09 -0700 | [diff] [blame] | 39 | const WiFiRefPtr &device, |
mukesh agrawal | 7ec7131 | 2011-11-10 02:08:26 +0000 | [diff] [blame] | 40 | const std::vector<uint8_t> &ssid, |
Chris Masone | 092df3e | 2011-08-22 09:41:39 -0700 | [diff] [blame] | 41 | const std::string &mode, |
Paul Stewart | ced6a0b | 2011-11-08 15:32:04 -0800 | [diff] [blame] | 42 | const std::string &security, |
| 43 | bool hidden_ssid); |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 44 | ~WiFiService(); |
Darin Petkov | 4d6d941 | 2011-08-24 13:19:54 -0700 | [diff] [blame] | 45 | |
| 46 | // Inherited from Service. |
mukesh agrawal | 8a3188d | 2011-12-01 20:56:44 +0000 | [diff] [blame] | 47 | virtual void AutoConnect(); |
Darin Petkov | 4d6d941 | 2011-08-24 13:19:54 -0700 | [diff] [blame] | 48 | virtual void Connect(Error *error); |
mukesh agrawal | 0ed0f2e | 2011-12-05 20:36:17 +0000 | [diff] [blame] | 49 | virtual void Disconnect(Error *error); |
Chris Masone | 34af218 | 2011-08-22 11:59:36 -0700 | [diff] [blame] | 50 | |
Paul Stewart | 22aa71b | 2011-09-16 12:15:11 -0700 | [diff] [blame] | 51 | virtual bool TechnologyIs(const Technology::Identifier type) const; |
mukesh agrawal | 8a3188d | 2011-12-01 20:56:44 +0000 | [diff] [blame] | 52 | virtual bool IsConnecting() const; |
Paul Stewart | 22aa71b | 2011-09-16 12:15:11 -0700 | [diff] [blame] | 53 | |
mukesh agrawal | e1d90e9 | 2012-02-15 17:36:08 -0800 | [diff] [blame] | 54 | virtual void AddEndpoint(const WiFiEndpointConstRefPtr endpoint); |
| 55 | virtual void RemoveEndpoint(const WiFiEndpointConstRefPtr endpoint); |
mukesh agrawal | 4eb4d78 | 2011-12-05 17:34:37 +0000 | [diff] [blame] | 56 | bool NumEndpoints() const { return endpoints_.size(); } |
mukesh agrawal | e1d90e9 | 2012-02-15 17:36:08 -0800 | [diff] [blame] | 57 | |
mukesh agrawal | b20776f | 2012-02-10 16:00:36 -0800 | [diff] [blame] | 58 | // Called to update the identity of the currently connected endpoint. |
mukesh agrawal | e1d90e9 | 2012-02-15 17:36:08 -0800 | [diff] [blame] | 59 | // To indicate that there is no currently connect endpoint, call with |
| 60 | // |endpoint| set to NULL. |
| 61 | void NotifyCurrentEndpoint(const WiFiEndpoint *endpoint); |
mukesh agrawal | b20776f | 2012-02-10 16:00:36 -0800 | [diff] [blame] | 62 | // Called to inform of changes in the properties of an endpoint. |
| 63 | // (Not necessarily the currently connected endpoint.) |
| 64 | void NotifyEndpointUpdated(const WiFiEndpoint &endpoint); |
mukesh agrawal | 261daca | 2011-12-02 18:56:56 +0000 | [diff] [blame] | 65 | |
Chris Masone | 34af218 | 2011-08-22 11:59:36 -0700 | [diff] [blame] | 66 | // wifi_<MAC>_<BSSID>_<mode_string>_<security_string> |
Chris Masone | 6515aab | 2011-10-12 16:19:09 -0700 | [diff] [blame] | 67 | std::string GetStorageIdentifier() const; |
Paul Stewart | a41e38d | 2011-11-11 07:47:29 -0800 | [diff] [blame] | 68 | static bool ParseStorageIdentifier(const std::string &storage_name, |
| 69 | std::string *address, |
| 70 | std::string *mode, |
| 71 | std::string *security); |
Chris Masone | 34af218 | 2011-08-22 11:59:36 -0700 | [diff] [blame] | 72 | |
Thieu Le | 48e6d6d | 2011-12-06 00:40:27 +0000 | [diff] [blame] | 73 | const std::string &mode() const { return mode_; } |
| 74 | const std::string &key_management() const { return GetEAPKeyManagement(); } |
| 75 | const std::vector<uint8_t> &ssid() const { return ssid_; } |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 76 | |
mukesh agrawal | 1a05626 | 2011-10-05 14:36:54 -0700 | [diff] [blame] | 77 | void SetPassphrase(const std::string &passphrase, Error *error); |
| 78 | |
Paul Stewart | d08f443 | 2011-11-04 07:48:20 -0700 | [diff] [blame] | 79 | // Overrride Load and Save from parent Service class. We will call |
| 80 | // the parent method. |
| 81 | virtual bool IsLoadableFrom(StoreInterface *storage) const; |
| 82 | virtual bool Load(StoreInterface *storage); |
| 83 | virtual bool Save(StoreInterface *storage); |
Paul Stewart | 65512e1 | 2012-03-26 18:01:08 -0700 | [diff] [blame] | 84 | virtual bool Unload(); |
Paul Stewart | d08f443 | 2011-11-04 07:48:20 -0700 | [diff] [blame] | 85 | |
mukesh agrawal | 8a3188d | 2011-12-01 20:56:44 +0000 | [diff] [blame] | 86 | virtual bool HasEndpoints() const { return !endpoints_.empty(); } |
Paul Stewart | a41e38d | 2011-11-11 07:47:29 -0800 | [diff] [blame] | 87 | virtual bool IsVisible() const; |
Paul Stewart | 6ab23a9 | 2011-11-09 17:17:47 -0800 | [diff] [blame] | 88 | bool IsSecurityMatch(const std::string &security) const; |
Paul Stewart | ced6a0b | 2011-11-08 15:32:04 -0800 | [diff] [blame] | 89 | bool hidden_ssid() const { return hidden_ssid_; } |
| 90 | |
Thieu Le | 48e6d6d | 2011-12-06 00:40:27 +0000 | [diff] [blame] | 91 | virtual void InitializeCustomMetrics() const; |
Thieu Le | b84ba34 | 2012-03-02 15:15:19 -0800 | [diff] [blame] | 92 | virtual void SendPostReadyStateMetrics( |
| 93 | int64 time_resume_to_ready_milliseconds) const; |
Thieu Le | 48e6d6d | 2011-12-06 00:40:27 +0000 | [diff] [blame] | 94 | |
Gaurav Shah | 10109f2 | 2011-11-11 20:16:22 -0800 | [diff] [blame] | 95 | // Override from parent Service class to correctly update connectability |
| 96 | // when the EAP credentials change for 802.1x networks. |
| 97 | void set_eap(const EapCredentials& eap); |
| 98 | |
mukesh agrawal | 8a3188d | 2011-12-01 20:56:44 +0000 | [diff] [blame] | 99 | protected: |
mukesh agrawal | bf14e94 | 2012-03-02 14:36:34 -0800 | [diff] [blame] | 100 | virtual bool IsAutoConnectable(const char **reason) const; |
mukesh agrawal | 8a3188d | 2011-12-01 20:56:44 +0000 | [diff] [blame] | 101 | |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 102 | private: |
Paul Stewart | d08f443 | 2011-11-04 07:48:20 -0700 | [diff] [blame] | 103 | friend class WiFiServiceSecurityTest; |
mukesh agrawal | e1d90e9 | 2012-02-15 17:36:08 -0800 | [diff] [blame] | 104 | friend class WiFiServiceUpdateFromEndpointsTest; // SignalToStrength |
Thieu Le | ad1ec2c | 2012-01-05 23:39:48 +0000 | [diff] [blame] | 105 | FRIEND_TEST(MetricsTest, WiFiServicePostReady); |
Thieu Le | e41a72d | 2012-02-06 20:46:51 +0000 | [diff] [blame] | 106 | FRIEND_TEST(WiFiMainTest, CurrentBSSChangedUpdateServiceEndpoint); |
mukesh agrawal | 8a3188d | 2011-12-01 20:56:44 +0000 | [diff] [blame] | 107 | FRIEND_TEST(WiFiServiceTest, AutoConnect); |
mukesh agrawal | 8abd2f6 | 2012-01-30 14:56:14 -0800 | [diff] [blame] | 108 | FRIEND_TEST(WiFiServiceTest, ClearWriteOnlyDerivedProperty); // passphrase_ |
Gaurav Shah | 10109f2 | 2011-11-11 20:16:22 -0800 | [diff] [blame] | 109 | FRIEND_TEST(WiFiServiceTest, ConnectTask8021x); |
Gaurav Shah | 29d6888 | 2012-01-30 19:06:42 -0800 | [diff] [blame] | 110 | FRIEND_TEST(WiFiServiceTest, ConnectTaskDynamicWEP); |
Gaurav Shah | f8721ee | 2011-11-07 09:12:46 -0800 | [diff] [blame] | 111 | FRIEND_TEST(WiFiServiceTest, ConnectTaskPSK); |
Gaurav Shah | 29d6888 | 2012-01-30 19:06:42 -0800 | [diff] [blame] | 112 | FRIEND_TEST(WiFiServiceTest, ConnectTaskRSN); |
Thieu Le | f4cbda9 | 2011-11-10 23:41:24 +0000 | [diff] [blame] | 113 | FRIEND_TEST(WiFiServiceTest, ConnectTaskWEP); |
Gaurav Shah | 29d6888 | 2012-01-30 19:06:42 -0800 | [diff] [blame] | 114 | FRIEND_TEST(WiFiServiceTest, ConnectTaskWPA); |
mukesh agrawal | 8a3188d | 2011-12-01 20:56:44 +0000 | [diff] [blame] | 115 | FRIEND_TEST(WiFiServiceTest, IsAutoConnectable); |
Paul Stewart | d08f443 | 2011-11-04 07:48:20 -0700 | [diff] [blame] | 116 | FRIEND_TEST(WiFiServiceTest, LoadHidden); |
Paul Stewart | d8ad3c4 | 2012-01-09 12:39:38 -0800 | [diff] [blame] | 117 | FRIEND_TEST(WiFiServiceTest, LoadAndUnloadPassphrase); |
Gaurav Shah | 10109f2 | 2011-11-11 20:16:22 -0800 | [diff] [blame] | 118 | FRIEND_TEST(WiFiServiceTest, Populate8021x); |
mukesh agrawal | e1d90e9 | 2012-02-15 17:36:08 -0800 | [diff] [blame] | 119 | FRIEND_TEST(WiFiServiceTest, SignalToStrength); // SignalToStrength |
Paul Stewart | d08f443 | 2011-11-04 07:48:20 -0700 | [diff] [blame] | 120 | |
mukesh agrawal | bf14e94 | 2012-03-02 14:36:34 -0800 | [diff] [blame] | 121 | static const char kAutoConnBusy[]; |
| 122 | static const char kAutoConnNoEndpoint[]; |
| 123 | |
mukesh agrawal | 292dc0f | 2012-01-26 18:02:46 -0800 | [diff] [blame] | 124 | // Override the base clase implementation, because we need to allow |
| 125 | // arguments that aren't base class methods. |
| 126 | void HelpRegisterWriteOnlyDerivedString( |
Thieu Le | f770945 | 2011-11-15 01:13:19 +0000 | [diff] [blame] | 127 | const std::string &name, |
mukesh agrawal | 292dc0f | 2012-01-26 18:02:46 -0800 | [diff] [blame] | 128 | void(WiFiService::*set)(const std::string &value, Error *error), |
| 129 | void(WiFiService::*clear)(Error *error), |
| 130 | const std::string *default_value); |
Thieu Le | f770945 | 2011-11-15 01:13:19 +0000 | [diff] [blame] | 131 | |
Gaurav Shah | 1b7a616 | 2011-11-09 11:41:01 -0800 | [diff] [blame] | 132 | std::string GetDeviceRpcId(Error *error); |
mukesh agrawal | 292dc0f | 2012-01-26 18:02:46 -0800 | [diff] [blame] | 133 | void ClearPassphrase(Error *error); |
mukesh agrawal | 29c13a1 | 2011-11-24 00:09:19 +0000 | [diff] [blame] | 134 | void UpdateConnectable(); |
mukesh agrawal | e1d90e9 | 2012-02-15 17:36:08 -0800 | [diff] [blame] | 135 | void UpdateFromEndpoints(); |
Chris Masone | 95207da | 2011-06-29 16:50:49 -0700 | [diff] [blame] | 136 | |
Thieu Le | f4cbda9 | 2011-11-10 23:41:24 +0000 | [diff] [blame] | 137 | static void ValidateWEPPassphrase(const std::string &passphrase, |
| 138 | Error *error); |
| 139 | static void ValidateWPAPassphrase(const std::string &passphrase, |
| 140 | Error *error); |
| 141 | static void ParseWEPPassphrase(const std::string &passphrase, |
| 142 | int *key_index, |
| 143 | std::vector<uint8> *password_bytes, |
| 144 | Error *error); |
mukesh agrawal | 1a05626 | 2011-10-05 14:36:54 -0700 | [diff] [blame] | 145 | static bool CheckWEPIsHex(const std::string &passphrase, Error *error); |
| 146 | static bool CheckWEPKeyIndex(const std::string &passphrase, Error *error); |
| 147 | static bool CheckWEPPrefix(const std::string &passphrase, Error *error); |
| 148 | |
mukesh agrawal | 8f3f775 | 2012-02-17 19:42:09 -0800 | [diff] [blame] | 149 | // Maps a signal value, in dBm, to a "strength" value, from |
| 150 | // |Service::kStrengthMin| to |Service:kStrengthMax|. |
mukesh agrawal | e1d90e9 | 2012-02-15 17:36:08 -0800 | [diff] [blame] | 151 | static uint8 SignalToStrength(int16 signal_dbm); |
| 152 | |
Paul Stewart | 6ab23a9 | 2011-11-09 17:17:47 -0800 | [diff] [blame] | 153 | // "wpa", "rsn" and "psk" are equivalent from a configuration perspective. |
| 154 | // This function maps them all into "psk". |
| 155 | static std::string GetSecurityClass(const std::string &security); |
| 156 | |
Paul Stewart | d08f443 | 2011-11-04 07:48:20 -0700 | [diff] [blame] | 157 | // Profile data for a WPA/RSN service can be stored under a number of |
| 158 | // different names. These functions create different storage identifiers |
| 159 | // based on whether they are referred to by their generic "psk" name or |
| 160 | // if they use the (legacy) specific "wpa" or "rsn" names. |
| 161 | std::string GetGenericStorageIdentifier() const; |
| 162 | std::string GetSpecificStorageIdentifier() const; |
| 163 | std::string GetStorageIdentifierForSecurity( |
| 164 | const std::string &security) const; |
| 165 | |
Gaurav Shah | 29d6888 | 2012-01-30 19:06:42 -0800 | [diff] [blame] | 166 | // Returns true if the wireless service uses 802.1x for key management. |
| 167 | bool Is8021x() const; |
| 168 | |
Gaurav Shah | 10109f2 | 2011-11-11 20:16:22 -0800 | [diff] [blame] | 169 | // Populate the |params| map with available 802.1x EAP properties. |
| 170 | void Populate8021xProperties(std::map<std::string, DBus::Variant> *params); |
| 171 | |
Chris Masone | 3bd3c8c | 2011-06-13 08:20:26 -0700 | [diff] [blame] | 172 | // Properties |
| 173 | std::string passphrase_; |
| 174 | bool need_passphrase_; |
| 175 | std::string security_; |
Chris Masone | 3bd3c8c | 2011-06-13 08:20:26 -0700 | [diff] [blame] | 176 | // TODO(cmasone): see if the below can be pulled from the endpoint associated |
| 177 | // with this service instead. |
Chris Masone | 092df3e | 2011-08-22 09:41:39 -0700 | [diff] [blame] | 178 | const std::string mode_; |
Chris Masone | 3bd3c8c | 2011-06-13 08:20:26 -0700 | [diff] [blame] | 179 | std::string auth_mode_; |
| 180 | bool hidden_ssid_; |
| 181 | uint16 frequency_; |
Paul Stewart | 20088d8 | 2012-02-16 06:58:55 -0800 | [diff] [blame] | 182 | // TODO(quiche): I noticed this is not hooked up to anything. In fact, it |
| 183 | // was undefined until now. crosbug.com/26490 |
Chris Masone | 3bd3c8c | 2011-06-13 08:20:26 -0700 | [diff] [blame] | 184 | uint16 physical_mode_; |
mukesh agrawal | 3239932 | 2011-09-01 10:53:43 -0700 | [diff] [blame] | 185 | std::string hex_ssid_; |
Paul Stewart | d08f443 | 2011-11-04 07:48:20 -0700 | [diff] [blame] | 186 | std::string storage_identifier_; |
Chris Masone | 3bd3c8c | 2011-06-13 08:20:26 -0700 | [diff] [blame] | 187 | |
mukesh agrawal | e1d90e9 | 2012-02-15 17:36:08 -0800 | [diff] [blame] | 188 | // Track whether or not we've warned about large signal values. |
| 189 | // Used to avoid spamming the log. |
| 190 | static bool logged_signal_warning; |
Chris Masone | 2b10554 | 2011-06-22 10:58:09 -0700 | [diff] [blame] | 191 | WiFiRefPtr wifi_; |
mukesh agrawal | 261daca | 2011-12-02 18:56:56 +0000 | [diff] [blame] | 192 | std::set<WiFiEndpointConstRefPtr> endpoints_; |
mukesh agrawal | e1d90e9 | 2012-02-15 17:36:08 -0800 | [diff] [blame] | 193 | WiFiEndpointConstRefPtr current_endpoint_; |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 194 | const std::vector<uint8_t> ssid_; |
mukesh agrawal | b54601c | 2011-06-07 17:39:22 -0700 | [diff] [blame] | 195 | DISALLOW_COPY_AND_ASSIGN(WiFiService); |
| 196 | }; |
| 197 | |
| 198 | } // namespace shill |
| 199 | |
| 200 | #endif // SHILL_WIFI_SERVICE_ |