chrome/browser/prefs/tracked/pref_hash_store_transaction.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   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 CHROME_BROWSER_PREFS_TRACKED_PREF_HASH_STORE_TRANSACTION_H_
   6 #define CHROME_BROWSER_PREFS_TRACKED_PREF_HASH_STORE_TRANSACTION_H_
   7
   8 #include <string>
   9 #include <vector>
  10
  11 namespace base {
  12 class DictionaryValue;
  13 class Value;
  14 }  // namespace base
  15
  16 // Used to perform a series of checks/transformations on a PrefHashStore.
  17 class PrefHashStoreTransaction {
  18  public:
  19   enum ValueState {
  20     // The preference value corresponds to its stored hash.
  21     UNCHANGED,
  22     // The preference has been cleared since the last hash.
  23     CLEARED,
  24     // The preference value corresponds to its stored hash, but the hash was
  25     // calculated using a deprecated hash algorithm which is just as safe as
  26     // the current one.
  27     SECURE_LEGACY,
  28     // The preference value has been changed since the last hash.
  29     CHANGED,
  30     // No stored hash exists for the preference value.
  31     UNTRUSTED_UNKNOWN_VALUE,
  32     // No stored hash exists for the preference value, but the current set of
  33     // hashes stored is trusted and thus this value can safely be seeded. This
  34     // happens when all hashes are already properly seeded and a newly
  35     // tracked value needs to be seeded).
  36     TRUSTED_UNKNOWN_VALUE,
  37     // NULL values are inherently trusted.
  38     TRUSTED_NULL_VALUE,
  39   };
  40
  41   // Finalizes any remaining work after the transaction has been performed.
  42   virtual ~PrefHashStoreTransaction() {}
  43
  44   // Checks |initial_value| against the existing stored value hash.
  45   virtual ValueState CheckValue(
  46       const std::string& path, const base::Value* initial_value) const = 0;
  47
  48   // Stores a hash of the current |value| of the preference at |path|.
  49   virtual void StoreHash(const std::string& path,
  50                          const base::Value* value) = 0;
  51
  52   // Checks |initial_value| against the existing stored hashes for the split
  53   // preference at |path|. |initial_split_value| being an empty dictionary or
  54   // NULL is equivalent. |invalid_keys| must initially be empty. |invalid_keys|
  55   // will not be modified unless the return value is CHANGED, in which case it
  56   // will be filled with the keys that are considered invalid (unknown or
  57   // changed).
  58   virtual ValueState CheckSplitValue(
  59       const std::string& path,
  60       const base::DictionaryValue* initial_split_value,
  61       std::vector<std::string>* invalid_keys) const = 0;
  62
  63   // Stores hashes for the |value| of the split preference at |path|.
  64   // |split_value| being an empty dictionary or NULL is equivalent.
  65   virtual void StoreSplitHash(
  66       const std::string& path,
  67       const base::DictionaryValue* split_value) = 0;
  68
  69   // Indicates whether the store contains a hash for the preference at |path|.
  70   virtual bool HasHash(const std::string& path) const = 0;
  71
  72   // Sets the hash for the preference at |path|.
  73   // If |path| is a split preference |hash| must be a DictionaryValue whose
  74   // keys are keys in the split preference and whose values are MACs of the
  75   // corresponding values in the split preference.
  76   // If |path| is an atomic preference |hash| must be a StringValue
  77   // containing a MAC of the preference value.
  78   // |hash| should originate from a PrefHashStore sharing the same MAC
  79   // parameters as this transaction's store.
  80   // The (in)validity of the super MAC will be maintained by this call.
  81   virtual void ImportHash(const std::string& path, const base::Value* hash) = 0;
  82
  83   // Removes the hash stored at |path|. The (in)validity of the super MAC will
  84   // be maintained by this call.
  85   virtual void ClearHash(const std::string& path) = 0;
  86
  87   // Indicates whether the super MAC was successfully verified at the beginning
  88   // of this transaction.
  89   virtual bool IsSuperMACValid() const = 0;
  90
  91   // Forces a valid super MAC to be stored when this transaction terminates.
  92   // Returns true if this results in a change to the store contents.
  93   virtual bool StampSuperMac() = 0;
  94 };
  95
  96 #endif  // CHROME_BROWSER_PREFS_TRACKED_PREF_HASH_STORE_TRANSACTION_H_