Skip to content
C# implementation of Miscreant: misuse-resistant encryption library with AES-SIV (RFC 5297) and AES-PMAC-SIV support
C# Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Miscreant.Benchmarks
Miscreant.Examples
Miscreant.Tests
Miscreant
vectors
.gitignore
.travis.yml
AUTHORS.md
CHANGES.md
CODE_OF_CONDUCT.md
LICENSE.txt
Miscreant.sln
PackageIcon.png
README.md
appveyor.yml
ci.sh

README.md

miscreant.net

Latest Version Build Status MIT licensed Gitter Chat

The best crypto you've never heard of, brought to you by Phil Rogaway

C# implementation of Miscreant: Advanced symmetric encryption library which provides the AES-SIV (RFC 5297), AES-PMAC-SIV, and STREAM constructions. These algorithms are easy-to-use (or rather, hard-to-misuse) and support encryption of individual messages or message streams.

AES-SIV provides nonce-reuse misuse-resistance (NRMR): accidentally reusing a nonce with this construction is not a security catastrophe, unlike it is with more popular AES encryption modes like AES-GCM. With AES-SIV, the worst outcome of reusing a nonce is an attacker can see you've sent the same plaintext twice, as opposed to almost all other AES modes where it can facilitate chosen ciphertext attacks and/or full plaintext recovery.

For more information, see the toplevel README.md.

Help and Discussion

Have questions? Want to suggest a feature or change?

Documentation

Please see the Miscreant Wiki for API documentation.

Security Notice

This library has not undergone a thorough security audit, and though it makes an effort to use constant time operations throughout its implementation, actual constant time behavior has not been verified.

Use this library at your own risk.

Requirements

This library is targeting .NET Standard 1.3. It was tested on .NET Framework 4.7.1 and .NET Core 2.1.2, but it should also work on any of the following platforms:

  • .NET Framework 4.6
  • .NET Core 1.0
  • Mono 4.6
  • Xamarin.iOS 10.0
  • Xamarin.Mac 3.0
  • Xamarin.Android 7.0
  • Universal Windows Platform 10.0

Code of Conduct

We abide by the Contributor Covenant and ask that you do as well.

For more information, please see CODE_OF_CONDUCT.md.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/miscreant/miscreant

Copyright

Copyright (c) 2017-2018 The Miscreant Developers. See LICENSE.txt for further details.

You can’t perform that action at this time.