node-cryptography

About

Simplified functions for nodejs cryptography.

Usage

Functions

cryptography.encrypt(options)

• options <Object> | <string>
• options.key <string>
• options.algorithm <string>
• options.encoding <string>
• options.data <string>
• options.callback <Function>
  • error <Error>
  • encrypted <string>

Returns a promise which is resolved with encrypted string. If a callback is passed it is called with encrypted string.

cryptography.encryptSync(options)

• options <Object> | <string>
• options.key <string>
• options.algorithm <string>
• options.encoding <string>
• options.data <string>

Synchronous encrypt(). Returns encrypted string.

cryptography.decrypt(options)

• options <Object> | <string>
• options.key <string>
• options.algorithm <string>
• options.encoding <string>
• options.data <string>
• options.callback <Function>
  • error <Error>
  • decrypted <string>

Returns a promise which is resolved with decrypted string. If a callback is passed it is called with decrypted string.

cryptography.decryptSync(options)

• options <Object> | <string>
• options.key <string>
• options.algorithm <string>
• options.encoding <string>
• options.data <string>

Synchronous decrypt(). Returns decrypted string.

cryptography.hmac(options)

• options <Object> | <string>
• options.key <string>
• options.algorithm <string>
• options.encoding <string>
• options.data <string>
• options.callback <Function>
  • error <Error>
  • hashed <string>

Returns a promise which is resolved with hashed string. If a callback is passed it is called with hashed string.

cryptography.hmacSync(options)

• options <Object> | <string>
• options.key <string>
• options.algorithm <string>
• options.encoding <string>
• options.data <string>

Synchronous hmac(). Returns hashed string.

cryptography.hash(options)

• options <Object> | <string>
• options.key <string>
• options.algorithm <string>
• options.encoding <string>
• options.data <string>
• options.callback <Function>
  • error <Error>
  • hashed <string>

Returns a promise which is resolved with hashed string. If a callback is passed it is called with hashed string.

cryptography.hashSync(options)

• options <Object> | <string>
• options.key <string>
• options.algorithm <string>
• options.encoding <string>
• options.data <string>

Synchronous hash(). Returns hashed string.

cryptography.randomBytes(options)

• options <Object> | <Number>
• options.size <Number>
• options.encoding <string>
• options.callback <Function>
  • error <Error>
  • randomBytes <string>

Returns a promise which is resolved with random bytes string. If a callback is passed it is called with random bytes string.

cryptography.randomBytesSync(options)

• options <Object> | <Number>
• options.size <Number>
• options.encoding <string>

Synchronous randomBytes(). Returns random bytes string.

Example with promise

const cryptography = require("cryptography");

// Set defaults
cryptography.defaults.key = "password";
cryptography.defaults.encryptionAlgorithm = "aes192";
cryptography.defaults.encoding = "hex";

// Use defaults
cryptography.encrypt("string to encrypt")
.then(function(encrypted)
{
    return cryptography.decrypt(encrypted);
})
.then(function(decrypted)
{
    console.log(decrypted) // outputs: "string to encrypt"
})
.catch(function(error)
{
    // An error occurred
});

// Override defaults for one call
cryptography.encrypt({
    key: "another password",
    data: "string to encrypt"
})
.then(function(encrypted)
{
    return cryptography.decrypt({
        key: "another password",
        data: encrypted
    });
})
.then(function(decrypted)
{
    console.log(decrypted) // outputs: "string to encrypt"
})
.catch(function(error)
{
    // An error occurred
});

Example with callback

const cryptography = require("cryptography");
var decryptCallback = function(error, decrypted)
{
    if(error)
    {
        // Error occurred
        return;
    }

    console.log(decrypted);
};
var encryptCallback = function(error, encrypted)
{
    if(error)
    {
        // Error occurred
        return;
    }

    cryptography.decrypt({
        data: encrypted,
        callback: decryptCallback
    });
};

cryptography.encrypt({
    data: "string to encrypt",
    callback: encryptCallback
});

Example with synchronous

const cryptography = require("cryptography");

try
{
    var encrypted = cryptography.encryptSync("string to encrypt");
    var decrypted = cryptography.decryptSync(encrypted);
}
catch(error)
{
    // Error occurred
    return;
}

console.log(decrypted);