Skip to main content

durable_queue_encryption 1.1.0 copy "durable_queue_encryption: ^1.1.0" to clipboard
durable_queue_encryption: ^1.1.0 copied to clipboard

Encrypts durable_queue task payloads and error messages at rest with AES-256-GCM. Wraps any storage, including SQLite.

1.1.0 #

  • A task that cannot be decrypted no longer stops the queue. Before, the queue retried reading it forever, so a lost key or one changed record stopped every task behind it.
    • getNextReady sets such a task aside: it is held, with its encrypted data unchanged, and tasksSetAside reports it.
    • get returns null for it, and the lists and findActiveByDeduplicationKey skip it, instead of throwing PayloadDecryptionException. A limited getByStatus still returns up to its limit of readable tasks.
  • recoveredTaskIds(): the tasks that were set aside and can be read again, for example after the key was restored, to release with DurableQueue.release.
  • Forwards queue state (QueueStateStorage, such as rate limits) to the wrapped storage, encrypted like the tasks. State that cannot be decrypted reads as none, so the queue starts it empty.
  • Requires durable_queue 1.1.0 or later.

1.0.0 #

  • First stable release, for durable_queue 1.0. No API changes from 0.1.2; breaking changes now wait for 2.0.

0.1.2 #

  • Encrypts the failure history (StoredTask.failures, from DurableQueue(failureHistory:)) like the last failure: each stored error reads [encrypted], and the originals are restored on read.
  • Requires durable_queue 0.5.11 or later.

0.1.1 #

  • Passes QueueStorageCallGuard checks on to the wrapped storage, so durable_queue_drift still refuses calls made inside a drift transaction when it is encrypted.
  • Requires durable_queue 0.5.10 or later.

0.1.0 #

  • Initial release.
  • EncryptedQueueStorage: wraps any QueueStorage and encrypts each task's payload and last error message and stack trace, with the task id as associated data. Deduplication keys and groups are stored as HMAC-SHA256 tags for lookups and restored on read (protectLookupKeys, on by default).
  • AesGcmCipher: AES-256-GCM with a random nonce per write, subkeys derived with HMAC-SHA256, generateKey(), and key rotation through previousKeys.
  • PayloadCipher: the interface for other ciphers.
  • Tasks stored before encryption are still read (readPlaintext); reencryptAll() encrypts them, or moves every task to a new key.
  • PayloadDecryptionException for records that cannot be decrypted, and unreadableTaskIds() to find them after a key is lost.
  • Tested with the shared storage contract over memory and SQLite storage, and against data encrypted by an independent AES-GCM implementation.
0
likes
160
points
1.23k
downloads

Documentation

API reference

Publisher

verified publisherboffincoders.com

Weekly Downloads

Encrypts durable_queue task payloads and error messages at rest with AES-256-GCM. Wraps any storage, including SQLite.

Repository (GitHub)
View/report issues
Contributing

Topics

#queue #encryption #security #offline #persistence

License

MIT (license)

Dependencies

crypto, cryptography, durable_queue

More

Packages that depend on durable_queue_encryption