From 0c649e5676f12be971415acdd60e3fc62a78d8cf Mon Sep 17 00:00:00 2001 From: Matthew Endsley Date: Fri, 18 Dec 2020 18:02:49 -0800 Subject: [PATCH] Add a few constant-time utilities --- Hazel/Crypto/Const.cs | 82 +++++++++++++++++++++++++++++++++++++++++++ Hazel/Hazel.csproj | 1 + 2 files changed, 83 insertions(+) create mode 100644 Hazel/Crypto/Const.cs diff --git a/Hazel/Crypto/Const.cs b/Hazel/Crypto/Const.cs new file mode 100644 index 0000000..4dfef47 --- /dev/null +++ b/Hazel/Crypto/Const.cs @@ -0,0 +1,82 @@ +using System.Diagnostics; + +namespace Hazel.Crypto +{ + public static class Const + { + + /// + /// Compare two bytes for equality. + /// + /// This takes care to always use a constant amount of time to prevent + /// leaking information through side-channel attacks. + /// + /// This is aceived by collapsing the xor bits down into a single bit. + /// + /// Ported from: + /// https://github.com/mendsley/tiny/blob/master/include/tiny/crypto/constant.h + /// + /// + /// Returns `1` is the two bytes or equivalent. Otherwise, returns `0` + /// + public static byte ConstantCompareByte(byte a, byte b) + { + byte result = (byte)(~(a ^ b)); + + // collapse bits down to the LSB + result &= (byte)(result >> 4); + result &= (byte)(result >> 2); + result &= (byte)(result >> 1); + + return result; + } + + /// + /// Compare two equal length spans for equality. + /// + /// This takes care to always use a constant amount of time to prevent + /// leaking information through side-channel attacks. + /// + /// Ported from: + /// https://github.com/mendsley/tiny/blob/master/include/tiny/crypto/constant.h + /// + /// + /// Returns `1` if the spans are equivalent. Others, returns `0`. + /// + public static byte ConstantCompareSpans(ByteSpan a, ByteSpan b) + { + Debug.Assert(a.Length == b.Length); + + byte value = 0; + for (int ii = 0, nn = a.Length; ii != nn; ++ii) + { + value |= (byte)(a[ii] ^ b[ii]); + } + + return ConstantCompareByte(value, 0); + } + + /// + /// Compare a span against an all zero span + /// + /// This takes care to always use a constant amount of time to prevent + /// leaking information through side-channel attacks. + /// + /// Ported from: + /// https://github.com/mendsley/tiny/blob/master/include/tiny/crypto/constant.h + /// + /// + /// Returns `1` if the spans is all zeros. Others, returns `0`. + /// + public static byte ConstantCompareZeroSpan(ByteSpan a) + { + byte value = 0; + for (int ii = 0, nn = a.Length; ii != nn; ++ii) + { + value |= (byte)(a[ii] ^ 0); + } + + return ConstantCompareByte(value, 0); + } + } +} diff --git a/Hazel/Hazel.csproj b/Hazel/Hazel.csproj index 79ad6e8..9c49e96 100644 --- a/Hazel/Hazel.csproj +++ b/Hazel/Hazel.csproj @@ -73,6 +73,7 @@ + -- 2.39.5