xref: /aosp_15_r20/external/cronet/crypto/secure_hash.h (revision 6777b5387eb2ff775bb5750e3f5d96f37fb7352b)
1*6777b538SAndroid Build Coastguard Worker // Copyright 2012 The Chromium Authors
2*6777b538SAndroid Build Coastguard Worker // Use of this source code is governed by a BSD-style license that can be
3*6777b538SAndroid Build Coastguard Worker // found in the LICENSE file.
4*6777b538SAndroid Build Coastguard Worker 
5*6777b538SAndroid Build Coastguard Worker #ifndef CRYPTO_SECURE_HASH_H_
6*6777b538SAndroid Build Coastguard Worker #define CRYPTO_SECURE_HASH_H_
7*6777b538SAndroid Build Coastguard Worker 
8*6777b538SAndroid Build Coastguard Worker #include <stddef.h>
9*6777b538SAndroid Build Coastguard Worker 
10*6777b538SAndroid Build Coastguard Worker #include <memory>
11*6777b538SAndroid Build Coastguard Worker 
12*6777b538SAndroid Build Coastguard Worker #include "crypto/crypto_export.h"
13*6777b538SAndroid Build Coastguard Worker 
14*6777b538SAndroid Build Coastguard Worker namespace crypto {
15*6777b538SAndroid Build Coastguard Worker 
16*6777b538SAndroid Build Coastguard Worker // A wrapper to calculate secure hashes incrementally, allowing to
17*6777b538SAndroid Build Coastguard Worker // be used when the full input is not known in advance. The end result will the
18*6777b538SAndroid Build Coastguard Worker // same as if we have the full input in advance.
19*6777b538SAndroid Build Coastguard Worker class CRYPTO_EXPORT SecureHash {
20*6777b538SAndroid Build Coastguard Worker  public:
21*6777b538SAndroid Build Coastguard Worker   enum Algorithm {
22*6777b538SAndroid Build Coastguard Worker     SHA256,
23*6777b538SAndroid Build Coastguard Worker     SHA512,
24*6777b538SAndroid Build Coastguard Worker   };
25*6777b538SAndroid Build Coastguard Worker 
26*6777b538SAndroid Build Coastguard Worker   SecureHash(const SecureHash&) = delete;
27*6777b538SAndroid Build Coastguard Worker   SecureHash& operator=(const SecureHash&) = delete;
28*6777b538SAndroid Build Coastguard Worker 
~SecureHash()29*6777b538SAndroid Build Coastguard Worker   virtual ~SecureHash() {}
30*6777b538SAndroid Build Coastguard Worker 
31*6777b538SAndroid Build Coastguard Worker   static std::unique_ptr<SecureHash> Create(Algorithm type);
32*6777b538SAndroid Build Coastguard Worker 
33*6777b538SAndroid Build Coastguard Worker   virtual void Update(const void* input, size_t len) = 0;
34*6777b538SAndroid Build Coastguard Worker   virtual void Finish(void* output, size_t len) = 0;
35*6777b538SAndroid Build Coastguard Worker   virtual size_t GetHashLength() const = 0;
36*6777b538SAndroid Build Coastguard Worker 
37*6777b538SAndroid Build Coastguard Worker   // Create a clone of this SecureHash. The returned clone and this both
38*6777b538SAndroid Build Coastguard Worker   // represent the same hash state. But from this point on, calling
39*6777b538SAndroid Build Coastguard Worker   // Update()/Finish() on either doesn't affect the state of the other.
40*6777b538SAndroid Build Coastguard Worker   virtual std::unique_ptr<SecureHash> Clone() const = 0;
41*6777b538SAndroid Build Coastguard Worker 
42*6777b538SAndroid Build Coastguard Worker  protected:
SecureHash()43*6777b538SAndroid Build Coastguard Worker   SecureHash() {}
44*6777b538SAndroid Build Coastguard Worker };
45*6777b538SAndroid Build Coastguard Worker 
46*6777b538SAndroid Build Coastguard Worker }  // namespace crypto
47*6777b538SAndroid Build Coastguard Worker 
48*6777b538SAndroid Build Coastguard Worker #endif  // CRYPTO_SECURE_HASH_H_
49