20.1.0-preview2

API Changes

• GetExportBlobSize and TryExport methods have been added to the Key and PublicKey classes

Compatibility

NSec now supports Alpine Linux (x64).

This pre-release supports .NET Core 3.1, 3.0, and 2.1.

19.12.0-preview1

API Changes

• The API has been fully annotated with C# 8.0 "nullable" annotations
• Key.PublicKey has been changed from returning null to throwing an InvalidOperationException if the Key is not an asymmetric key
• Key.HasPublicKey has been added for checking whether a Key is an asymmetric key
• PublicKey.Equals has been changed from throwing a NullReferenceException to returning false if other is null

Compatibility

This pre-release supports .NET Core 3.1, 3.0, and 2.1.

19.5.0

New release! 🎉

See Installation for installation details and supported platforms.

19.4.0-preview2

Strong Naming

The assembly is now strong-named.

Compatibility

This pre-release supports .NET Core 2.2 and 2.1.

19.1.0-preview1

New Features

• Incremental hashing and MACing
• Algorithms
  • Hash: SHA-512-256
  • MAC: HMAC-SHA256-128, HMAC-SHA512-256

(I.e., truncated SHA-512, HMAC-SHA256, and HMAC-SHA512. These are not to be confused with SHA-512/256, HMAC-SHA256/128, and HMAC-SHA512/256, respectively, which not only truncate but additionally also use a different initial hash value.)

Compatibility

This pre-release supports .NET Core 2.2, 2.1, and 1.1.

18.6.0

First release! 🎉

See Installation for installation details and supported platforms.

18.5.0-preview3

API Changes

• AeadAlgorithm.TryDecrypt has been renamed to Decrypt
• HashAlgorithm/MacAlgorithm/SignatureAlgorithm.TryVerify has been renamed to Verify
• KeyAgreementAlgorithm.TryAgree has been removed
• SharedSecretCreationParameters have been added

Compatibility

This pre-release requires .NET Core 2.1 RC1.

18.4.0-preview2

API Changes

• Static properties have been added get predefined algorithm instances
• Key creating methods now optionally accept KeyCreationParameters
• The HashAlgorithm output size is now a constructor parameter
• The MacAlgorithm key size and output size are now constructor parameters

Compatibility

This pre-release requires .NET Core 2.1 Preview 2.

18.2.0-preview1

New Features

• Algorithms
  • AEAD: AES256-GCM, ChaCha20-Poly1305
  • Hash: BLAKE2b, SHA-256, SHA-512
  • Key agreement: X25519
  • Key derivation: HKDF-SHA256, HKDF-SHA512
  • MAC: BLAKE2b, HMAC-SHA256, HMAC-SHA512
  • Signing: Ed25519
• Keys
• Nonces
• Shared secrets
• Random number generation

Compatibility

This pre-release requires .NET Core 2.1 Preview 1.