README.md

divvy-vault-client

A javascript / http client to interact with Divvy Vault servers.

The purpose of this tool is to enable applications in any javascript environment to login with the divvy vault and access the decrypted data stored using credentials originally obtained at xdv.io

Spec Tests

Run npm test to test the high-level behavior specs

Divvy Vault Client
  initialization
    ✓ should be initialized with a domain 
    ✓ should default to xdv.io without a domain 
  #login
    ✓ with username and password should retrive the blob, crypt key, and id 
  #relogin
    ✓ should retrieve the decrypted blob with id and crypt key 
  #unlock
    ✓ should access the wallet secret using encryption secret, username and password 
  #loginAndUnlock
    ✓ should get the decrypted blob and decrypted secret given name and password 


Blob
  #set
    ✓ should set a new property in the blob
  #extend
    ✓ should extend an object in the blob 
  #unset
    ✓ should remove a property from the blob 
  #unshift
    ✓ should prepend an item to an array in the blob 
  #filter
    ✓ should find a specific entity in an array and apply subcommands to it 
  #consolidate
    ✓ should consolidate and save changes to the blob               

Vault Client Usage

vaultClient = new VaultClient(domain);

vaultClient.login(username, password, callback);

vaultClient.relogin(id, cryptKey, callback);

vaultClient.unlock(username, password, encryptSecret, callback);

vaultClient.loginAndUnlock(username, password, callback);

vaultClient.exists(username, callback);

vaultClient.register(options, callback);

Blob Client Methods

blobClient.get(url, id, crypt, callback);

blobClient.create(options, callback);

blobClient.verify(url, username, token, callback);

Blob Methods

blob.encrypt();

blob.decrypt(encryptedBlob);

blob.encryptSecret(encryptionKey);

blob.decryptSecret(encryptionKey, secret);

blob.set(pointer, value, callback);

blob.unset(pointer, callback);

blob.extend(pointer, value, callback);

blob.unshift(pointer, value, callback);

blob.filter(pointer, field, value, subcommands, callback);

Installation

npm install divvy-vault-client