AES.js-wrapper

Encrypt and decrypt very secure and completely uniqe text from and to AES 256 CBC

Installation

# With NPM
npm i -S ihack2712/aes.js-wrapper

# With YARN
yarn add ihack2712/aes.js-wrapper

# With bower
bower install ihack2712/aes.js-wrapper

Example

const AES = require('aes.js-wrapper')

var password = 'secret'
  , text = 'Hello World'

var encrypted = AES.encrypt(text, password)
  , decrypted = AES.decrypt(encrypted, password)

console.log('AES Wrapper Example')
console.log('Password: "' + password + '"')
console.log('Dummy Text: "' + text + '"')
console.log('')
console.log('* Encrypted')
console.log(encrypted)
console.log()
console.log('* Decrypted')
console.log(decrypted)

Results In:

$ node example
AES Wrapper Example
Password: "secret"
Dummy Text: "Hello World"

* Encrypted
c9ea1bf12e83ecb5b06a2f9e1ebb4c7eea0fba8d48ffa4973bd4d4b65b809e648f0996c291dc7035ca1c41dcf39864188f41f5893bc00d73d4b376e74cdc9bf0a933df90723dc9f4510e4d6ad9936694

* Decrypted
Hello World

Properties

| Name | Type | Description | | --------- | ------ | ------------------------------------------------------------------------- | | _iv_ | Buffer | Get the default IV in a buffer. | | dummyText | string | This is the default dummy text to use when hashing and validating hashes. |

Methods

constructor ()

The constructor method in this class is completely useless, it's not used for anything.

encrypt (value, password)

Encrypt normal text to a very uniqe, and very secure hex formatted string.

Params

| Name | Type | Description | | -------- | ------ | ------------------------------------------------------------------------------------------------------ | | value | string | This is the text to encrypt. | | password | string | This is the raw text utf8 password to hash into a md5 hex that will also secure the encryption better. |

Returns

string

Example

AESWrapper.encrypt('hello world', 'very secret password')
// '39f425031f850fcca2f0f4f56bf3143a8104fa1dd27eb143f64a4fd3f223b85ca6b5849a5b48e6dd4af9fb6ddba9ffbae41c4d165491f8358ae7167d7acc834e58cf97fbab413aef0165ea991a475809'

decrypt (data, password)

Decrypt encrypted text to the normal text using the very secret password.

Params

| Name | Type | Description | | -------- | ------ | ------------------------------------------------------------------------------------------------------ | | data | string | This is the encrypted text to decrypt | | password | string | This is the raw text utf8 password to hash into a md5 hex that will also secure the encryption better. |

Returns

string

Example

AESWrapper.decrypt('39f425031f850fcca2f0f4f56bf3143a8104fa1dd27eb143f64a4fd3f223b85ca6b5849a5b48e6dd4af9fb6ddba9ffbae41c4d165491f8358ae7167d7acc834e58cf97fbab413aef0165ea991a475809', 'very secret password')
// 'hello world'

hash (key)

Hash text into a completely uniqe hash, that means hashing the same text again won't be equal to this one.

Params

| Name | Type | Description | | ---- | ------ | --------------------------------------------------------------------------------- | | key | string | This key will be used to create the hash, this key will be encrypting dummy text. |

Returns

string

Example

AESWrapper.hash('Hello World')
// c6ae556bd9a4d728f061ff66cd196e96e00792810061a528db8f4f74f229c60dc9bfc837fbe447eadb7c6353ffce18983849c70ffc7ac754ee3d2502ddc148827032ea83741d9647a6a2e8921cb1800c192381fe42d357de64d397c4e10c0b2eeee18d2255a7817cb36bb9ee97c17fb84ad48da3b2902d3b0953a357f6d0b9720c117474ea2bdf3cc9212645403f6ed94f8106cfb2db4b755ae15c3652721a108654fff81c06379fd092794dea8455019212cd25a983146cb8472049bba75d9a4e5777484c4360dabc233d6fa4c9923a

val (hash, key)

Check if a hash is valid by decrypting dummy text.

Params

| Name | Type | Description | | ---- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- | | hash | string | This is the hash to match against, simply try to decrypt this hash into the dummy text and check if the decryption was successful. | | key | string | This key will be used to decrypt the hash into dummy text. |

Returns

string

Example

AESWrapper.val('c6ae556bd9a4d728f061ff66cd196e96e00792810061a528db8f4f74f229c60dc9bfc837fbe447eadb7c6353ffce18983849c70ffc7ac754ee3d2502ddc148827032ea83741d9647a6a2e8921cb1800c192381fe42d357de64d397c4e10c0b2eeee18d2255a7817cb36bb9ee97c17fb84ad48da3b2902d3b0953a357f6d0b9720c117474ea2bdf3cc9212645403f6ed94f8106cfb2db4b755ae15c3652721a108654fff81c06379fd092794dea8455019212cd25a983146cb8472049bba75d9a4e5777484c4360dabc233d6fa4c9923a', 'Hello World')
// true

getRandomBytes (length)

This is used to get a random IV, this also makes the encryption uniqe and very secure.

Params

| Name | Type | Description | | ------ | ------ | --------------------------------------------------- | | length | number | This defines how many bytes that will be generated. |

Returns

Buffer

hex (buffer)

This turns a buffer into a string

Params

| Name | Type | Description | | ------ | ------ | ----------------------------------------------- | | buffer | Buffer | The buffer to encode into a hex formatted text. |

Returns

string

buffer (hex)

Decode HEX into a buffer.

Params

| Name | Type | Description | | ---- | ------ | ----------------------- | | hex | string | The hex data to decode. |

Returns

Buffer

md5 (text)

Hash text into a md5 hash.

Params

| Name | Type | Description | | ---- | ------ | -------------------------------- | | text | string | The text to hash to an MD5 hash. |

Returns

string

Example

AESWrapper.md5('hello world')
// '5EB63BBBE01EEED093CB22BB8F5ACDC3'