Skip to content
Derive a named key from a high-entropy master key
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
LICENSE
README.md
example.js
index.js
package.json
test.js

README.md

derive-key

Derive a named key from a high-entropy master key

npm install derive-key

Usage

const derive = require('derive-key')
const masterKey = crypto.randomBytes(32) // make sure this is high-entropy master key, eg. from a CSPRNG

const key = derive('a namespace', masterKey, 'my-named-key')

console.log('the derived key is:', key)

API

outputKey = derive(namespace, masterKey, name, [outputKey])

Derive a named key from a 32 byte high-entropy master key. This can be 32-bytes of cryptographically secure randomness, eg from a CSPRNG. Do NOT use low entropy soruces such a passwords, passphrases or randomness from a predictable RNG.

The namespace should be an ascii string (fx your application name) and name can be a buffer or string reflecting the name of the key you want to derive.

Optionally you can pass in the output key parameter and the result will be written into this buffer instead of a new buffer being allocated internally.

License

MIT

You can’t perform that action at this time.