Fix a race condition in preference metric reporting.

chrome/browser/prefs/pref_metrics_service.cc

Index: chrome/browser/prefs/pref_metrics_service.cc
diff --git a/chrome/browser/prefs/pref_metrics_service.cc b/chrome/browser/prefs/pref_metrics_service.cc
index a4a4f33294c741b278a76ac116e2e02da40d3f0f..c2e5452fc9519519ade083a557c5a35aadcff1bf 100644
--- a/chrome/browser/prefs/pref_metrics_service.cc
+++ b/chrome/browser/prefs/pref_metrics_service.cc
@@ -6,18 +6,12 @@
 
 #include "base/bind.h"
 #include "base/command_line.h"
-#include "base/json/json_string_value_serializer.h"
 #include "base/metrics/histogram.h"
 #include "base/prefs/pref_registry_simple.h"
 #include "base/prefs/pref_service.h"
-#include "base/prefs/scoped_user_pref_update.h"
 #include "base/strings/string_number_conversions.h"
 #include "chrome/browser/browser_process.h"
 #include "chrome/browser/browser_shutdown.h"
-// Accessing the Device ID API here is a layering violation.
-// TODO(bbudge) Move the API so it's usable here.
-// http://crbug.com/276485

[gab, 2013/12/06 17:23:38]

Perhaps include this bug in this CL's description for context for anyone looking
at this later?

[erikwright (departed), 2013/12/09 17:59:40]

I migrated the bug link into profile_impl.cc (where we now load the device ID).

-#include "chrome/browser/extensions/api/music_manager_private/device_id.h"
 #include "chrome/browser/prefs/pref_service_syncable.h"
 #include "chrome/browser/prefs/session_startup_pref.h"
 #include "chrome/browser/prefs/synced_pref_change_registrar.h"
@@ -29,9 +23,7 @@
 #include "chrome/common/pref_names.h"
 #include "components/browser_context_keyed_service/browser_context_dependency_manager.h"
 #include "crypto/hmac.h"
-#include "grit/browser_resources.h"
 #include "net/base/registry_controlled_domains/registry_controlled_domain.h"
-#include "ui/base/resource/resource_bundle.h"
 
 namespace {
 
@@ -46,81 +38,28 @@ const int kSessionStartupPrefValueMax = SessionStartupPref::kPrefValueMax;
 const char kUnregisteredPreference[] = "_";
 #endif
 
-// These preferences must be kept in sync with the TrackedPreference enum in
-// tools/metrics/histograms/histograms.xml. To add a new preference, append it
-// to the array and add a corresponding value to the histogram enum.
-const char* kTrackedPrefs[] = {
-  prefs::kShowHomeButton,
-  prefs::kHomePageIsNewTabPage,
-  prefs::kHomePage,
-  prefs::kRestoreOnStartup,
-  prefs::kURLsToRestoreOnStartup,
-  prefs::kExtensionsPref,
-  prefs::kGoogleServicesLastUsername,
-  prefs::kSearchProviderOverrides,
-  prefs::kDefaultSearchProviderSearchURL,
-  prefs::kDefaultSearchProviderKeyword,
-  prefs::kDefaultSearchProviderName,
-#if !defined(OS_ANDROID)
-  prefs::kPinnedTabs,
-#else
-  kUnregisteredPreference,
-#endif
-  prefs::kExtensionKnownDisabled,
-};
-
-const size_t kSHA256DigestSize = 32;
-
 }  // namespace
 
 PrefMetricsService::PrefMetricsService(Profile* profile)
     : profile_(profile),
       prefs_(profile_->GetPrefs()),
       local_state_(g_browser_process->local_state()),
