145 lines
4.5 KiB
C#
145 lines
4.5 KiB
C#
/*
|
|
KeePass Password Safe - The Open-Source Password Manager
|
|
Copyright (C) 2003-2017 Dominik Reichl <dominik.reichl@t-online.de>
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Diagnostics;
|
|
using System.Text;
|
|
|
|
namespace KeePassLib.Cryptography.KeyDerivation
|
|
{
|
|
public sealed partial class Argon2Kdf : KdfEngine
|
|
{
|
|
private static readonly PwUuid g_uuid = new PwUuid(new byte[] {
|
|
0xEF, 0x63, 0x6D, 0xDF, 0x8C, 0x29, 0x44, 0x4B,
|
|
0x91, 0xF7, 0xA9, 0xA4, 0x03, 0xE3, 0x0A, 0x0C });
|
|
|
|
public const string ParamSalt = "S"; // Byte[]
|
|
public const string ParamParallelism = "P"; // UInt32
|
|
public const string ParamMemory = "M"; // UInt64
|
|
public const string ParamIterations = "I"; // UInt64
|
|
public const string ParamVersion = "V"; // UInt32
|
|
public const string ParamSecretKey = "K"; // Byte[]
|
|
public const string ParamAssocData = "A"; // Byte[]
|
|
|
|
private const uint MinVersion = 0x10;
|
|
private const uint MaxVersion = 0x13;
|
|
|
|
private const int MinSalt = 8;
|
|
private const int MaxSalt = int.MaxValue; // .NET limit; 2^32 - 1 in spec
|
|
|
|
internal const ulong MinIterations = 1;
|
|
internal const ulong MaxIterations = uint.MaxValue;
|
|
|
|
internal const ulong MinMemory = 1024 * 8; // For parallelism = 1
|
|
// internal const ulong MaxMemory = (ulong)uint.MaxValue * 1024UL; // Spec
|
|
internal const ulong MaxMemory = int.MaxValue; // .NET limit
|
|
|
|
internal const uint MinParallelism = 1;
|
|
internal const uint MaxParallelism = (1 << 24) - 1;
|
|
|
|
internal const ulong DefaultIterations = 2;
|
|
internal const ulong DefaultMemory = 1024 * 1024; // 1 MB
|
|
internal const uint DefaultParallelism = 2;
|
|
|
|
public override PwUuid Uuid
|
|
{
|
|
get { return g_uuid; }
|
|
}
|
|
|
|
public override string Name
|
|
{
|
|
get { return "Argon2"; }
|
|
}
|
|
|
|
public Argon2Kdf()
|
|
{
|
|
}
|
|
|
|
public override KdfParameters GetDefaultParameters()
|
|
{
|
|
KdfParameters p = base.GetDefaultParameters();
|
|
|
|
p.SetUInt32(ParamVersion, MaxVersion);
|
|
|
|
p.SetUInt64(ParamIterations, DefaultIterations);
|
|
p.SetUInt64(ParamMemory, DefaultMemory);
|
|
p.SetUInt32(ParamParallelism, DefaultParallelism);
|
|
|
|
return p;
|
|
}
|
|
|
|
public override void Randomize(KdfParameters p)
|
|
{
|
|
if(p == null) { Debug.Assert(false); return; }
|
|
Debug.Assert(g_uuid.Equals(p.KdfUuid));
|
|
|
|
byte[] pb = CryptoRandom.Instance.GetRandomBytes(32);
|
|
p.SetByteArray(ParamSalt, pb);
|
|
}
|
|
|
|
public override byte[] Transform(byte[] pbMsg, KdfParameters p)
|
|
{
|
|
if(pbMsg == null) throw new ArgumentNullException("pbMsg");
|
|
if(p == null) throw new ArgumentNullException("p");
|
|
|
|
byte[] pbSalt = p.GetByteArray(ParamSalt);
|
|
if(pbSalt == null)
|
|
throw new ArgumentNullException("p.Salt");
|
|
if((pbSalt.Length < MinSalt) || (pbSalt.Length > MaxSalt))
|
|
throw new ArgumentOutOfRangeException("p.Salt");
|
|
|
|
uint uPar = p.GetUInt32(ParamParallelism, 0);
|
|
if((uPar < MinParallelism) || (uPar > MaxParallelism))
|
|
throw new ArgumentOutOfRangeException("p.Parallelism");
|
|
|
|
ulong uMem = p.GetUInt64(ParamMemory, 0);
|
|
if((uMem < MinMemory) || (uMem > MaxMemory))
|
|
throw new ArgumentOutOfRangeException("p.Memory");
|
|
|
|
ulong uIt = p.GetUInt64(ParamIterations, 0);
|
|
if((uIt < MinIterations) || (uIt > MaxIterations))
|
|
throw new ArgumentOutOfRangeException("p.Iterations");
|
|
|
|
uint v = p.GetUInt32(ParamVersion, 0);
|
|
if((v < MinVersion) || (v > MaxVersion))
|
|
throw new ArgumentOutOfRangeException("p.Version");
|
|
|
|
byte[] pbSecretKey = p.GetByteArray(ParamSecretKey);
|
|
byte[] pbAssocData = p.GetByteArray(ParamAssocData);
|
|
|
|
byte[] pbRet = Argon2d(pbMsg, pbSalt, uPar, uMem, uIt,
|
|
32, v, pbSecretKey, pbAssocData);
|
|
|
|
if(uMem > (100UL * 1024UL * 1024UL)) GC.Collect();
|
|
return pbRet;
|
|
}
|
|
|
|
public override KdfParameters GetBestParameters(uint uMilliseconds)
|
|
{
|
|
KdfParameters p = GetDefaultParameters();
|
|
Randomize(p);
|
|
|
|
MaximizeParamUInt64(p, ParamIterations, MinIterations,
|
|
MaxIterations, uMilliseconds, true);
|
|
return p;
|
|
}
|
|
}
|
|
}
|