Package Exports

@sourceloop/vault

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@sourceloop/vault) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@sourceloop/vault

Dependencies Status Loopback Core Version

A simple loopback-next extension for Hashicorp's Vault integration in loopback applications based on node.js vault client node-vault.

Install

npm install @sourceloop/vault

Usage

In order to use this component into your LoopBack application, please follow below steps.

Add component to application and provide vault endpoint, vault token and unseal key via VaultSecurityBindings.

this.component(VaultComponent);
this.bind(VaultSecurityBindings.CONFIG).to({
  endpoint: process.env.VAULT_URL,
  token: process.env.VAULT_TOKEN,
  unsealKey: process.env.VAULT_UNSEAL_KEY,
});

After this, you can just inject the VaultSecurityBindings.VAULT_CONNECTOR across application.

@inject(VaultSecurityBindings.VAULT_CONNECTOR)
private readonly vaultConnector: VaultConnect,

All the methods mentioned here are now available on vaultConnector.

Here is an example usage below

  private async upsertKeyToVault(credKey: string): Promise<{data: AnyObject}> {
    let data: {data: AnyObject};
    try {
      data = await this.vaultConnector.read(credKey);
    } catch (error) {
      if (error.response.statusCode === 404) {
        await this.vaultConnector.write(credKey, {empty: true});
        data = await this.vaultConnector.read(credKey);
      } else {
        this.logger.error(error);
        throw error;
      }
    }
    return data;
  }

Feedback

If you've noticed a bug or have a question or have a feature request, search the issue tracker to see if someone else in the community has already created a ticket. If not, go ahead and make one! All feature requests are welcome. Implementation time may vary. Feel free to contribute the same, if you can. If you think this extension is useful, please star it. Appreciation really helps in keeping this project alive.

Contributing

Please read CONTRIBUTING.md for details on the process for submitting pull requests to us.

Code of conduct

Code of conduct guidelines here.

License

MIT