include/comphelper/hash.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  */
   9
  10 #ifndef INCLUDED_COMPHELPER_HASH_HXX
  11 #define INCLUDED_COMPHELPER_HASH_HXX
  12
  13 #include <comphelper/comphelperdllapi.h>
  14 #include <rtl/digest.h>
  15
  16 #include <memory>
  17 #include <vector>
  18
  19 namespace rtl {
  20     class OUString;
  21 }
  22
  23 namespace comphelper {
  24
  25 enum class HashType
  26 {
  27     MD5,
  28     SHA1,
  29     SHA256,
  30     SHA384,
  31     SHA512
  32 };
  33
  34 const sal_uInt32 MD5_HASH_LENGTH = RTL_DIGEST_LENGTH_MD5;
  35 const sal_uInt32 SHA1_HASH_LENGTH = RTL_DIGEST_LENGTH_SHA1;
  36 const sal_uInt32 SHA256_HASH_LENGTH = 32;
  37 const sal_uInt32 SHA384_HASH_LENGTH = 48;
  38 const sal_uInt32 SHA512_HASH_LENGTH = 64;
  39
  40 struct HashImpl;
  41
  42 class COMPHELPER_DLLPUBLIC Hash
  43 {
  44 private:
  45     std::unique_ptr<HashImpl> mpImpl;
  46
  47 public:
  48
  49     enum class IterCount
  50     {
  51         NONE,       /// Iteration count not added to hash iterations.
  52         PREPEND,    /// Iteration count prepended to hash iterations.
  53         APPEND      /// Iteration count appended to hash iterations.
  54     };
  55
  56     Hash(HashType eType);
  57     ~Hash();
  58
  59     void update(const unsigned char* pInput, size_t length);
  60
  61     std::vector<unsigned char> finalize();
  62
  63     static std::vector<unsigned char> calculateHash(const unsigned char* pInput, size_t length, HashType eType);
  64
  65     /** Calculate hash value with salt (pSalt,nSaltLen) prepended to password
  66         (pInput,nLength) and repeated iterations run if nSpinCount>0.
  67
  68         This implements the algorithms as specified in
  69         https://msdn.microsoft.com/en-us/library/dd920692 or
  70         https://msdn.microsoft.com/en-us/library/dd924776 and
  71         https://msdn.microsoft.com/en-us/library/dd925430
  72
  73         @param  pSalt
  74                 may be nullptr thus no salt prepended
  75
  76         @param  nSpinCount
  77                 If >0, repeat nSpinCount iterations. For each iteration, the
  78                 previous iteration's result plus a 4 byte value (0-based,
  79                 little endian) containing the number of the iteration prepended
  80                 or appended to the hash value is the input for the next
  81                 iteration.
  82
  83         @param  eIterCount
  84                 If IterCount::APPEND, append iteration count as per
  85                 https://msdn.microsoft.com/en-us/library/dd920692
  86                 If IterCount::PREPEND, prepend iteration count as per
  87                 https://msdn.microsoft.com/en-us/library/dd924776 and
  88                 https://msdn.microsoft.com/en-us/library/dd925430
  89                 If IterCount::NONE, do not add the iteration count to hash
  90                 iterations.
  91
  92         @return the raw hash value
  93      */
  94     static std::vector<unsigned char> calculateHash(
  95             const unsigned char* pInput, size_t nLength,
  96             const unsigned char* pSalt, size_t nSaltLen,
  97             sal_uInt32 nSpinCount,
  98             IterCount eIterCount,
  99             HashType eType);
 100
 101     /** Convenience function to calculate a salted hash with iterations.
 102
 103         @param  rPassword
 104                 UTF-16 encoded string, hashed byte-wise as unsigned char.
 105
 106         @param  rSaltValue
 107                 Salt that will be prepended to password data.
 108      */
 109     static std::vector<unsigned char> calculateHash(
 110             const rtl::OUString& rPassword,
 111             const std::vector<unsigned char>& rSaltValue,
 112             sal_uInt32 nSpinCount,
 113             IterCount eIterCount,
 114             HashType eType);
 115
 116     size_t getLength() const;
 117 };
 118
 119 }
 120
 121 #endif // INCLUDED_COMPHELPER_HASH_HXX
 122
 123 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */