aws-parameter-store-json-writer

AWS Parameter Store JSON Writer

A Node.js library that stores JSON in to AWS Parameter Store.

Meant to be used in conjunction with aws-parameter-store-json-reader.

Installation

via npm

npm install aws-parameter-store-json-writer

Usage

const AwsParameterStoreJsonWriter = require('aws-parameter-store-json-writer');

const parameterWriter = new AwsParameterStoreJsonWriter({
	"keyId": "arn:aws:kms:us-east-2:123456789012:key/1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d5e",
	"secrets": [ /\/ContentManagement\/ContentManagementAggregator\/(dev|prod)\/db\/password/ ],
	"retryOptions": {
		"retries": 5,
		"factor": 3,
		"minTimeout": 1 * 1000,
		"maxTimeout": 60 * 1000
	}
});

const config = {
	"dev": {
		"db": {
			"username": "dev-user",
			"password": "secret-password"
		},
		"tags": ["dev", "database"],
		"ids": [12, 42, 128],
		"objs": [{ "entry": 1 }, { "entry": 2 }, { "entry": 3 }]
	},
	"prod": {
		"db": {
			"username": "prod-user",
			"password": "super-secret-password"
		}
	}
};

async function writeConfig(config) {
	const prefix = "/ContentManagement/ContentManagementAggregator";
	return await parameterWriter.write(prefix, config);
}

writeConfig(config);

The above will yield the following parameters added:

Name	Type	Key ID	Value
/ContentManagement/ContentManagementAggregator/dev/db/username	String	-	dev-user
/ContentManagement/ContentManagementAggregator/dev/db/password	SecureString	arn:aws:kms:us-east-2:123456789012:key/1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d5e	secret-password
/ContentManagement/ContentManagementAggregator/dev/tags	StringList	-	"dev", "database"
/ContentManagement/ContentManagementAggregator/dev/ids	StringList	-	"12", "42", "128"
/ContentManagement/ContentManagementAggregator/dev/objs/0/entry	String	-	"1"
/ContentManagement/ContentManagementAggregator/dev/objs/1/entry	String	-	"2"
/ContentManagement/ContentManagementAggregator/dev/objs/2/entry	String	-	"3"
/ContentManagement/ContentManagementAggregator/prod/db/username	String	-	prod-user
/ContentManagement/ContentManagementAggregator/prod/db/password	SecureString	arn:aws:kms:us-east-2:123456789012:key/1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d5e	super-secret-password

Parameter Store Json Writer Configuration

apiVersion – (optional) The version of the AWS API you wish to be using.
keyId – (optional) The AWS KMS Key Id you wish to encrypt your secrets with.
secrets – (optional) A set of Regular Expressions or Strings which match the paths of the keys you wish to be secret.
retryOptions - (optional) The Parameter Store Json Writer uses retry as it's exponential backoff mechanism.

Versioning

This library uses the Semver versioning system. The numbers do not relate to maturity but the number of breaking changes introduced.