-      profile_name_(profile_->GetPath().AsUTF8Unsafe()),
-      tracked_pref_paths_(kTrackedPrefs),
-      tracked_pref_path_count_(arraysize(kTrackedPrefs)),
-      checked_tracked_prefs_(false),
       weak_factory_(this) {
-  pref_hash_seed_ = ResourceBundle::GetSharedInstance().GetRawDataResource(
-      IDR_PREF_HASH_SEED_BIN).as_string();
-
   RecordLaunchPrefs();
 
   PrefServiceSyncable* prefs = PrefServiceSyncable::FromProfile(profile_);
   synced_pref_change_registrar_.reset(new SyncedPrefChangeRegistrar(prefs));
 
   RegisterSyncedPrefObservers();
-
-  // The following code might cause callbacks into this instance before we exit
-  // the constructor. This instance should be initialized at this point.
-#if defined(OS_WIN) || defined(OS_MACOSX)
-  // We need the machine id to compute pref value hashes. Fetch that, and then
-  // call CheckTrackedPreferences in the callback.
-  extensions::api::DeviceId::GetDeviceId(
-      "PrefMetricsService",  // non-empty string to obfuscate the device id.
-      Bind(&PrefMetricsService::GetDeviceIdCallback,
-           weak_factory_.GetWeakPtr()));
-#endif  // defined(OS_WIN) || defined(OS_MACOSX)
 }
 
 // For unit testing only.
 PrefMetricsService::PrefMetricsService(Profile* profile,
-                                       PrefService* local_state,
-                                       const std::string& device_id,
-                                       const char** tracked_pref_paths,
-                                       int tracked_pref_path_count)
+                                       PrefService* local_state)
     : profile_(profile),
       prefs_(profile->GetPrefs()),
       local_state_(local_state),
