mirror of
https://github.com/dkam/hsmr.git
synced 2025-12-28 08:44:53 +00:00
59 lines
1.3 KiB
Markdown
59 lines
1.3 KiB
Markdown
HSMR [](http://travis-ci.org/dkam/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
|
|
-------------
|
|
|
|
gem install hsmr
|
|
|
|
Usage
|
|
---------
|
|
|
|
require 'hsmr'
|
|
|
|
# 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
|
|
|
|
License
|
|
|
|
The gem is available as open source under the terms of the MIT License. |