rage v0.11.2

Changed

• Recipient and identity files are now limited to at most 16 MiB, and SSH keys are now limited to at most 16 kiB, matching the Go implementation.

Fixed

• Plugin encryption and decryption no longer panic when a plugin sends certain invalid responses.
• Decryption with an encrypted SSH key no longer panics when given an empty passphrase.

rage v0.11.1

Security

Fixed a security vulnerability that could allow an attacker to execute an arbitrary binary under certain conditions. See GHSA-4fg7-vxc8-qx5w. Plugin names are now required to only contain alphanumeric characters or the four special characters +-._. Thanks to ⬡-49016 for reporting this issue.

rage v0.10.1

Security

Backport of the fix for GHSA-4fg7-vxc8-qx5w.

rage v0.9.3

Security

Backport of the fix for GHSA-4fg7-vxc8-qx5w.

rage v0.11.0

rage

Added

• Partial French translation!

Fixed

• [Unix] Files can now be encrypted with rage --passphrase when piped over stdin, without requiring an explicit - argument as INPUT.

age

Added

• New streamlined APIs for use with a single recipient or identity and a small amount of data (that can fit entirely in memory):
  • age::encrypt
  • age::encrypt_and_armor
  • age::decrypt
• age::Decryptor::{decrypt, decrypt_async, is_scrypt}
• age::IdentityFile::to_recipients
• age::IdentityFile::with_callbacks
• age::IdentityFile::write_recipients_file
• age::IdentityFileConvertError
• age::NoCallbacks
• age::scrypt, providing recipient and identity types for passphrase-based encryption.
• Partial French translation!

Changed

• Migrated to i18n-embed 0.15, secrecy 0.10.
• age::Encryptor::with_recipients now takes recipients by reference instead of by value. This aligns it with age::Decryptor (which takes identities by reference), and also means that errors with recipients are reported earlier. This causes the following changes to the API:
  • Encryptor::with_recipients takes impl Iterator<Item = &'a dyn Recipient> instead of Vec<Box<dyn Recipient + Send>>.
  • Verification of recipients and generation of stanzas now happens in Encryptor::with_recipients instead of Encryptor::wrap_output and Encryptor::wrap_async_output.
  • Encryptor::with_recipients returns Result<Self, EncryptError> instead of Option<Self>, and Encryptor::{wrap_output, wrap_async_output} return io::Result<StreamWriter<W>> instead of Result<StreamWriter<W>, EncryptError>.
  • age::EncryptError has a new variant MissingRecipients, taking the place of the None that Encryptor::with_recipients could previously return.
• age::Decryptor is now an opaque struct instead of an enum with Recipients and Passphrase variants.
• age::IdentityFile now has a C: Callbacks generic parameter, which defaults to NoCallbacks.
• age::IdentityFile::into_identities now returns Result<Vec<Box<dyn crate::Identity>>, DecryptError> instead of Vec<IdentityFileEntry>.
• age::Recipient::wrap_file_key now returns (Vec<Stanza>, HashSet<String>): a tuple of the stanzas to be placed in an age file header, and labels that constrain how the stanzas may be combined with those from other recipients.
• age::plugin::RecipientPluginV1 now supports the labels extension.

Fixed

• age::cli_common::read_identities once again correctly parses identity files that are a single line without a trailing newline. This broke in 0.10.0 due to an unrelated refactor.

Removed

• age::decryptor::PassphraseDecryptor (use age::Decryptor with age::scrypt::Identity instead).
• age::decryptor::RecipientsDecryptor (use age::Decryptor instead).
• age::IdentityFileEntry

age-plugin 0.6.0

Added

• age_plugin::PluginHandler
• impl age_plugin::identity::IdentityPluginV1 for std::convert::Infallible
• impl age_plugin::recipient::RecipientPluginV1 for std::convert::Infallible

Changed

• Migrated to age-core 0.11.
• age_plugin::recipient::RecipientPluginV1 has a new labels method. Existing implementations of the trait should either return HashSet::new() to maintain existing compatibility, or return labels that apply the desired constraints.
• age_plugin::run_state_machine now supports the recipient-v1 labels extension.

Fixed

• age_plugin::run_state_machine now takes an impl age_plugin::PluginHandler argument, instead of its previous arguments.
  • This fixes the change from the previous release, because the type parameters were basically impossible to set correctly when attempting to pass None.

