npm package 'pbkdf2-opgp-key'

Popularity: Low
Description: opgp-service keys encrypted with a pbkdf2-sha512 digest. ES5. TypeScript support. 1.1kb gzip.
Installation: npm install pbkdf2-opgp-key
Last version: 2.2.1 (Download)
Homepage: https://github.com/zenyway/pbkdf2-opgp-key#readme
Size: 37.15 kB
License: SEE LICENSE IN LICENSE
Keywords: openpgp, pbkdf2, crypto, passphrase

Activity

Last modified: August 19, 2018 10:10 PM (4 years ago)
Versions released in one year: 0
Weekly downloads: 9
08/15/202110/31/202101/16/202204/10/202207/17/202209182736released versions / week
  • Versions released
  • Weekly downloads

What's new in version 2.2.1

Delta between version 2.2.0 and version 2.2.1

Source: Github
Commits:
  • aa019345efa7e49cf66ff3a8e7427e2e408d6859, August 19, 2018 10:06 PM:
    2.2.1 bump deps, beautify, minify, remove tslib
Files changed:
  • .travis.yml (modified)
  • README.md (modified)
  • package.json (modified)
  • spec/example/console.ts (added)
  • spec/example/index.html (modified)
  • spec/example/index.js (modified)
  • spec/example/index.ts (modified)
  • spec/example/tsconfig.json (modified)
  • spec/index.spec.ts (modified)
  • spec/karma-coverage.conf.js (modified)
  • spec/karma.conf.js (modified)
  • spec/tsconfig.json (modified)
  • spec/web/index.html (modified)
  • spec/web/index.spec.js (modified)
  • src/index.ts (modified)
  • src/tsconfig.json (modified)
  • src/utils.ts (modified)
  • tslint.json (added)

Readme

pbkdf2-opgp-key

opgp-service keys encrypted with a pbkdf2-sha512 digest.

Pbkdf2OpgpKey instances encapsulate a private OpgpProxyKey. ES5. TypeScript support. 1.1kb gzip.

<a name="example"></a> example

import getPbkdf2OpgpKeyFactory from 'pbkdf2-opgp-key'
import getOpgpService from 'opgp-service'
import debug = require('debug')
debug.enable('example:*')

const opgp = getOpgpService()
const getPbkdf2OpgpKey = getPbkdf2OpgpKeyFactory(opgp, {
  // keysize: 2048, locked: false (defaults)
  pbkdf2: {
    salt: 32, // generate random 32-byte long string, encoding: base64 (default)
    iterations: 8192, // min 8192, default 65536
    length: 64 // min 32, max 64, default 64
    // digest is always 'sha512'
  }
})

debug('example:')('generate key...')
const key = getPbkdf2OpgpKey('j.doe@example.com', 'secret passphrase')
key.then(debug('example:key:'))
// { key: OpgpProxyKey, pbkdf2: { salt: "...", ... }, unlock: Function, toArmor: Function, clone: Function }

const armor = key.then(key => key.toArmor())
armor.then(debug('example:armor:'))
// { armor: "-----BEGIN PGP PRIVATE KEY BLOCK----- ...", pbkdf2: { salt: "...", ... } }

armor.then(armor => getPbkdf2OpgpKey(armor, 'secret passphrase'))
.then(debug('example:from-armor:'))
// { key: OpgpProxyKey, pbkdf2: { salt: "...", ... }, unlock: Function, toArmor: Function, clone: Function }

the files of this example are available in this repository.

view a live version of this example in your browser console, or clone this repository and run the following commands from a terminal:

npm install
npm run example

<a name="api"></a> API v2.0 stable

ES5 and Typescript compatible. coded in Typescript 3, transpiled to ES5.

secure Pbkdf2OpgpKey instances can either be randomly generated, or imported from an armored representation. the corresponding factory is instantiated with the exported builder.

Pbkdf2OpgpKey instances currently expose a single method: unlock (passphrase: string): Promise<Pbkdf2OpgpKeyClass>

browse the API's public type declarations.

for a detailed specification of the API, run the unit tests in your browser.

<a name="contributing"></a> CONTRIBUTING

see the contribution guidelines

<a name="license"></a> LICENSE

Copyright 2017 Stéphane M. Catala

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and Limitations under the License.