-      profile_name_(profile_->GetPath().AsUTF8Unsafe()),
-      pref_hash_seed_(kSHA256DigestSize, 0),
-      device_id_(device_id),
-      tracked_pref_paths_(tracked_pref_paths),
-      tracked_pref_path_count_(tracked_pref_path_count),
-      checked_tracked_prefs_(false),
       weak_factory_(this) {
-  CheckTrackedPreferences();
 }
 
 PrefMetricsService::~PrefMetricsService() {
@@ -155,7 +94,8 @@ void PrefMetricsService::RecordLaunchPrefs() {
   UMA_HISTOGRAM_ENUMERATION("Settings.StartupPageLoadSettings",
                             restore_on_startup, kSessionStartupPrefValueMax);
   if (restore_on_startup == SessionStartupPref::kPrefValueURLs) {
-    const ListValue* url_list = prefs_->GetList(prefs::kURLsToRestoreOnStartup);
+    const base::ListValue* url_list =
+        prefs_->GetList(prefs::kURLsToRestoreOnStartup);
     UMA_HISTOGRAM_CUSTOM_COUNTS("Settings.StartupPageLoadURLs",
                                 url_list->GetSize(), 1, 50, 20);
     // Similarly, check startup pages for known search engine TLD+1s.
@@ -189,13 +129,6 @@ void PrefMetricsService::RecordLaunchPrefs() {
 #endif
 }
 
-// static
-void PrefMetricsService::RegisterPrefs(PrefRegistrySimple* registry) {
-  // Register the top level dictionary to map profile names to dictionaries of
-  // tracked preferences.
-  registry->RegisterDictionaryPref(prefs::kProfilePreferenceHashes);
-}
-
 void PrefMetricsService::RegisterSyncedPrefObservers() {
   LogHistogramValueCallback booleanHandler = base::Bind(
       &PrefMetricsService::LogBooleanPrefChange, base::Unretained(this));
@@ -235,7 +168,7 @@ void PrefMetricsService::OnPrefChanged(
 };
 
 void PrefMetricsService::LogBooleanPrefChange(const std::string& histogram_name,
-                                              const Value* value) {
+                                              const base::Value* value) {
   bool boolean_value = false;
   if (!value->GetAsBoolean(&boolean_value))
     return;
@@ -246,7 +179,7 @@ void PrefMetricsService::LogBooleanPrefChange(const std::string& histogram_name,
 
 void PrefMetricsService::LogIntegerPrefChange(int boundary_value,
                                               const std::string& histogram_name,
-                                              const Value* value) {
+                                              const base::Value* value) {
   int integer_value = 0;
   if (!value->GetAsInteger(&integer_value))
     return;
@@ -259,165 +192,6 @@ void PrefMetricsService::LogIntegerPrefChange(int boundary_value,
   histogram->Add(integer_value);
 }
 
-void PrefMetricsService::GetDeviceIdCallback(const std::string& device_id) {
-  device_id_ = device_id;
-  // On Aura, this seems to be called twice.
-  if (!checked_tracked_prefs_)
-    CheckTrackedPreferences();
-}
-
-// To detect changes to Preferences that happen outside of Chrome, we hash
-// selected pref values and save them in local state. CheckTrackedPreferences
-// compares the saved values to the values observed in the profile's prefs. A
-// dictionary of dictionaries in local state holds the hashed values, grouped by
-// profile. To make the system more resistant to spoofing, pref values are
-// hashed with the pref path and the device id.
-void PrefMetricsService::CheckTrackedPreferences() {
-  DCHECK(!checked_tracked_prefs_);
-
-  const base::DictionaryValue* pref_hash_dicts =
-      local_state_->GetDictionary(prefs::kProfilePreferenceHashes);
-  // Get the hashed prefs dictionary if it exists. If it doesn't, it will be
-  // created if we set preference values below.
-  const base::DictionaryValue* hashed_prefs = NULL;
-  pref_hash_dicts->GetDictionaryWithoutPathExpansion(profile_name_,
-                                                     &hashed_prefs);
-  for (int i = 0; i < tracked_pref_path_count_; ++i) {
-    // Skip prefs that haven't been registered.
-    if (!prefs_->FindPreference(tracked_pref_paths_[i]))
-      continue;
-
-    const base::Value* value = prefs_->GetUserPrefValue(tracked_pref_paths_[i]);
-    std::string last_hash;
-    // First try to get the stored expected hash...
-    if (hashed_prefs &&
-        hashed_prefs->GetString(tracked_pref_paths_[i], &last_hash)) {
-      // ... if we have one get the hash of the current value...
-      const std::string value_hash =
-          GetHashedPrefValue(tracked_pref_paths_[i], value,
-                             HASHED_PREF_STYLE_NEW);
-      // ... and check that it matches...
-      if (value_hash == last_hash) {
-        UMA_HISTOGRAM_ENUMERATION("Settings.TrackedPreferenceUnchanged",
-            i, tracked_pref_path_count_);
-      } else {
-        // ... if it doesn't: was the value simply cleared?
-        if (!value) {
-          UMA_HISTOGRAM_ENUMERATION("Settings.TrackedPreferenceCleared",
-              i, tracked_pref_path_count_);
-        } else {
-          // ... or does it match the old style hash?
-          std::string old_style_hash =
-              GetHashedPrefValue(tracked_pref_paths_[i], value,
-                                 HASHED_PREF_STYLE_DEPRECATED);
-          if (old_style_hash == last_hash) {
-            UMA_HISTOGRAM_ENUMERATION("Settings.TrackedPreferenceMigrated",
-                i, tracked_pref_path_count_);
-          } else {
-            // ... or was it simply changed to something else?
-            UMA_HISTOGRAM_ENUMERATION("Settings.TrackedPreferenceChanged",
-                i, tracked_pref_path_count_);
-          }
-        }
-
-        // ... either way update the expected hash to match the new value.
-        UpdateTrackedPreference(tracked_pref_paths_[i]);
-      }
-    } else {
-      // Record that we haven't tracked this preference yet, or the hash in
-      // local state was removed.
-      UMA_HISTOGRAM_ENUMERATION("Settings.TrackedPreferenceInitialized",
-          i, tracked_pref_path_count_);
-      UpdateTrackedPreference(tracked_pref_paths_[i]);
-    }
-  }
-
-  checked_tracked_prefs_ = true;
-
-  // Now that we've checked the incoming preferences, register for change
-  // notifications, unless this is test code.
-  // TODO(bbudge) Fix failing browser_tests and so we can remove this test.
-  // Several tests fail when they shutdown before they can write local state.
-  if (!CommandLine::ForCurrentProcess()->HasSwitch(switches::kTestType) &&
-      !CommandLine::ForCurrentProcess()->HasSwitch(switches::kChromeFrame)) {
-    InitializePrefObservers();
-  }
-}
-
-void PrefMetricsService::UpdateTrackedPreference(const char* path) {
-  const base::Value* value = prefs_->GetUserPrefValue(path);
-  DictionaryPrefUpdate update(local_state_, prefs::kProfilePreferenceHashes);
-  DictionaryValue* child_dictionary = NULL;
-
-  // Get the dictionary corresponding to the profile name,
-  // which may have a '.'
-  if (!update->GetDictionaryWithoutPathExpansion(profile_name_,
-                                                 &child_dictionary)) {
-    child_dictionary = new DictionaryValue;
-    update->SetWithoutPathExpansion(profile_name_, child_dictionary);
-  }
-
-  child_dictionary->SetString(path,
-                              GetHashedPrefValue(path, value,
-                                                 HASHED_PREF_STYLE_NEW));
-}
-
-std::string PrefMetricsService::GetHashedPrefValue(
-    const char* path,
-    const base::Value* value,
-    HashedPrefStyle desired_style) {
-  // Dictionary values may contain empty lists and sub-dictionaries. Make a
-  // deep copy with those removed to make the hash more stable.
-  const DictionaryValue* dict_value;
-  scoped_ptr<DictionaryValue> canonical_dict_value;
-  if (value &&
-      value->GetAsDictionary(&dict_value)) {
-    canonical_dict_value.reset(dict_value->DeepCopyWithoutEmptyChildren());
-    value = canonical_dict_value.get();
-  }
-
-  std::string value_as_string;
-  // If |value| is NULL, we will still build a unique hash based on |device_id_|
-  // and |path| below.
-  if (value) {
-    JSONStringValueSerializer serializer(&value_as_string);
-    serializer.Serialize(*value);
-  }
-
-  std::string string_to_hash;
-  // TODO(gab): Remove this as the old style is phased out.
-  if (desired_style == HASHED_PREF_STYLE_NEW) {
-    string_to_hash.append(device_id_);
-    string_to_hash.append(path);
-  }
-  string_to_hash.append(value_as_string);
-
-  crypto::HMAC hmac(crypto::HMAC::SHA256);
-  unsigned char digest[kSHA256DigestSize];
-  if (!hmac.Init(pref_hash_seed_) ||
-      !hmac.Sign(string_to_hash, digest, kSHA256DigestSize)) {
-    NOTREACHED();
-    return std::string();
-  }
-
-  return base::HexEncode(digest, kSHA256DigestSize);
-}
-
-void PrefMetricsService::InitializePrefObservers() {
-  pref_registrar_.Init(prefs_);
-  for (int i = 0; i < tracked_pref_path_count_; ++i) {
-    // Skip prefs that haven't been registered.
-    if (!prefs_->FindPreference(tracked_pref_paths_[i]))
-      continue;
-
-    pref_registrar_.Add(
-        tracked_pref_paths_[i],
-        base::Bind(&PrefMetricsService::UpdateTrackedPreference,
-                   weak_factory_.GetWeakPtr(),
-                   tracked_pref_paths_[i]));
-  }
-}
-
 // static
 PrefMetricsService::Factory* PrefMetricsService::Factory::GetInstance() {
   return Singleton<PrefMetricsService::Factory>::get();