Kryptor Changelog

What's new in Kryptor 4.1.0

May 27, 2023
  • Added:
  • Support for changing a private key passphrase via -m|--modify.
  • Support for a comment after a public/private key string in .public/.private files, either manually by opening such files in a text editor or by specifying -c|--comment during key pair generation. Note that these comments are not authenticated in any way.
  • Changed:
  • The -a|--about option has been replaced with --version to align with other tools.
  • There's no longer a new line before output to the terminal.
  • Bad signature now has an exit code of -1.
  • Errors should be written to stderr.
  • Updated dependencies/.NET.
  • Removed:
  • The -u|--update option to align with other tools. Just use a package manager.

New in Kryptor 4.0.1 (Jan 29, 2023)

  • Removed:
  • Support for v1 private and public keys. Please see the v4.0.0 release for more information.
  • The dependencies for v1 key pairs.
  • Changed:
  • 'Password' has been renamed to 'passphrase'. The option is now -p|--passphrase.
  • Random passphrases are now lowercase to allow easy typing.
  • The public/private key file length checks have been moved.
  • Various error messages have been shortened/rephrased.
  • Updated dependencies and the .NET SDK/runtime.
  • Fixed:
  • InsufficientMemoryException if you don't have enough memory to use Argon2.

New in Kryptor 4.0.0 (Sep 20, 2022)

  • Warning:
  • This release contains many breaking changes. If you're updating from a previous version of Kryptor, please decrypt all of your files using your current version.
  • After many hours and much indecision, the next major version of Kryptor is here. It's not perfect; there are still a few things I'm not entirely happy about. However, it's definitely an improvement on v3. I just hope I haven't missed anything, and please bear with me whilst I update the website.
  • Deprecated:
  • Support for the previous private key format will be removed in a future release. The format is automatically updated when you use your private key for the first time.
  • Similarly, support for the previous public key format will be removed in a future release. Again, the format is automatically updated when your private key is. Alternatively, you can use -r|--recover.
  • Note:
  • You should republish/share your new public key string/file in place of the old one and backup your new private key file. However, your key pair doesn't actually change. The private key gets re-encrypted, and the public key has a different header, so the string looks different.
  • Added:
  • The new encryption format is intended to be indistinguishable from random to limit metadata. This means no identifiable headers and randomised padding. Few tools do this (e.g. age doesn't care about metadata). A huge thanks to Monocypher for Elligator2 and Covert Encryption for inspiration and their randomised padding scheme.
  • Directories are now converted into ZIP files (with no compression for speed) before being encrypted. This means an encrypted directory is indistinguishable from an encrypted file.
  • You can now specify up to 20 public key recipients for a single file. It used to be limited to 1 recipient.
  • Support for pre-shared keys has been added to provide optional post-quantum security when encrypting a file to someone's public key.
  • Pre-shared keys can also be used for file encryption alone like keyfiles. This is a faster alternative to password-based encryption.
  • Some of the encrypted metadata header is currently empty, which will eventually be used for storing the file timestamps and cross-platform attributes. The timestamps of the encrypted file can then be altered to further limit metadata. This all needs more thought and some study of digital forensics though.
  • You can now sign each file in a directory. This is handy for signing software releases quickly.
  • Multiple signatures can now be verified at once.
  • Multiple custom signature paths can be specified at once for signing.
  • Key pairs can be generated non-interactively.
  • macOS ARM64 and Linux ARM64 are now officially supported and can be updated using -u|--update.
  • A -1 exit code is returned when an error occurs.
  • Changed:
  • Switched from XChaCha20-BLAKE2b to ChaCha20-Poly1305 for encryption. It's faster and standardised. The padding fix is applied when encrypting the metadata header to add key commitment.
  • Now using a little-endian counter nonce and the STREAM construction. A random nonce is unnecessary in this use case, especially since it was being incremented for each chunk before anyway. Then the STREAM construction has become unofficially standardised and is more flexible.
  • The Argon2 parameters have been reduced as they were excessive and much slower than I thought on other machines. This speeds up password-based key derivation whilst retaining a good security margin.
  • Passwords are no longer prehashed. This was done previously for consistency with how peppering was done.
  • The pepper is now used as input keying material for key derivation after password hashing instead of being used as a key prior to password hashing. This was done to save an extra call to BLAKE2b.
  • Using a keyfile alone no longer uses Argon2 as random keyfiles are high in entropy.
  • Keyfile hashing has been made compatible with the pre-shared key format, and random keyfiles are now 32 bytes in size instead of 64 bytes.
  • The previous authentication tag is no longer used as associated data. This was unnecessary and came with a performance cost.
  • Both public keys are included in the key derivation for shared secrets.
  • The long-term and ephemeral shared secrets are concatenated the other way around to comply with the Noise Protocol Framework.
  • The ephemeral public key is used as info in the wrap key derivation instead of being used as associated data. With passwords/pre-shared keys, this is actually an additional 256-bit random salt since no public key is used.
  • The encrypted metadata header has been rearranged. The file length is now stored instead of the amount of padding. The file name is also stored there and padded to 256 bytes.
  • Private keys are now encrypted using ChaCha20-Poly1305 with the padding fix for key commitment and an all zero nonce since the key is unique.
  • The public/private key headers have been changed to make the algorithm readable at the beginning of the string (Cu// for Curve25519 and Ed// for Ed25519).
  • Geralt, my libsodium binding, is now used instead of libsodium-core.
  • Thanks to Geralt, spans are used instead of byte arrays when possible for improved performance and fewer allocations.
  • Sensitive bytes are pinned when possible/sensible so they can be zeroed properly.
  • FileStream performance should be improved as the buffer size is now adjusted based on the size of the file and output files are preallocated on disk.
  • Random file name generation has been improved due to Geralt.
  • File names are checked for invalid characters to prevent problems storing the file name/decrypting cross-platform.
  • libsodium is used for Base64 encoding, which is done in constant time.
  • Lots of wrapper classes have been removed due to Geralt.
  • It's now clearer when you're being asked for a private key password compared to a regular password.
  • 'Directory' is used instead of 'folder' in messages.
  • Some error messages have been made more consistent.
  • Blue is no longer used for any messages; orange (technically 'dark yellow') is used instead.
  • The initial validation has been improved.
  • Code has been spaced out for readability, Geralt constants are used, and the if/loop braces style has been changed.
  • Fixed:
  • Early returns when an exception was thrown during decryption, potentially preventing some files from being processed.
  • An empty file name in error messages when the path ends in a directory/volume separator character.
  • An unhandled directory UnauthorizedAccessException during empty directory validation.
  • 'name (2)' getting restored to 'name (3)' instead of 'name (2) (2)' if 'name (2)' exists decrypting a file that had its name encrypted. I don't like this numbering, but it's the safest approach I can come up with.
  • Removing double digit file name numbers (e.g. 'name (10)').
  • The resources are now embedded when building as well as publishing.
  • The publish profiles for ARM64.
  • Probably some other stuff I've neglected to mention.

New in Kryptor 3.1.1 (Apr 25, 2022)

  • Fixed:
  • Files with a certain length would accidentally have the last 16,384 byte chunk removed during decryption due to a mathematical mistake that wasn't detected during any of my testing because of the file sizes of my test files. I'm extremely sorry for any trouble this causes. It's rather crushing as a maintainer when something like this happens, but I would like to again thank the person who reported this issue.
  • Chocolatey installs hopefully won't have a vcruntime140.dll extraction error anymore. I'm also working on adding the package equivalent of this file as a dependency.
  • Changed:
  • Encrypted files are no longer deleted by default when decrypting. The -o|--overwrite option now needs to be specified to do this.
  • Illegal characters from file/directory names are now rejected with an error rather than being silently removed. As this was taken from a v4 commit, with v4 encrypting directories differently, this change won't work with subdirectories.
  • 'Decrypting private key...' is displayed instead of 'Deriving encryption key from password...' for private key decryption to avoid confusion.
  • The dependencies and vcruntime140.dll files have been updated.
  • Added:
  • A message saying to back up the private key file when generating a new key pair.
  • A message saying to back up the keyfile when generating a random keyfile.
  • Publish profiles have been added for Linux ARM64 and macOS ARM64 to build from source more easily. Builds for these platforms may be included in releases for v4 onwards.

New in Kryptor 3.1.0 (Jan 3, 2022)

  • Added:
  • Non-interactive password support, meaning you can now do -p:"[password]" instead of entering the password interactively. To randomly generate a password, you can type a space: -p:" ". However, entering a password interactively is still more secure as it hides your password and avoids using a string variable.
  • Exporting the recovered public key from -r|--recover to a .public file if one does not exist in the same directory as the .private key file.
  • Automatic vcruntime140.dll extraction on Windows to always ensure that the libsodium cryptographic library is portable.
  • -u|--update can now install updates for you. This checks the download signatures automatically, ensuring authenticity and integrity, and replaces the kryptor executable in place.
  • Coloured error messages (red) and successful messages (green). Blue and orange are also used but rarely.
  • A note in -h|--help about having to surround file names/paths with "speech marks".
  • Changed:
  • Switched to .NET 6.
  • The -f|--obfuscate option has been renamed to -n|--names. I will now be calling it file name encryption rather than file name obfuscation.
  • Path.GetRandomFileName() is no longer being used because the documentation was updated to remove the claim that it is cryptographically secure.
  • It is now possible to sign .signature files.
  • The spacing in the output text has been changed to try and make things more readable.
  • File names in the output text are now surrounded by "speech marks" to help distinguish them from other text.
  • Fixed:
  • The authenticated comment is no longer shown if it is empty when verifying a signature.
  • Folders containing only empty subdirectories are now detected as containing no files, leading to an error.
  • String.Replace() is no longer used for file paths since it may cause problems by removing multiple parts of a string.
  • Illegal file name characters are now removed from the file name before it is stored during file name encryption because this could cause issues decrypting the file on another operating system. This may be switched to an error in the future.
  • The total count should now be correct when decrypting a directory with an incorrect salt length.
  • Lots of code improvements to reduce the line count.
  • Various error messages have been improved.

New in Kryptor 3.0.4 (Sep 30, 2021)

  • Fixed a bug when encrypting/decrypting 0 byte files (please see #27).
  • Fixed a bug related to renaming duplicated files (please see #28).
  • Added a 'Deriving encryption key from the password...' message to explain the key derivation delay.
  • Added 'Encrypting [file] => [file.kryptor]...' and 'Decrypting [file.kryptor] => [file]...' messages to indicate that Kryptor is doing something rather than frozen when encrypting/decrypting large files.
  • Added 'Commencing encryption of [directory] directory...' and 'Commencing decryption of [directory] directory...' messages to help separate the folder encryption output from the file encryption output.
  • Now displaying the name of randomly generated keyfiles.
  • The -s|--sign and -v|--verify validation has been improved.
  • Fixed an UnauthorizedAccessException when trying to randomly generate a keyfile to a path where a keyfile by that name already exists.
  • Various code improvements, although there's still lots to go through. More code improvements will be coming in the next release.

New in Kryptor 3.0.3 (Jul 5, 2021)

  • Validation for file paths now happens before being asked to enter a password.
  • Added empty directory validation.
  • Added a validation check for a salt file when encrypting directories.
  • Added a validation check for a salt file when decrypting directories using a private key.
  • The total number of files count is no longer reduced when a file is invalid (e.g. already encrypted).​
  • Removed error logging. It is not needed, and the log file never got shared in bug reports.
  • Added a private key encryption example to -h|--help to clarify that you do not need to specify your public key when encrypting files for yourself.
  • Simplified the examples in -h|--help.
  • Reworded several error messages.

New in Kryptor 3.0.2 Beta (Mar 19, 2021)

  • Fixed the UnauthorizedAccessException when overwriting read-only files.
  • Fixed the UnauthorizedAccessException when storing the file name if the file was read-only.
  • Now restoring the -o|--overwrite setting if an exception occurs during directory encryption.
  • Now displaying the name of the copied/backup directory when encrypting a directory without the -o|--overwrite option.
  • Now renaming the copied/backup directory to the original directory name if possible (if -f|--obfuscate is specified and -o|--overwrite is not). The directory can't be renamed otherwise because two directories cannot have the same path.

New in Kryptor 3.0.1 Beta (Mar 15, 2021)

  • Now including the vcruntime140.dll file in the Windows release so the application is portable without the Visual C++ runtime installed. I forgot to include this in v3.0.0 Beta
  • Minor changes to -a|--about.

New in Kryptor 3.0.0 Beta (Mar 6, 2021)

  • Chunked AEAD for encryption.
  • New KEK/DEK design.
  • File signing.
  • Fixed Argon2 parameters.
  • Faster directory encryption.
  • Authenticated hybrid file encryption.
  • Masked password entry with support for random passphrase generation.
  • Separate encryption and signing asymmetric keys.
  • Private key encryption.
  • Export asymmetric key pairs.
  • Code improvements due to a rewrite.
  • New GitBook documentation.
  • No longer working on a GUI version - not enough time to work on two different versions, tricky to implement in a GUI format, not cross-platform, and more confusing for the user downloading the software. More detail can be found here.

New in Kryptor 2.2.2 Beta (Dec 23, 2020)

  • IMPORTANT: Previous versions of Kryptor contain a severe nonce reuse security vulnerability. Please decrypt your files with the previous version before updating. This release contains breaking changes.
  • This release was not planned and has been rushed, but I discovered this vulnerability yesterday when developing v3.0.0 Beta, and it needed to be fixed as soon as possible. It's a classic case of knowing good practices but failing to implement them correctly. I sincerely apologise for its existence and not spotting it sooner. It's existed ever since the program was released, which is why it went unnoticed. The good news is that it has now been patched, and I will be extra cautious with future versions.
  • V3.0.0 Beta Update:
  • Life is pretty chaotic right now, but I've been spending several hours a day working on v3.0.0 Beta, which will be the next version - planned to be released in January, but I won't make any promises as I keep getting busier and need a break. I merged v2.3.0 Beta with v3 because there were so many changes. I've done a lot on the CLI version, but I'm currently unsure about the file structure (e.g. the file headers) and haven't finalised the faster folder encryption, etc. Unfortunately, v3 will also contain lots of breaking changes, but hopefully things will settle down after that.
  • Changelog:
  • Fixed nonce reuse vulnerability. Switched to a counter instead of a random nonce.
  • Now only supporting XChaCha20 for file encryption.
  • No longer using associated data to hash the password since there's only one encryption algorithm.
  • Removed Shred Files feature.
  • Minor code improvements.
  • Minor changes to CLI --help.
  • Updated website URLs to lowercase.

New in Kryptor 2.2.1 Beta (Dec 4, 2020)

  • KryptorCLI:
  • Fixed System.OverflowException when trying to encrypt large files.
  • Fixed --update command. This was due to an issue with .NET Core publishing.
  • Added hidden --error-log command to allow the user to access their error log when reporting a bug on GitHub.
  • KryptorGUI:
  • One minor code improvement - changed Argon2 benchmark parameter from bool to int.

New in Kryptor 2.2.0 Beta (Nov 14, 2020)

  • Now using the CommandLineUtils library by Nate McMaster.
  • Added a custom --help text.
  • Rearranged some code.
  • Converted some global variables to local variables.
  • Updated GitHub links because of the username change.
  • Added random passphrase generation if no password or keyfile is specified.
  • Removed first run benchmark and automatic updates.
  • Fixed opening links on Windows.

New in Kryptor 2.1.1 Beta (Oct 11, 2020)

  • Fixed a timer issue that caused inaccurate times for the first memory size in the benchmark and the 'Test Parameters' button in settings.

New in Kryptor 2.1.0 Beta (Oct 5, 2020)

  • Cryptography:
  • Now one key is generated using Argon2 and split into two keys rather than calling Argon2 twice. This is a security improvement and makes key derivation faster. Thank you to Lynn Stephenson, who brought this issue to my attention; it was something I managed to overlook.
  • Argon2 Benchmark:
  • The benchmark now starts at 50 MiB instead of 10 MiB.
  • The benchmark goes up to 300 MiB instead of 250 MiB.
  • Settings:
  • The minimum memory size for Argon2 has been changed from 10 MiB to 32 MiB in settings.
  • The maximum memory size has been changed from 300 MiB to 500 MiB in settings.
  • The maximum number of iterations has been changed from 100 to 128 in settings.
  • The default memory size for Argon2 is now 128 MiB instead of 100 MiB. This only applies if the benchmark doesn't run. This should produce a delay of between 150-250 ms per file on most machines.
  • Code Improvements:
  • Fixed CodeFactor issues from version 2.0.0 Beta.
  • Fixed all of the subroutine naming warnings.