OLD | NEW |
| (Empty) |
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_ | |
OLD | NEW |