High Level Encryption Wrappers
Encryption wrappers, using low-level support from
'sodium' and 'openssl'. 'cyphr' tries to smooth over some pain
points when using encryption within applications and data analysis
by wrapping around differences in function names and arguments in
different encryption providing packages. It also provides
high-level wrappers for input/output functions for seamlessly
adding encryption to existing analyses.
High-level functions for supporting encryption and decryption of data from R. This allows secure storage and exchange of information, while trying to keep the encryption/decryption code from taking over your analyses.
cyphr wraps the lower-level support from
openssl. This package is designed to be easy to use, rather than the most secure thing (you're using R, remember - for examples of what
cyphr can't protect against see
cyphr provides high level functions to:
- Encrypt and decrypt
- raw data:
- User-friendly wrappers (
decrypt) around R's file reading and writing functions that enable transparent encryption (support included for
The package aims to make encrypting and decrypting as easy as
cyphr::encrypt(save.csv(dat, "file.csv"), key)
dat <- cyphr::decrypt(read.csv("file.csv", stringsAsFactors = FALSE), key)
In addition, the package implements a workflow that allows a group to securely share data by encrypting it with a shared ("symmetric") key that is in turn encrypted with each users ssh keys. The use case is a group of researchers who are collaborating on a dataset that cannot be made public, for example containing sensitive data. However, they have decided or need to store it in a setting that they are not 100% confident about the security of the data. So encrypt the data at each read/write.
cyphr from CRAN with
To install a development version from github, you can use
cyphr from github:
remotes::install_github("ropensci/cyphr", upgrade = FALSE)
The scope of the package is to protect data that has been saved to disk. It is not designed to stop an attacker targeting the R process itself to determine the contents of sensitive data. The package does try to prevent you accidentally saving to disk the contents of sensitive information, including the keys that could decrypt such information.
Objects to handle keys:
Decide on a style of encryption and create a key object
key_sodium: Symmetric encryption, using sodium -- everyone shares the same key (which must be kept secret!) and can encrypt and decrypt data with it. This is used as a building block but is inflexible because of the need to keep the key secret.
key_openssl: Symmetric encryption using openssl
keypair_sodium: Public key encryption with sodium -- this lets people encrypt messages using your public key that only you can read using your private key.
keypair_openssl: Public key encryption, using openssl, which has the big advantage that many people already have compatible (ssh) keys in standard places with standard file formats (see
?encrypt_envelopein the the
cyphr does not include wrappers for key generation for sodium - sodium keys do not have a file format: So a secret symmetric key in
sodium might be:
k <- sodium::keygen() k
##  84 83 64 a2 3c 10 e6 9f 22 8b bc cd 48 81 0f 71 a0 4b 28 57 e3 40 c4 ##  b7 ab 3e 00 f1 fd ff ee c8
With this key we can create the
key <- cyphr::key_sodium(k) key
## <cyphr_key: sodium>
If the key was saved to file that would work too:
If you load a password protected ssh key you will be prompted for your passphrase.
cyphr will ensure that this is not echoed onto the console.
key <- cyphr::key_openssl() ## Please enter private key passphrase: key
Encrypt / decrypt a file
If you have files that already exist and you want to encrypt or decrypt, the functions
cyphr::decrypt_file will do that (these are workhorse functions that are used internally throughout the package)
saveRDS(iris, "myfile") cyphr::encrypt_file("myfile", key, "myfile.encrypted")
The file is encrypted now:
## Error in readRDS("myfile.encrypted"): unknown input format
Decrypt the file and read it:
cyphr::decrypt_file("myfile.encrypted", key, "myfile.clear") identical(readRDS("myfile.clear"), iris)
##  TRUE
Wrappers around R's file functions
Encrypting files like the above risks leaving a cleartext (i.e., unencrypted) version around. If you want to wrap the output of something like
saveRDS you really have no choice but to write out the file first, encrypt it, and delete the clear version. Making sure that this happens even if a step fails is error prone and takes a surprising number of repetitive lines of code.
Alternatively, to encrypt the output of a file producing command, just wrap it in
cyphr::encrypt(saveRDS(iris, "myfile.rds"), key)
Then to decrypt the a file to feed into a file consuming command, wrap it in
dat <- cyphr::decrypt(readRDS("myfile.rds"), key)
The roundtrip preserves the data:
identical(dat, iris) # yay
##  TRUE
But without the key, it cannot be read:
## Error in readRDS("myfile.rds"): unknown input format
The above commands work through computing on the language, rewriting the
saveRDS commands. Commands for reading and writing tabular and plain text files (
readLines, etc) are also supported, and the way the rewriting is done is designed to be extensible.
The argument to the wrapped functions can be connection objects. In this case the actual command is written to a file and the contents of that file are encrypted and written to the connection. When reading/writing multiple objects from/to a single connection though, this is likely to go very badly.
Supporting additional functions
The functions supported so far are:
However, there are bound to be more functions that could be useful to add here (e.g.,
readxl::read_excel). Either pass the name of the file argument to
cyphr::decrypt(readxl::read_excel("myfile.xlsx"), key, file_arg = "path")
or register the function with the package using
cyphr::rewrite_register("readxl", "read_excel", "path")
Then you can use
to decrypt the file (these are equivalent, but the former will likely be more convenient if you're only dealing with a couple of files, the latter will be more convenient if you are dealing with many).
Collaborating with encrypted data
Even with high-level functions to ease encrypting and decrypting things given a key, there is some work to be done to distribute a set of keys across a group of people who are working together so that everyone can encrypt and decrypt the data but so that the keys themselves are not compromised.
The package contains support for a group of people are working on a sensitive data set. The data will be stored with a symmetric key. However, we never actually store the key directly, instead we'll store a copy for each user that is encrypted with the user's key. Any user with access to the data can authorise another user to access the data. This is described in more detail in the vignette (in R:
vignette("data", package = "cyphr")).
Why are wrappers needed?
The low level functions in
openssl work with raw data, for generality. Few users encounter raw vectors in their typical use of R, so these require serialisation. Most of the encryption involves a little extra random data (the "nonce" in
sodium and similar additional pieces with
openssl). These need storing with the data, and then separating from the data when decryption happens.
MIT © Rich FitzJohn.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Functions in cyphr
|keypair_openssl||Asymmetric encryption with openssl|
|session_key_refresh||Refresh the session key|
|ssh_keygen||Create ssh keypairs|
|encrypt_data||Encrypt and decrypt data and other things|
|key_sodium||Symmetric encryption with sodium|
|encrypt||Easy encryption and decryption|
|data_admin_init||Encrypted data administration|
|rewrite_register||Register functions to work with encrypt/decrypt|
|keypair_sodium||Asymmetric encryption with sodium|
|cyphr||High Level Encryption Wrappers|
|key_openssl||Symmetric encryption with openssl|
Vignettes of cyphr
Last month downloads
|License||MIT + file LICENSE|
|Packaged||2020-01-14 15:11:52 UTC; rich|
|Date/Publication||2020-01-14 18:10:03 UTC|
Include our badge in your README