new CerberusClient(options)
Parameters:
| Name | Type | Description |
|---|---|---|
options |
CerberusClientOptions | The options for the Cerberus client. |
Example
var CerberusClient = require('cerberus-node-client')
var client = new CerberusClient({
// string, The cerberus URL to use.
hostUrl: YOUR_CERBERUS_HOST,
// string, AWS region, required if authenticating to AWS China, otherwise defaults to us-west-2
region: AWS_REGION,
// boolean, defaults to false. When true will console.log many operations
debug: true,
// This will be used as the cerberus X-Vault-Token if supplied
// OVERRIDDEN by process.env.CERBERUS_TOKEN
// If present, normal authentication with cerberus will be skipped
// You should normally only be using this in testing environments
// When developing locally, it is easier to use process.env.CERBERUS_TOKEN
token: 'Some_Auth_Token'
})
client.getSecureData('path/to/my/secret').then(secureConfig => {
//do something with config
})
Methods
-
deleteFile(path)
-
deletes an uploaded file
Parameters:
Name Type Description pathstring The path the the uploaded file
Returns:
A promise that will be resolved when the file contents have been deleted
- Type
- Promise.<object>
-
deleteSecureData(path)
-
Deletes secure data.
Parameters:
Name Type Description pathstring The path for the secure data
Returns:
A promise that will be resolved when the delete is finished
- Type
- Promise.<object>
-
getSecureData(path)
-
Fetches secure data.
Parameters:
Name Type Description pathstring The path for the secure data
Returns:
A promise that when resolved supplies the secure data
- Type
- Promise.<object>
-
listFile(path)
-
lists the files under a path.
Parameters:
Name Type Description pathstring The path or partial path
Returns:
A promise that will be resolved when the list is finished supplying the {ListFileResult}
- Type
- Promise.<ListFileResult>
-
<async> listPathsForSecureData(path)
-
lists the keys under a secure data path.
If no keys are present {ListKeyResult} will have an empty array.
Parameters:
Name Type Description pathstring The path or partial path
Returns:
A promise that will be resolved when the list is finished supplying the results
- Type
- Promise.<ListKeyResult>
-
readFile(path)
-
Reads the contents of an uploaded file
Parameters:
Name Type Description pathstring The path the the uploaded file
Returns:
A promise that will be resolved when the file contents have been fetched
- Type
- Promise.<(Buffer|string)>
-
writeFile(path, data)
-
Uploads a file to a given path
Parameters:
Name Type Description pathstring The path
datastring | Buffer The file buffer or string
Returns:
A promise that will be resolved when the file contents have been uploaded
- Type
- Promise.<object>
-
writeSecureData(path, data)
-
Writes secure data.
Parameters:
Name Type Description pathstring The path for the secure data
dataobject The secure data
Returns:
A promise that will be resolved when the write is finished
- Type
- Promise.<undefined>