Class Aes128

Namespace

CryptoHives.Foundation.Security.Cryptography.Cipher

Assembly

CryptoHives.Foundation.Security.Cryptography.dll

AES-128 symmetric cipher implementation.

public sealed class Aes128 : SymmetricCipher, IDisposable

Inheritance

object

SymmetricAlgorithm

SymmetricCipher

Aes128

Implements

IDisposable

Inherited Members

SymmetricCipher.InitialCounter

SymmetricCipher.IV

SymmetricCipher.Key

SymmetricCipher.Mode

SymmetricCipher.Padding

SymmetricCipher.TagSize

SymmetricCipher.IsAuthenticated

SymmetricCipher.GenerateKey()

SymmetricCipher.GenerateIV()

SymmetricCipher.CreateEncryptor()

SymmetricCipher.CreateEncryptor(byte[], byte[])

SymmetricCipher.CreateDecryptor()

SymmetricCipher.CreateDecryptor(byte[], byte[])

SymmetricCipher.Encrypt(ReadOnlySpan<byte>)

SymmetricCipher.Decrypt(ReadOnlySpan<byte>)

SymmetricAlgorithm.Dispose()

SymmetricAlgorithm.Clear()

SymmetricAlgorithm.ValidKeySize(int)

SymmetricAlgorithm.Create(string)

SymmetricAlgorithm.BlockSize

SymmetricAlgorithm.FeedbackSize

SymmetricAlgorithm.LegalBlockSizes

SymmetricAlgorithm.LegalKeySizes

SymmetricAlgorithm.KeySize

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

object.GetType()

Remarks

AES-128 uses a 128-bit (16-byte) key with 10 rounds of encryption. This is the fastest AES variant and provides adequate security for most applications.

Security level: 128 bits (quantum: 64 bits with Grover's algorithm)

Example usage:

using var aes = Aes128.Create();
aes.GenerateKey();
aes.GenerateIV();
byte[] ciphertext = aes.Encrypt(plaintext);
byte[] decrypted = aes.Decrypt(ciphertext);

Constructors

Aes128()

Initializes a new instance of the Aes128 class.

public Aes128()

Fields

KeySizeBits

Key size in bits for AES-128.

public const int KeySizeBits = 128

Field Value

int

KeySizeBytes

Key size in bytes for AES-128.

public const int KeySizeBytes = 16

Field Value

int

Properties

AlgorithmName

Gets the name of the cipher algorithm.

public override string AlgorithmName { get; }

Property Value

string

Examples

"AES-256", "ChaCha20", "AES-256-GCM"

IVSize

Gets the required IV/nonce size in bytes for the current mode.

public override int IVSize { get; }

Property Value

int

Methods

Create()

Creates a new instance of the Aes128 cipher.

public static Aes128 Create()

Returns

Aes128

A new AES-128 cipher instance.

CreateCipherDecryptor(ReadOnlySpan<byte>, ReadOnlySpan<byte>)

Creates a decryptor transform using the specified key and IV.

protected override ICipherTransform CreateCipherDecryptor(ReadOnlySpan<byte> key, ReadOnlySpan<byte> iv)

Parameters

key ReadOnlySpan<byte>

The secret key.

iv ReadOnlySpan<byte>

The initialization vector or nonce.

Returns

ICipherTransform

A new cipher decryptor transform.

CreateCipherEncryptor(ReadOnlySpan<byte>, ReadOnlySpan<byte>)

Creates an encryptor transform using the specified key and IV.

protected override ICipherTransform CreateCipherEncryptor(ReadOnlySpan<byte> key, ReadOnlySpan<byte> iv)

Parameters

key ReadOnlySpan<byte>

The secret key.

iv ReadOnlySpan<byte>

The initialization vector or nonce.

Returns

ICipherTransform

A new cipher encryptor transform.