Skip to content

Ruby wrapper for VASCO Vacman Controller AAL2SDK library

License

Notifications You must be signed in to change notification settings

ifad/vacman_controller

This branch is 103 commits ahead of mlankenau/vacman_controller:master.

Folders and files

NameName
Last commit message
Last commit date
Apr 16, 2019
Apr 30, 2024
Apr 30, 2024
May 22, 2019
Sep 24, 2019
Apr 16, 2019
Apr 16, 2019
Jan 4, 2019
Apr 4, 2019
Apr 14, 2019
Apr 30, 2024
Apr 14, 2019
Apr 30, 2024

Repository files navigation

VASCO VACMAN Controller

Build status Code Climate Test Coverage Gem Version Docs analysis

VACMAN Controller is VASCO's implementation of OTP physical and virtual devices, revolving around the AAL2 library.

This gem contains a very thin wrapper around AAL2 and allows to parse DPX files, generate OTPs and verify them.

Installation

Get Vacman Controller library from VASCO. You should receive an aal2sdk-*.rpm package. Install it, it will place its contents in /opt/vasco. The Ruby extension looks for /opt/vasco/VACMAN_Controller-*

Add to your application Gemfile

gem 'vacman_controller'

To run specs download the sources and execute

rake

Usage

The library provides access to the low-level functions of libaal2 through the VacmanController::LowLevel module, that has only singleton methods and does not keep any state.

The only shared state across all threads are the kernel params. Please ensure that all threads coordinate when changing it.

The library provides also a VacmanController::Token abstraction, providing token information and APIs that decode from and to Ruby objects when reading and writing.

Ensure to persist the token.to_h value after performing any operation on a token. The token hash contains the token state, that is altered by most APIs.

For extended usage examples, please have a look at the specs.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some great feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

About

Ruby wrapper for VASCO Vacman Controller AAL2SDK library

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 56.1%
  • C 38.2%
  • Shell 4.7%
  • Dockerfile 1.0%