blob: 6b4d55a972130d6f0f5eba926a543883b7dd8e41 [file] [log] [blame]
// Copyright (c) 2012 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.
#include <stdint.h>
#include <memory>
#include <string>
#include <vector>
#include "base/gtest_prod_util.h"
#include "base/macros.h"
#include "base/values.h"
#include "chromeos/network/managed_state.h"
#include "chromeos/services/network_config/public/mojom/cros_network_config.mojom-forward.h"
#include "components/onc/onc_constants.h"
#include "url/gurl.h"
namespace base {
class Value;
namespace chromeos {
// Simple class to provide network state information about a network service.
// This class should always be passed as a const* and should never be held
// on to. Store network_state->path() (defined in ManagedState) instead and
// call NetworkStateHandler::GetNetworkState(path) to retrieve the state for
// the network.
// Note: NetworkStateHandler will store an entry for each member of
// Manager.ServiceCompleteList. The visible() method indicates whether the
// network is visible, and the IsInProfile() method indicates whether the
// network is saved in a profile.
class COMPONENT_EXPORT(CHROMEOS_NETWORK) NetworkState : public ManagedState {
explicit NetworkState(const std::string& path);
~NetworkState() override;
struct CaptivePortalProviderInfo {
// The id used by chrome to identify the provider (i.e. an extension id).
std::string id;
// The display name for the captive portal provider (i.e. extension name).
std::string name;
struct VpnProviderInfo {
// The id used by chrome to identify the provider (i.e. an extension id).
std::string id;
// The VPN type, provided by the VPN provider/extension.
std::string type;
// ManagedState overrides
// If you change this method, update GetProperties too.
bool PropertyChanged(const std::string& key,
const base::Value& value) override;
bool InitialPropertiesReceived(const base::Value& properties) override;
void GetStateProperties(base::Value* dictionary) const override;
// Called when the IPConfig properties may have changed. |properties| is
// expected to be of type DICTIONARY.
void IPConfigPropertiesChanged(const base::Value& properties);
// Returns true if the network requires a service activation.
bool RequiresActivation() const;
// Returns true if the network security type requires a passphrase only.
bool SecurityRequiresPassphraseOnly() const;
// Accessors
bool visible() const { return visible_; }
void set_visible(bool visible) { visible_ = visible; }
const std::string& security_class() const { return security_class_; }
const std::string& device_path() const { return device_path_; }
const std::string& guid() const { return guid_; }
const std::string& profile_path() const { return profile_path_; }
const GURL& probe_url() const { return probe_url_; }
::onc::ONCSource onc_source() const { return onc_source_; }
// Provides the error for the last attempt to connect/configure the network
// (an empty string signifies no error at all). Note that this value can be
// cleared - see ClearError() below.
const std::string& GetError() const;
// Clears the error associated with this network. Should be called whenever
// a connection to this network is initiated or the associated configuration
// is updated/removed.
void ClearError();
// Returns |connection_state_| if visible, kStateIdle otherwise.
std::string connection_state() const;
// Updates the connection state and saves the previous connection state.
void SetConnectionState(const std::string& connection_state);
int priority() const { return priority_; }
const base::Value* proxy_config() const { return proxy_config_.get(); }
const base::Value* ipv4_config() const { return ipv4_config_.get(); }
std::string GetIpAddress() const;
std::string GetGateway() const;
GURL GetWebProxyAutoDiscoveryUrl() const;
// Wireless property accessors
bool connectable() const { return connectable_; }
void set_connectable(bool connectable) { connectable_ = connectable; }
bool is_captive_portal() const { return is_captive_portal_; }
const CaptivePortalProviderInfo* captive_portal_provider() const {
return captive_portal_provider_.get();
void SetCaptivePortalProvider(const std::string& id, const std::string& name);
int signal_strength() const { return signal_strength_; }
void set_signal_strength(int signal_strength) {
signal_strength_ = signal_strength;
const std::string& bssid() const { return bssid_; }
int frequency() const { return frequency_; }
bool blocked_by_policy() const { return blocked_by_policy_; }
void set_blocked_by_policy(bool blocked_by_policy) {
blocked_by_policy_ = blocked_by_policy;
// Wifi property accessors
const std::string& eap_method() const { return eap_method_; }
const std::vector<uint8_t>& raw_ssid() const { return raw_ssid_; }
// Cellular property accessors
const std::string& network_technology() const { return network_technology_; }
const std::string& activation_type() const { return activation_type_; }
const std::string& activation_state() const { return activation_state_; }
const std::string& payment_url() const { return payment_url_; }
const std::string& payment_post_data() const { return payment_post_data_; }
bool cellular_out_of_credits() const { return cellular_out_of_credits_; }
const std::string& tethering_state() const { return tethering_state_; }
// VPN property accessors
const VpnProviderInfo* vpn_provider() const { return vpn_provider_.get(); }
std::string GetVpnProviderType() const;
// Tether accessors and setters.
int battery_percentage() const { return battery_percentage_; }
void set_battery_percentage(int battery_percentage) {
battery_percentage_ = battery_percentage;
const std::string& tether_carrier() const { return tether_carrier_; }
void set_tether_carrier(const std::string& tether_carrier) {
tether_carrier_ = tether_carrier;
bool tether_has_connected_to_host() const {
return tether_has_connected_to_host_;
void set_tether_has_connected_to_host(bool tether_has_connected_to_host) {
tether_has_connected_to_host_ = tether_has_connected_to_host;
const std::string& tether_guid() const { return tether_guid_; }
void set_tether_guid(const std::string& guid) { tether_guid_ = guid; }
bool connect_requested() const { return connect_requested_; }
// Returns true if the network is managed by policy (determined by
// |onc_source_|).
bool IsManagedByPolicy() const;
// Returns true if the network is romaing and the provider does not require
// roaming.
bool IndicateRoaming() const;
// Returns true if the current connection is using mobile data.
bool IsUsingMobileData() const;
// Returns true if the network securty is WEP_8021x (Dynamic WEP)
bool IsDynamicWep() const;
// Returns true if |connection_state_| is a connected/connecting state.
bool IsConnectedState() const;
bool IsConnectingState() const;
bool IsConnectingOrConnected() const;
// Similar to IsConnectingOrConnected but also checks activation state.
bool IsActive() const;
// Returns true if |connection_state_| is online.
bool IsOnline() const;
// Returns true if this is a network stored in a profile.
bool IsInProfile() const;
// Returns true if the network is never stored in a profile (e.g. Tether and
// default Cellular).
bool IsNonProfileType() const;
// Returns true if the network properties are stored in a user profile.
bool IsPrivate() const;
// Returns true if the network is a default Cellular network (see
// NetworkStateHandler::EnsureCellularNetwork()).
bool IsDefaultCellular() const;
// Returns true if Shill or Chrome have detected a captive portal state.
// The Chrome network portal detection is different from Shill's so the
// results may differ; this method tests both and should be preferred in UI.
// (NetworkState is already conservative in interpreting Shill's captive
// portal state, see IsCaptivePortalState in the .cc file).
bool IsCaptivePortal() const;
// Returns the |raw_ssid| as a hex-encoded string
std::string GetHexSsid() const;
// Returns a comma separated string of name servers.
std::string GetDnsServersAsString() const;
// Converts the prefix length to a netmask string.
std::string GetNetmask() const;
// Returns a specifier for identifying this network in the absence of a GUID.
// This should only be used by NetworkStateHandler for keeping track of
// GUIDs assigned to unsaved networks.
std::string GetSpecifier() const;
// Set the GUID. Called exclusively by NetworkStateHandler.
void SetGuid(const std::string& guid);
// Helpers for returning mojo types.
network_config::mojom::ActivationStateType GetMojoActivationState() const;
network_config::mojom::SecurityType GetMojoSecurity() const;
// Setters for testing.
void set_connection_state_for_testing(const std::string& connection_state) {
connection_state_ = connection_state;
void set_connect_requested_for_testing(bool connect_requested) {
connect_requested_ = connect_requested;
void set_network_technology_for_testing(const std::string& technology) {
network_technology_ = technology;
// Helpers (used e.g. when a state, error, or shill dictionary is cached)
static bool StateIsConnected(const std::string& connection_state);
static bool StateIsConnecting(const std::string& connection_state);
static bool StateIsPortalled(const std::string& connection_state);
static bool NetworkStateIsCaptivePortal(const base::Value& shill_properties);
static bool ErrorIsValid(const std::string& error);
static std::unique_ptr<NetworkState> CreateDefaultCellular(
const std::string& device_path);
friend class MobileActivatorTest;
friend class NetworkStateHandler;
// Updates |name_| from the 'WiFi.HexSSID' entry in |properties|, which must
// be of type DICTIONARY, if the key exists, and validates |name_|. Returns
// true if |name_| changes.
bool UpdateName(const base::Value& properties);
void SetVpnProvider(const std::string& id, const std::string& type);
// Set to true if the network is a member of Manager.Services.
bool visible_ = false;
// Network Service properties. Avoid adding any additional properties here.
// Instead use NetworkConfigurationHandler::GetProperties() to asynchronously
// request properties from Shill.
std::string security_class_;
std::string eap_method_; // Needed for WiFi EAP networks
std::string eap_key_mgmt_; // Needed for identifying Dynamic WEP networks
std::string device_path_;
std::string guid_;
std::string tether_guid_; // Used to double link a Tether and Wi-Fi network.
std::string connection_state_;
std::string last_connection_state_;
std::string profile_path_;
GURL probe_url_;
std::vector<uint8_t> raw_ssid_; // Unknown encoding. Not necessarily UTF-8.
int priority_ = 0; // kPriority, used for organizing known networks.
::onc::ONCSource onc_source_ = ::onc::ONC_SOURCE_UNKNOWN;
// Last non empty Service.Error property. Expected to be cleared via
// ClearError() when a connection attempt is initiated and when an associated
// configuration is updated/removed.
std::string last_error_;
// Cached copy of the Shill Service IPConfig object. For ipv6 properties use
// the ip_configs_ property in the corresponding DeviceState.
std::unique_ptr<base::Value> ipv4_config_;
// Wireless properties, used for icons and Connect logic.
bool connectable_ = false;
bool is_captive_portal_ = false;
std::unique_ptr<CaptivePortalProviderInfo> captive_portal_provider_;
int signal_strength_ = 0;
std::string bssid_;
int frequency_ = 0;
bool blocked_by_policy_ = false;
// Cellular properties, used for icons, Connect, and Activation.
std::string network_technology_;
std::string activation_type_;
std::string activation_state_;
std::string roaming_;
bool provider_requires_roaming_ = false;
std::string payment_url_;
std::string payment_post_data_;
bool cellular_out_of_credits_ = false;
std::string tethering_state_;
// VPN properties, used to construct the display name and to show the correct
// configuration dialog. The id is the Extension ID or Arc package name for
// extension or Arc provider VPNs.
std::unique_ptr<VpnProviderInfo> vpn_provider_;
// Tether properties.
std::string tether_carrier_;
int battery_percentage_ = 0;
// Whether the current device has already connected to the tether host device
// providing the hotspot corresponding to this NetworkState.
// Note: this means that the current device has already connected to the
// tether host, but it does not necessarily mean that the current device has
// connected to the Tether network corresponding to this NetworkState.
bool tether_has_connected_to_host_ = false;
// TODO(pneubeck): Remove this once (Managed)NetworkConfigurationHandler
// provides proxy configuration.
std::unique_ptr<base::Value> proxy_config_;
// Set while a network connect request is queued. Cleared on connect or
// if the request is aborted.
bool connect_requested_ = false;
// Set by NetworkStateHandler if Chrome detects a captive portal state.
// See IsCaptivePortal() for details.
bool is_chrome_captive_portal_ = false;
} // namespace chromeos