{"id":14068007,"url":"https://github.com/cloudyr/aws.secrets","last_synced_at":"2025-07-30T02:32:40.590Z","repository":{"id":70475413,"uuid":"128829845","full_name":"cloudyr/aws.secrets","owner":"cloudyr","description":null,"archived":false,"fork":false,"pushed_at":"2020-01-12T14:22:59.000Z","size":12,"stargazers_count":7,"open_issues_count":2,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-08-13T07:14:07.509Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudyr.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-09T20:28:11.000Z","updated_at":"2021-05-11T00:16:17.000Z","dependencies_parsed_at":"2023-03-01T00:15:41.632Z","dependency_job_id":null,"html_url":"https://github.com/cloudyr/aws.secrets","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudyr%2Faws.secrets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudyr%2Faws.secrets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudyr%2Faws.secrets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudyr%2Faws.secrets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudyr","download_url":"https://codeload.github.com/cloudyr/aws.secrets/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228075684,"owners_count":17865524,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-13T07:05:53.636Z","updated_at":"2024-12-04T08:31:26.965Z","avatar_url":"https://github.com/cloudyr.png","language":"R","funding_links":[],"categories":["R"],"sub_categories":[],"readme":"# AWS Secrets Managers service\n\n**aws.secrets** is a package for the AWS Secrets Manager service \u003chttps://aws.amazon.com/secrets-manager/\u003e.\n\nTo use the package, you will need an AWS account and to enter your credentials into R. Your keypair can be generated on the [IAM Management Console](https://aws.amazon.com/) under the heading *Access Keys*. Note that you only have access to your secret key once. After it is generated, you need to save it in a secure location. New keypairs can be generated at any time if yours has been lost, stolen, or forgotten. The [**aws.iam** package](https://github.com/cloudyr/aws.iam) profiles tools for working with IAM, including creating roles, users, groups, and credentials programmatically; it is not needed to *use* IAM credentials.\n\nA detailed description of how credentials can be specified is provided at: https://github.com/cloudyr/aws.signature/. The easiest way is to simply set environment variables on the command line prior to starting R or via an `Renviron.site` or `.Renviron` file, which are used to set environment variables in R during startup (see `? Startup`). They can be also set within R:\n\n```R\nSys.setenv(\"AWS_ACCESS_KEY_ID\" = \"mykey\",\n           \"AWS_SECRET_ACCESS_KEY\" = \"mysecretkey\",\n           \"AWS_DEFAULT_REGION\" = \"us-east-1\",\n           \"AWS_SESSION_TOKEN\" = \"mytoken\")\n```\n\n\n## Code Examples\n\nThe package provides ways of creating and storing \"secrets\" like passwords. A simple example is the password generation function:\n\n```{r}\nlibrary(\"aws.secrets\")\nget_random_password()\n```\n\nA more useful use case for the package is to use Secrets Manager to store and update passwords that you want to programmatically use in other applications. Rather than hard-coding a password or secret key, you can use Secrets Manager to instead code calls to `get_secret()` and then update the stored secret whenever you want. Thus you have a form of version control for passwords that doesn't require any changes to a running application yet retains security for the password-protected service.\n\n....\n\n## Installation\n\n[![CRAN](https://www.r-pkg.org/badges/version/aws.secrets)](https://cran.r-project.org/package=aws.secrets)\n![Downloads](https://cranlogs.r-pkg.org/badges/aws.secrets)\n[![Travis Build Status](https://travis-ci.org/cloudyr/aws.secrets.png?branch=master)](https://travis-ci.org/cloudyr/aws.secrets)\n[![Appveyor Build Status](https://ci.appveyor.com/api/projects/status/PROJECTNUMBER?svg=true)](https://ci.appveyor.com/project/cloudyr/aws.secrets)\n[![codecov.io](https://codecov.io/github/cloudyr/aws.secrets/coverage.svg?branch=master)](https://codecov.io/github/cloudyr/aws.secrets?branch=master)\n\nThis package is not yet on CRAN. To install the latest development version you can install from the cloudyr drat repository:\n\n```R\n# latest stable version\ninstall.packages(\"aws.secrets\", repos = c(cloudyr = \"http://cloudyr.github.io/drat\", getOption(\"repos\")))\n```\n\nOr, to pull a potentially unstable version directly from GitHub:\n\n```R\nif (!require(\"remotes\")) {\n    install.packages(\"remotes\")\n}\nremotes::install_github(\"cloudyr/aws.secrets\")\n```\n\n\n---\n[![cloudyr project logo](https://i.imgur.com/JHS98Y7.png)](https://github.com/cloudyr)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudyr%2Faws.secrets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudyr%2Faws.secrets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudyr%2Faws.secrets/lists"}