age-core

Added

• age_core::format:
  • FileKey::new
  • FileKey::init_with_mut
  • FileKey::try_init_with_mut
  • is_arbitrary_string

Changed

• Migrated to secrecy 0.10.
• age::plugin::Connection::unidir_receive now takes an additional argument to enable handling an optional fourth command.

New Contributors

• @AnomalRoil made their first contribution in #499
• @pavelzw made their first contribution in #492
• @BoostCookie made their first contribution in #513

Full Changelog: v0.10.0...v0.11.0

rage v0.10.0

rage

Added

• Russian translation!
• rage-keygen -y IDENTITY_FILE to convert identity files to recipients.
• Elvish completions to the Debian package. These are not automatically discovered; Elvish users will need to manually import them.
• Localized manpages to the Debian package.

Changed

• MSRV is now 1.65.0.
• Migrated from gumdrop to clap for argument parsing.
• -R/--recipients-file and -i/--identity now support "read-once" files, like those used by process substitution (-i <(other_binary get-age-identity)) and named pipes.
• The filename - (hyphen) is now treated as an explicit request to read from standard input when used with -R/--recipients-file or -i/--identity. It must only occur once across the -R/--recipients-file and -i/--identity flags, and the input file. It cannot be used if the input file is omitted.

Fixed

• OpenSSH private keys passed to -i/--identity that contain invalid public keys are no longer ignored when encrypting, and instead cause an error.
• Weak ssh-rsa public keys that are smaller than 2048 bits are now rejected.
• rage-keygen no longer overwrites existing key files with the -o/--output flag. This was its behaviour prior to 0.6.0, but was unintentionally changed when rage was modified to overwrite existing files. Key file overwriting can still be achieved by omitting -o/--output and instead piping stdout to the file.
• rage-keygen now prints fatal errors directly instead of them being hidden behind the RUST_LOG=error environment variable. It also now sets its return code appropriately instead of always returning 0.
• The Debian package now uses the correct installation paths for fish and Zsh completions.

age

Added

• Russian translation!
• age::cli_common:
  • file_io:
    • FileReader
    • impl Debug for {LazyFile, OutputFormat, OutputWriter, StdoutWriter}
  • StdinGuard
  • read_recipients
• age::identity::IdentityFile::from_input_reader (behind cli-common feature flag).
• impl Eq for age::ssh::{ParseRecipientKeyError, UnsupportedKey}
• impl {Debug, PartialEq, Eq, Hash} for age::x25519::Recipient

Changed

• MSRV is now 1.65.0.
• Migrated to base64 0.21, rsa 0.9.
• age::cli_common:
  • file_io:
    • InputReader::File enum variant now contains FileReader instead of std::fs::File.
    • OutputWriter::new now takes an allow_overwrite boolean argument. If OutputWriter will write to a file, this boolean enables the caller to control whether the file will be overwritten if it exists (instead of the implicit behaviour that was previously changed in 0.6.0).
  • read_identities now takes an &mut StdinGuard argument, and filenames may now contain at most one entry of "-", which will be interpreted as reading from standard input.
  • ReadError has new variants:
    • EncryptedIdentities
    • InvalidRecipient
    • InvalidRecipientsFile
    • MissingRecipientsFile
    • MultipleStdin
    • RsaModulusTooLarge
    • RsaModulusTooSmall
• age::ssh:
  • ParseRecipientKeyError has new variants:
    • RsaModulusTooLarge
    • RsaModulusTooSmall
  • The following trait implementations now return Err(ParseRecipientKeyError::RsaModulusTooLarge) instead of Err(ParseRecipientKeyError::Unsupported(_)) when encountering an RSA public key with a modulus larger than 4096 bits:
    • impl FromStr for Recipient
    • impl TryFrom<Identity> for Recipient

Fixed

• age::Encryptor::with_user_passphrase will now re-measure the scrypt work factor until it is measurable, instead of setting the work factor to maximum.
• age::cli_common:
  • UiCallbacks::confirm no longer requires erasing the confirmation message before it will accept a response.
  • UiCallbacks::request_public_string no longer prepends the description to the response string.
