// Copyright (C) 2024, The Duplicati Team
// https://duplicati.com, hello@duplicati.com
//
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the "Software"),
// to deal in the Software without restriction, including without limitation
// the rights to use, copy, modify, merge, publish, distribute, sublicense,
// and/or sell copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.
using System;
using System.Collections.Generic;
using System.IO;
using Duplicati.Library.Interface;
namespace Duplicati.Library.Encryption
{
///
/// Implements AES encryption
///
public class AESEncryption : EncryptionBase
{
///
/// The key used to encrypt the data
///
private string m_key;
///
/// The cached value for size overhead
///
private static long m_cachedsizeoverhead = -1;
///
/// Default constructor, used to read file extension and supported commands
///
public AESEncryption()
{
}
///
/// Constructs a new AES encryption/decyption instance
///
public AESEncryption(string passphrase, Dictionary options)
{
if (string.IsNullOrEmpty(passphrase))
throw new ArgumentException(Strings.AESEncryption.EmptyKeyError, nameof(passphrase));
m_key = passphrase;
}
#region IEncryption Members
///
/// The extension that the encryption implementation adds to the filename
///
/// The filename extension.
public override string FilenameExtension { get { return "aes"; } }
///
/// A localized description of the encryption module
///
/// The description.
public override string Description { get { return string.Format(Strings.AESEncryption.Description_v2); } }
///
/// A localized string describing the encryption module with a friendly name
///
/// The display name.
public override string DisplayName { get { return Strings.AESEncryption.DisplayName; } }
///
/// Dispose the specified disposing.
///
/// If set to true disposing.
protected override void Dispose(bool disposing) { m_key = null; }
///
/// Returns the size in bytes of the overhead that will be added to a file of the given size when encrypted
///
/// The size of the file to encrypt
/// The size of the overhead in bytes
public override long SizeOverhead(long filesize)
{
if (m_cachedsizeoverhead != -1)
return m_cachedsizeoverhead;
//If we use 1, we trigger the blocksize.
//As the AES algorithm does not alter the size,
// the results are the same as for the real size,
// but a single byte encryption is much faster.
return m_cachedsizeoverhead = base.SizeOverhead(1);
}
///
/// Encrypts the stream
///
/// The target stream
/// An encrypted stream that can be written to
public override Stream Encrypt(Stream input)
=> new SharpAESCrypt.EncryptingStream(m_key, input);
///
/// Decrypts the stream to the output stream
///
/// The encrypted stream
/// The unencrypted stream
public override Stream Decrypt(Stream input)
=> new SharpAESCrypt.DecryptingStream(m_key, input, new SharpAESCrypt.DecryptionOptions(IgnorePaddingBytes: Environment.GetEnvironmentVariable("AES_IGNORE_PADDING_BYTES") == "1"));
///
/// Gets a list of supported commandline arguments
///
/// The supported commands.
public override IList SupportedCommands
=> new List([
new CommandLineArgument(
"aes-set-threadlevel",
CommandLineArgument.ArgumentType.String,
Strings.AESEncryption.AessetthreadlevelShort,
Strings.AESEncryption.AessetthreadlevelLong,
"",
null,
null,
Strings.AESEncryption.AessetthreadlevelDeprecated
),
]);
#endregion
}
}