crypto/secure_util.h

   1 // Copyright (c) 2011 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 CRYPTO_SECURE_UTIL_H_
   6 #define CRYPTO_SECURE_UTIL_H_
   7 #pragma once
   8
   9 #include <stddef.h>
  10
  11 #include "crypto/crypto_export.h"
  12
  13 namespace crypto {
  14
  15 // Performs a constant-time comparison of two strings, returning true if the
  16 // strings are equal.
  17 //
  18 // For cryptographic operations, comparison functions such as memcmp() may
  19 // expose side-channel information about input, allowing an attacker to
  20 // perform timing analysis to determine what the expected bits should be. In
  21 // order to avoid such attacks, the comparison must execute in constant time,
  22 // so as to not to reveal to the attacker where the difference(s) are.
  23 // For an example attack, see
  24 // http://groups.google.com/group/keyczar-discuss/browse_thread/thread/5571eca0948b2a13
  25 CRYPTO_EXPORT bool SecureMemEqual(const void* s1, const void* s2, size_t n);
  26
  27 }  // namespace crypto
  28
  29 #endif  // CRYPTO_SECURE_UTIL_H_
  30