• Weak ssh-rsa public keys that are smaller than 2048 bits are now rejected from all string-parsing APIs. The Recipient::SshRsa enum variant can still be manually constructed with such keys; this will be fixed in a future crate refactor.

age-plugin 0.5.0

Changed

• MSRV is now 1.65.0.
• Migrated to age-core 0.10.
• age_plugin::run_state_machine now takes optional arguments, to enable the creation of recipient-only or identity-only plugins.

age-core

Added

• impl Eq for age_core::format::Stanza

Changed

• MSRV is now 1.65.0.

New Contributors

• @WesleyAC made their first contribution in #400
• @thibmeu made their first contribution in #406
• @gibbz00 made their first contribution in #420
• @ehaupt made their first contribution in #467
• @hexanova made their first contribution in #471

Full Changelog: v0.9.2...v0.10.0

rage v0.9.2

rage

Changed

• Increased parsing speed of age file headers. For single-recipient encrypted decryption throughput increases by 6% for medium (< 1MiB) files, and 40% for small (< 10kiB) files.
• The pinentry binary used to request passphrases can now be set manually with PINENTRY_PROGRAM environment variable. It accepts either a binary name a path. Setting this to the empty string will disable pinentry usage and back to the CLI interface.
• Linux release binaries are now built using Ubuntu 20.04.

age

Added

• age::Decryptor::{new_buffered, new_async_buffered}, which are more efficient types implementing std::io::BufRead or futures::io::AsyncBufRead includes &[u8] slices).
• impl std::io::BufRead for age::armor::ArmoredReader
• impl futures::io::AsyncBufRead for age::armor::ArmoredReader

Changed

• The pinentry binary used by age::cli_common::read_secret can now be set with the PINENTRY_PROGRAM environment variable. It accepts either a name or a path. Setting this to the empty string will disable pinentry and fall back to the CLI interface.

Fixed

• The AsyncWrite::poll_write implementation for age::stream::StreamWriter never returns 0 if there is data to write. This makes StreamWriter with futures::io::copy.

rage v0.9.1

rage

Added

• Support for encrypted OpenSSH keys exported from 1Password.

age

Added

• Support for encrypted OpenSSH keys exported from 1Password.

rage v0.9.0

rage

Changed

• MSRV is now 1.59.0.

Fixed

• Encryption now returns an error if the file would be encrypted to no recipients. This can occur if only -R/--recipients-file flags are provided, and they all point to files that contain only "#" prefixed comments and empty lines.

age

Added

• age::armor::ArmoredReadError, used to wrap armor-specific read errors inside std::io::Error.
• age::ssh:
  • impl Clone for Identity

Changed

• MSRV is now 1.59.0.
• age::Encryptor::with_recipients now returns Option<Encryptor>, with None returned if the provided list of recipients is empty (to prevent files being encrypted to no recipients). The recipients argument is also now Vec<Box<dyn age::Recipient + Send>>.
• age::encrypted::Identity::recipients now returns Vec<Box<dyn age::Recipient + Send>>.

Fixed

• age::Decryptor now rejects invalid or non-canonical scrypt recipient stanzas (instead of ignoring or accepting them respectively), matching the age specification.
• age::armor::ArmoredReader:
  • It now correctly implements strict parsing as defined in RFC 7468, and rejects armored files with non-canonical final lines (where padding bytes are omitted).
  • It now rejects armored files with non-whitespace characters after the end marker.
  • It now accepts armored files with no newline after the end marker. Previously these were rejected by the synchronous API, and would cause the async API to hang.
  • The async API now correctly rejects some classes of invalid armoring that previously would cause it to hang.

age-plugin 0.4.0

Changed

• MSRV is now 1.59.0.
• Migrated to age-core 0.9.

age-core

Changed

• MSRV is now 1.59.0.
• Migrated to aead 0.5.

rage v0.8.1

rage

Security

• Require age 0.8.1.

age

Security

• age::Decryptor did not previously require "contributory" behaviour for X25519 recipient stanzas. If an age file has an X25519 recipient stanza with an ephemeral share that is a small-order point, the file could previously be decrypted by any native age identity. To ensure we match the behaviour in the age specification, these files are now rejected as invalid.

Fixed

• age::Decryptor now rejects invalid or non-canonical X25519 recipient stanzas (instead of ignoring or accepting them respectively), matching the age specification.