vaultr v1.0.2

0

Monthly downloads

0th

Percentile

Vault Client for Secrets and Sensitive Data

Provides an interface to a 'HashiCorp' vault server over its http API (typically these are self-hosted; see <https://www.vaultproject.io>). This allows for secure storage and retrieval of secrets over a network, such as tokens, passwords and certificates. Authentication with vault is supported through several backends including user name/password and authentication via 'GitHub'.

Readme

vaultr

Project Status: Active – The project has reached a stable, usable state and is being actively developed. Travis-CI Build Status AppVeyor build status codecov.io

API client for vault.

Vault provides a platform for distributing secrets across machines. This package wraps the vault http API to allow secrets to be accessed from R. Secrets might be passwords, tokens, certificates or any other sensitive data.

Usage

Create a vault client with the vault_client function:

vault <- vaultr::vault_client(login = TRUE)
## Verifying token

Interact with vault using this object:

vault$list("secret/database")
## [1] "admin"    "readonly"

and read secrets with

vault$read("secret/database/admin")
## $value
## [1] "s3cret"
vault$read("secret/database/readonly", field = "value")
## [1] "passw0rd"

or set secrets with

vault$write("secret/webserver", list(password = "horsestaple"))
vault$read("secret/webserver")

or delete secrets with

vault$delete("/secret/database/readonly")

Installation

Install vaultr from CRAN with

install.packages("vaultr")

To install our internally released version (which might be ahead of CRAN) via drat, use

# install.packages("drat") # (if needed)
drat:::add("vimc")
install.packages("vaultr")

or install the bleeding edge with

# install.packages("devtools") # (if needed)
devtools::install_gitub("vimc/vaultr", upgrade = FALSE)

License

MIT © Imperial College of Science, Technology and Medicine

Functions in vaultr

Name Description
vault_client_secrets Vault Secret Configuration
vault_client_token Vault Tokens
vault_client Make a vault client
vault_client_tools Vault Tools
vaultr Vault Client for Secrets and Sensitive Data
vault_client_transit Transit Engine
vault_resolve_secrets Resolve secrets from R objects
vault_test_server Control a test vault server
vault_client_operator Vault Administration
vault_client_policy Vault Policy Configuration
vault_client_auth_github Vault GitHub Authentication Configuration
vault_client_kv1 Key-Value Store (Version 1)
vault_client_audit Vault Audit Devices
vault_client_auth_approle Vault AppRole Authentication Configuration
vault_api_client Vault Low-Level Client
vault_client_kv2 Key-Value Store (Version 2)
vault_client_auth Vault Authentication Configuration
vault_client_auth_userpass Vault Username/Password Authentication Configuration
vault_client_cubbyhole Cubbyhole secret store
No Results!

Vignettes of vaultr

Name
packages.Rmd
vaultr.Rmd
No Results!

Last month downloads

Details

License MIT + file LICENSE
URL https://github.com/vimc/vaultr
BugReports https://github.com/vimc/vaultr/issues
SystemRequirements vault
RoxygenNote 6.1.1
Encoding UTF-8
VignetteBuilder knitr
Language en-GB
NeedsCompilation no
Packaged 2019-05-15 14:10:57 UTC; rfitzjoh
Repository CRAN
Date/Publication 2019-05-16 13:30:03 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/vaultr)](http://www.rdocumentation.org/packages/vaultr)