https://github.com/jeroen/agent

Store sensitive data such as API tokens
https://github.com/jeroen/agent

agent data-security key-value-store r r-package rstats security security-tools sensitive-data

Last synced: 9 days ago
JSON representation

Store sensitive data such as API tokens

• Host: GitHub
• URL: https://github.com/jeroen/agent
• Owner: jeroen
• License: other
• Created: 2016-10-18T11:06:51.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2018-05-11T15:17:49.000Z (over 6 years ago)
• Last Synced: 2024-10-11T18:20:06.376Z (25 days ago)
• Topics: agent, data-security, key-value-store, r, r-package, rstats, security, security-tools, sensitive-data
• Language: R
• Homepage: https://docs.ropensci.org/agent
• Size: 10.7 KB
• Stars: 19
• Watchers: 7
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - jeroen/agent - Store sensitive data such as API tokens (R)

README

        
# agent

##### *Encrypted Key-Value Store for Sensitive Data*

[![Project Status: Concept – Minimal or no implementation has been done yet, or the repository is only intended to be a limited example, demo, or proof-of-concept.](http://www.repostatus.org/badges/latest/concept.svg)](http://www.repostatus.org/#concept)

[![Build Status](https://travis-ci.org/ropensci/agent.svg?branch=master)](https://travis-ci.org/ropensci/agent)

[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/ropensci/agent?branch=master&svg=true)](https://ci.appveyor.com/project/jeroen/agent)

[![Coverage Status](https://codecov.io/github/ropensci/agent/coverage.svg?branch=master)](https://codecov.io/github/ropensci/agent?branch=master)

[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/agent)](http://cran.r-project.org/package=agent)

[![CRAN RStudio mirror downloads](http://cranlogs.r-pkg.org/badges/agent)](http://cran.r-project.org/web/packages/agent/index.html)

> Cross platform solution for securely storing sensitive data. This 

  can either be used directly by the user or by other packages for storing 

  e.g. web tokens or other secrets. The degree of security is detemined by 

  the strength of the password as set by the user.

## Hello World

The agent works like a simple key-value store. The value can be any object that can be serialized by R such as a token or data frame. This API can either be called by the user or by other packages.

```r

library(agent)

agent_set("my_secret_token", "ABCXYZ")

agent_get("my_secret_token")

## "ABCXYZ"

agent_has("my_secret_token")

## TRUE

agent_del("my_secret_token")

```

It is up to the user to protect the keystore with a password:

```r

update_password()

```

The user will automatically be prompted for a password when the keystore needs to be unlocked, for example when a package needs to retrieve a secured token.