Skip to content
Go implementation of the Data At Rest Encryption (DARE) format.
Go
Branch: master
Clone or download
aead and harshavardhana add `DecryptReaderAt` implementation (#36)
This commit adds a `ReaderAt` implementation that
allows decrypting a data using random access patterns.

With `DecryptReaderAt` it is possible to decrypt an `io.ReaderAt`
and reading from arbitrary (plaintext) offsets.
Latest commit a3e7c36 Oct 9, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd/ncrypt ncrypt: add missinsg help field in package documentation (#33) Jan 18, 2019
.travis.yml add `DecryptReaderAt` implementation (#36) Oct 8, 2019
DARE.md add sequence number increment in decrypt Aug 25, 2017
LICENSE initial commit - add basic protocol implementation Aug 18, 2017
README.md add CLI tool ncrypt (#11) Sep 19, 2017
dare.go Implement DARE 2.0 (#20) Mar 1, 2018
dare_test.go Implement DARE 2.0 (#20) Mar 1, 2018
examples_test.go add an error type representing decryption failure (#25) Mar 27, 2018
generic.go add `DecryptReaderAt` implementation (#36) Oct 8, 2019
go.mod add `DecryptReaderAt` implementation (#36) Oct 8, 2019
go.sum add `DecryptReaderAt` implementation (#36) Oct 8, 2019
reader-v1.go
reader-v2.go add `DecryptReaderAt` implementation (#36) Oct 8, 2019
sio.go add `DecryptReaderAt` implementation (#36) Oct 8, 2019
sio_test.go add `DecryptReaderAt` implementation (#36) Oct 8, 2019
writer-v1.go fix wrong spelling (#21) Mar 7, 2018
writer-v2.go add an error type representing decryption failure (#25) Mar 27, 2018

README.md

Godoc Reference Travis CI Go Report Card

Secure IO

Go implementation of the Data At Rest Encryption (DARE) format.

Introduction

It is a common problem to store data securely - especially on untrusted remote storage. One solution to this problem is cryptography. Before data is stored it is encrypted to ensure that the data is confidential. Unfortunately encrypting data is not enough to prevent more sophisticated attacks. Anyone who has access to the stored data can try to manipulate the data - even if the data is encrypted.

To prevent these kinds of attacks the data must be encrypted in a tamper-resistant way. This means an attacker should not be able to:

  • Read the stored data - this is achieved by modern encryption algorithms.
  • Modify the data by changing parts of the encrypted data.
  • Rearrange or reorder parts of the encrypted data.

Authenticated encryption schemes (AE) - like AES-GCM or ChaCha20-Poly1305 - encrypt and authenticate data. Any modification to the encrypted data (ciphertext) is detected while decrypting the data. But even an AE scheme alone is not sufficiently enough to prevent all kinds of data manipulation.

All modern AE schemes produce an authentication tag which is verified after the ciphertext is decrypted. If a large amount of data is decrypted it is not always possible to buffer all decrypted data until the authentication tag is verified. Returning unauthenticated data has the same issues like encrypting data without authentication.

Splitting the data into small chunks fixes the problem of deferred authentication checks but introduces a new one. The chunks can be reordered - e.g. exchanging chunk 1 and 2 - because every chunk is encrypted separately. Therefore the order of the chunks must be encoded somehow into the chunks itself to be able to detect rearranging any number of chunks.

This project specifies a format for en/decrypting an arbitrary data stream and gives some recommendations about how to use and implement data at rest encryption (DARE). Additionally this project provides a reference implementation in Go.

Applications

DARE is designed with simplicity and efficiency in mind. It combines modern AE schemes with a very simple reorder protection mechanism to build a tamper-resistant encryption scheme. DARE can be used to encrypt files, backups and even large object storage systems.

Its main properties are:

  • Security and high performance by relying on modern AEAD ciphers
  • Small overhead - encryption increases the amount of data by ~0.05%
  • Support for long data streams - up to 256 TB under the same key
  • Random access - arbitrary sequences / ranges can be decrypted independently

Install: go get -u github.com/minio/sio

DARE and github.com/minio/sio are finalized and can be used in production.

We also provide a CLI tool to en/decrypt arbitrary data streams directly from your command line:

Install ncrypt: go get -u github.com/minio/sio/cmd/ncrypt && ncrypt -h

Performance

Cipher 8 KB 64 KB 512 KB 1 MB
AES_256_GCM 90 MB/s 1.96 GB/s 2.64 GB/s 2.83 GB/s
CHACHA20_POLY1305 97 MB/s 1.23 GB/s 1.54 GB/s 1.57 GB/s

On i7-6500U 2 x 2.5 GHz | Linux 4.10.0-32-generic | Go 1.8.3 | AES-NI & AVX2

You can’t perform that action at this time.