https://github.com/virgilsecurity/virgil-keyknox-javascript
Keyknox SDK allows developers to communicate with Virgil Keyknox Service to upload, download, and synchronize encrypted sensitive data (private keys) between different devices.
https://github.com/virgilsecurity/virgil-keyknox-javascript
cryptography data-sharing keyknox sdk
Last synced: 10 months ago
JSON representation
Keyknox SDK allows developers to communicate with Virgil Keyknox Service to upload, download, and synchronize encrypted sensitive data (private keys) between different devices.
- Host: GitHub
- URL: https://github.com/virgilsecurity/virgil-keyknox-javascript
- Owner: VirgilSecurity
- License: bsd-3-clause
- Created: 2018-06-27T08:58:43.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-19T14:09:01.000Z (almost 2 years ago)
- Last Synced: 2025-05-09T01:15:23.575Z (10 months ago)
- Topics: cryptography, data-sharing, keyknox, sdk
- Language: TypeScript
- Homepage:
- Size: 378 KB
- Stars: 3
- Watchers: 12
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> This README is for Keyknox v1.0.0. Check the [v0.3.x branch](https://github.com/VirgilSecurity/virgil-keyknox-javascript/tree/v0.3.x) for Keyknox v0.3.x docs.
# Virgil Keyknox JavaScript SDK
[](https://www.npmjs.com/package/@virgilsecurity/keyknox)
[](https://travis-ci.org/VirgilSecurity/virgil-keyknox-javascript)
[](https://github.com/VirgilSecurity/virgil-keyknox-javascript/blob/master/LICENSE)
[Introduction](#introduction) | [SDK Features](#sdk-features) | [Installation](#installation) | [Usage Example](#usage-example) | [Docs](#docs) | [Support](#support)
## Introduction
[Virgil Security](https://virgilsecurity.com) provides an SDK which allows you to communicate with Virgil Keyknox Service.
Virgil Keyknox Service allows users to store their sensitive data (such as Private Key) encrypted (with end-to-end encryption) for using and sharing it between different devices.
## SDK Features
- use [Virgil Crypto library](https://github.com/VirgilSecurity/virgil-crypto-javascript)
- use [Virgil SDK](https://github.com/VirgilSecurity/virgil-sdk-javascript)
- upload encrypted sensitive data to Virgil Keyknox Service
- download the data from Virgil Keyknox Service
- update and synchronize the data
## Installation
You can install this module from npm. Another option is to add it via `script` tag in browser.
### npm
You will need to install `@virgilsecurity/keyknox`.
```sh
npm install @virgilsecurity/keyknox
```
You will also need to install `virgil-crypto` and `virgil-sdk` from npm.
```sh
npm install virgil-crypto virgil-sdk
```
> Note that minimum supported version of `virgil-crypto` is `4.0.0` and minimum supported version of `virgil-sdk` is `6.0.0`.
### In browser via `script` tag
You will need to add `@virgilsecurity/keyknox` script.
```html
```
You will also need to add `virgil-crypto` and `virgil-sdk` scripts.
```html
```
Now you can use global variables `Keyknox`, `Virgil` and `VirgilCrypto` as namespace objects, containing all of `@virgilsecurity/keyknox`, `virgil-sdk` and `virgil-crypto` exports as properties.
## Usage Example
To begin using Virgil Keyknox SDK you'll need to initialize `SyncKeyStorage` class. This class is responsible for synchronization between device storage - IndexedDB in a browser or file system in Node.js - and Keyknox Cloud. In order to initialize `SyncKeyStorage` class you'll need the following values:
- `identity` of the user
- `accessTokenProvider` to provide access token for Virgil services
- `keyEntryStorage` to store data locally
- `privateKey` of current device/user
- `publicKeys` of all devices/users that should have access to data
- `virgilCrypto` to perform all cryptographic operations
```js
const { SyncKeyStorage } = require('@virgilsecurity/keyknox');
const { initCrypto, VirgilCrypto } = require('virgil-crypto');
initCrypto().then(() => {
// Identity of the user
const identity = ...;
// Setup Access Token provider to provide access token for Virgil services
// Check https://github.com/VirgilSecurity/virgil-sdk-javascript
const accessTokenProvider = ...;
// Setup Key Entry Storage to store data locally
// Check https://github.com/VirgilSecurity/virgil-sdk-javascript
const keyEntryStorage = ...;
// Public keys of users that should have access to data
const publicKeys = ...;
// Private key of current user
const privateKey = ...;
// An instance of `VirgilCrypto` class
const virgilCrypto = new VirgilCrypto();
const syncKeyStorage = SyncKeyStorage.create({
identity,
accessTokenProvider,
keyEntryStorage,
privateKey,
publicKeys,
virgilCrypto,
});
});
```
You can find a complete example of simple client-server application [here](example).
### What if I lost my private key?
If you lost your private key, you are not able to decrypt saved data anymore. So you need to reset your stored data in the Virgil Keyknox Service and start over.
```js
import { KeyknoxClient } from '@virgilsecurity/keyknox';
const tokenPromise = accessTokenProvider.getToken({ operation: 'delete' });
const resetPromise = tokenPromise.then(token => new KeyknoxClient().resetValue(token.toString()));
const syncKeyStorage = SyncKeyStorage.create(...);
resetPromise.then(() => syncKeyStorage.sync());
```
## Docs
Virgil Security has a powerful set of APIs, and the documentation below can get you started today.
* [Virgil Security Documentation](https://developer.virgilsecurity.com)
## License
This library is released under the [BSD 3-Clause License](LICENSE).
## Support
Our developer support team is here to help you. Find out more information on our [Help Center](https://help.virgilsecurity.com).
You can find us on [Twitter](https://twitter.com/VirgilSecurity) or send us email support@VirgilSecurity.com.
Also, get extra help from our support team on [Slack](https://virgilsecurity.com/join-community).