Voltos Node.js bindings

This provides Voltos Node.js bindings to access the Voltos API from apps written in Node.js. Voltos provides credentials-as-a-service for app and system developers.

Voltos stores your credentials (e.g. API keys, usernames, passwords, tokens) in a secure, central location - so that your apps can access them securely as environment variables, and you can more easily manage & access them.

Contents

• Installation
• Using Voltos
• Deploying to Azure
• Contributing

Installation

Add voltos package by executing:

$ npm install voltos --save

Your package.json will be updated.

Then update app.js and require voltos at the very top of the file:

require('voltos');

Your Voltos keys should be available to your Node.js app via process.ENV

Using Voltos

Using Voltos to manage your credentials and secrets is generally the same across all platforms. Check out the general docs at:

• Getting started
• Using Voltos with your apps

Deploying to Azure

Ensure the Installation code updates are completed and pushed to your Azure app.

Manually retrieve the API token for the selected bundle

$ voltos use your-voltos-bundle
Setting current bundle in use to 'your-voltos-bundle'... ⣻

$ voltos token
Fetching token... ⣻

New API token for 'your-voltos-bundle' is: cbff7be5112287c39dad41c643761a84
Please store this securely, this is the only time it will be displayed and it can not be retrieved again
(though you can request a new one)

Then add the API token to the Azure config variables for your app:

$ azure site config add VOLTOS_KEY=cbff7be5112287c39dad41c643761a84

On startup, voltos will securely retrieve your bundle's credentials and make them available to your app.

Anytime you need to update your credentials: do so via the CLI or web app, azure site restart your app, and the updated credentials are loaded up to your app again.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/gluio/voltos-node