chrome/browser/enterprise/signals/device_info_fetcher.h

// 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_ENTERPRISE_SIGNALS_DEVICE_INFO_FETCHER_H_
#define CHROME_BROWSER_ENTERPRISE_SIGNALS_DEVICE_INFO_FETCHER_H_

#include <memory>
#include <optional>
#include <string>
#include <vector>

#include "components/device_signals/core/common/common_types.h"

namespace enterprise_signals {

struct DeviceInfo {
  DeviceInfo();
  ~DeviceInfo();
  DeviceInfo(const DeviceInfo&);
  DeviceInfo(DeviceInfo&&);

  std::string os_name;
  std::string os_version;
  std::string security_patch_level;
  std::string device_host_name;
  std::string device_model;
  std::string serial_number;
  device_signals::SettingValue screen_lock_secured;
  device_signals::SettingValue disk_encrypted;

  std::vector<std::string> mac_addresses;
  std::optional<std::string> windows_machine_domain;
  std::optional<std::string> windows_user_domain;
  std::optional<device_signals::SettingValue> secure_boot_enabled;
};

// Interface used by the chrome.enterprise.reportingPrivate.getDeviceInfo()
// function that fetches info of the device. Each supported platform has its own
// subclass implementation.
class DeviceInfoFetcher {
 public:
  DeviceInfoFetcher();
  virtual ~DeviceInfoFetcher();

  DeviceInfoFetcher(const DeviceInfoFetcher&) = delete;
  DeviceInfoFetcher& operator=(const DeviceInfoFetcher&) = delete;

  // Returns a platform specific instance of DeviceInfoFetcher.
  static std::unique_ptr<DeviceInfoFetcher> CreateInstance();

  // Returns a stub instance so tests can validate attributes independently of
  // the platform.
  static std::unique_ptr<DeviceInfoFetcher> CreateStubInstanceForTesting();

  // Sets a value controlling whether DeviceInfoFetcher::CreateInstance should
  // return a stubbed instance. Used for testing.
  static void SetForceStubForTesting(bool should_force);

  // Sets a value controlling whether DeviceInfoFetcher returns duplicate mac
  // addresses. Used for testing.
  static void SetForceDuplicateMacAddressesForTesting(bool should_force);

  // Fetches the device information for the current platform.
  virtual DeviceInfo Fetch() = 0;

 protected:
  // Implements a platform specific instance of DeviceInfoFetcher.
  static std::unique_ptr<DeviceInfoFetcher> CreateInstanceInternal();
};

}  // namespace enterprise_signals

#endif  // CHROME_BROWSER_ENTERPRISE_SIGNALS_DEVICE_INFO_FETCHER_H_