A Javascript port of the Ruby aws_credentials gem
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib
test
.gitignore
LICENSE
README.md
package.json

README.md

Aws-Cred

A Javascript port of Ben Koski's ruby gem aws_credentials, which provides a simple way to manage your Amazon credentials across multiple apps and servers through a config file on the system. This version is compatible with the config files from the ruby gem, with additional support for account_id.

Installation

npm install aws-cred

Usage

Put a yaml file on your server under /etc/aws.conf that contains:

access_key: YOUR_KEY_HERE (required)
secret_access_key: YOUR_SECRET_KEY_HERE (required)
account_id: YOUR_KEY_HERE (optional)

Require and configure aws-cred in your app. This loads /etc/aws.conf:

var AWSCred = require('aws-cred');
awscred = new AWSCred({});
awscred.access_key;
awscred.secret_access_key;
awscred.account_id;

You can also specify an environment to load different files. This is useful if you want to maintain different keys for production, development, staging, etc:

//this sets the environment to "donkey" and loads /etc/aws.donkey.conf
awscred = new AWSCred({"env": "donkey"});

And you can manually set the path, in which case it ignores the environment:

//this will load from /exactly/where/you/said/yourfile.conf
awscred = new AWSCred({"config_path": "/exactly/where/you/said/yourfile.conf"});