Installation

Simply, put the following line into your HTML code:

<script type="text/javascript" src="passpack.js"></script>

Reference

Passpack.encode(algorithm,plaintext[,key,optionalPars])

To encode the string str with the key mykey using AES 256-bit use:

Passpack.encode("AES",str,mykey)

By default the result of the encryption is Base64-encoded. To change the default settings you can use optionalPars. They must be as the following:

  {
    nbits:  128,
    escape: true
  }

For example, to encode the string str using AES 192-bit, without Base64 encoding you have to run:

  Passpack.encode("AES",str,mykey,{
    nbits:    192,
    noBase64: true
  });

Supported algorithms:

• UTF8
• Base64+ (this replace all '+' with '!' to avoid problems with post XMLHTTPRequest)
• AES (128, 192 or 256-bit)
• xxTEA
• RC4 (modified to improve security)

Optional parameters:

• nbits : number of bits, if applicable
• noBase64 : disable Base64 encoding of encrypted string
• escape : escape the encrypted string (after Base64 encoding)
• rounds : number of rounds in RC4

Passpack.UTF8 and Passpack.Base64 are based on Utf8 and Base64 scripts by WebToolkit. Passpack.AES and Passpack.xxTEA are based on Chris Veness's AES and BlockTEA implementations.

Passpack.decode(algorithm,plaintext[,key,optionalPars])

Works similar to encode with the same Optional pars, except:

• unescape - Unescape encryptedText before decrypting it.
• escape - does not exist (not needed)

Passpack.JSON.parse(jsonString)

The Passpack.JSON static object is a variation of the Douglas Crockford JSON object defined in json2.js library. In addition to the original method, the parse method adds automatic conversion of date strings from the ISO format into Date objects. To parse a JSON string:

Passpack.JSON.parse(jsonStr);

If you are considering developing a Passpack compatible application, you will need this JSON variant in order to properly manage dates.

Passpack.JSON.stringify(object)

The Crockford JSON method to convert an Object into a JSON string.

Passpack.utils.getBits(password)

Returns the estimated value in bits of a password.

Passpack.utils.passGenerator(pars,numberOfChars)

Generates a random password. pars specifies the character interval to be used.

• lcase: lower case letters
• ucase: upper case letters
• nume: numbers
• symb: symbols
• space: high ascii chars

For example, to generate a random password of 16 characters, using letters and high ascii chars:

  Passpack.utils.passGenerator({
    ucase: 1,
    lcase: 1,
    space: 1
  }, 16);

Passpack.utils.simplePassGenerator(numberOfChars)

Generates a password using letters and numbers.

Passpack.utils.genRandomKey([size,salt])

Generates a hashed key of size chars, using an optional salt. By default generates a 256-bit key (64 chars). If you need longer key, you can concatenate two or more 256-bit keys. For example, to achieve a 512-bit key, concatenate two 256-bit keys.

Passpack.utils.hashx(str[,nohex,full])

Make a modified hash using SHA256.

nohex produces a standard string instead of an hexadecimal string. full produces a 64 char strings, instead of a default 32 char modified string

Passpack.SHA256 is based on Angel Marin's SHA-256.

Enjoy Passpack Host-Proof Hosting