HSMR

HSMR is a collection of cryptographic commands usually implemented on a HSM (Hardware Security Module). These are implemented for your education or for testing purposes and should not be used to replace an actual HSM.

Installation

One day I'll learn how to make gems. Until then, git clone is the only way to use this softawre.

Usage

require './lib/hsmr'
require './lib/key'
require './lib/component'

# Create a Key
> key=HSMR::Key.new("4CA2161637D0133E5E151AEA45DA2A12")
=> 4CA2 1616 37D0 133E 5E15 1AEA 45DA 2A12 
> key.key
=> "L\xA2\x16\x167\xD0\x13>^\x15\x1A\xEAE\xDA*\x12" 
> key.to_s
=> "4CA2 1616 37D0 133E 5E15 1AEA 45DA 2A12" 
> key.kcv
=> "7B0898" 
> key.parity
=> "odd" 

# Generate a PVV

pan="5999997890123412"
pin="1234"
pvki="1"
pvv = HSMR.pvv(key, pan, pvki, pin)
=> "0798"

Features

• Key / Componet features
  • Create Keys and Components
  • XOR Keys and Components together
  • Find Key Check Values (kcv)
  • Determine and change key parity
• Encrypt / Decrypt PIN Blocks
• Generate IBM3624 PINs
• Generate PVV, CVV & CVV2 values

Development

• Source hosted on GitHub.
• Report issues on GitHub Issues.
• Pull requests are awesome! Please include test::unit tests

Author

Dan Milne, http://da.nmilne.com, http://booko.com.au

Copyright

Copyright (c) 2010 Dan Milne. See LICENSE for details.