This gem is a Ruby wrapper around @dcoker
's biscuit library, a multi-region HA key-value store for your AWS infrastructure secrets.
By using this Ruby library, it is easy to integrate into a Ruby/Rails stack.
-
Add this line to your application's Gemfile:
gem 'biscuit'
-
And then run
bundle
. -
touch
a yaml file (or multiple for different environments).
secrets_file = "some_yaml_file.yaml"
SECRETS = Biscuit::SecretsDecrypter.new(secrets_file).load
puts SECRETS["some_password"]
# => "decrypted password"
If you store config in ENV vars as suggested by the 12 Factor App, you can load your AWS encrypted secrets into ENV vars like this:
secrets_file = "some_yaml_file.yaml"
Biscuit::SecretsDecrypter.new(secrets_file).load do |key, value|
ENV[key] = value
end
This approach pairs with dotenv really well - dotenv for test/development, and biscuit for staging/production environments.
Load your secrets in application.rb
, between loading Rails/bundler, before the Application config starts:
require "rails/all"
...
Bundler.require(*Rails.groups)
...
# Add in your biscuit loading here:
secrets_file = "#{__dir__}/secrets/#{Rails.env}.yml"
if File.exist?(secrets_file) # You can also check things like if Rails.env.production?
Biscuit::SecretsDecrypter.new(secrets_file).load do |key, value|
ENV[key] = value
end
end
...
module MyApp
class Application < Rails::Application
....
From the application root, run biscuit put -f
, followed by the path to the yaml you want to encrypt in, followed by the key, followed by the example.
$ biscuit put -f config/secrets/production.yml SECRET_KEY "sensitive value"
$ biscuit export -f config/secrets/production.yml | grep "SECRET_KEY"
Given this unencrypted YAML:
foo: 1,2,3,4,5
You might think that foo
's value after being loaded would be "1,2,3,4,5"
.
You'd be wrong... Ruby's YAML parser strips out the commas, sees 12345
, and thinks "ah we have a number!"
Then the value is 12345
.
If you desire to keep the commas, you'll have to encode it quoted:
foo: "1,2,3,4,5"
After checking out the repo, run bin/setup
to install dependencies. Then, run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
to create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
First, go to lib/biscuit/version.rb
and update the gem to the version you'd like. We follow semantic versioning, if you have questions about this please consult this document.
After merging the change into the default branch you can go here and publish a new release. Which will automatically push the new version to rubygems.org
MIT.
Library created by UserTesting
- Fork it ( https://github.com/usertesting/biscuit/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request