Lita handler for TOTP & HOTP token generation; uses Ruby One-Time Password (ROTP) library
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
locales
spec
.gitignore
.rspec
.rubocop.yml
.travis.yml
Gemfile
LICENSE
README.md
Rakefile
lita-rotp.gemspec

README.md

lita-rotp

Build Status Code Climate Coverage RubyGems :: lita-rotp Gem Version Apache 2.0 License

Copyright 2014 PagerDuty, Inc.

Lita handler for TOTP & HOTP token generation; uses Ruby One-Time Password (ROTP) library.

We use plenty of external services that require you to share a login while supporting two-factor authentication. There are plenty of tools available to share passwords, but nothing great for sharing/generating TOTP tokens. This handler was built so that you can store your shared account secrets in your Lita config and generate two-factor auth tokens using Lita.

NOTE: The secrets you store in the configuration file should be treated as secret. No others should be able to see them. Consider making the read permissions of your Lita configuration file very restrictive (so that only the user running Lita should be able to see the contents)

INSTALLATION

Add lita-rotp to your Lita instance's Gemfile:

gem 'lita-rotp', '~> 0.1'

LICENSE

lita-rotp is released under the Apache License 2.0. The full text of the license canbe found in the LICENSE file. The summary can be found here courtesy of tldrlegal.

CONFIGURATION

lita-rotp uses a Hash of key pairs to get the secrets:

config.handlers.rotp.secret_pairs = { tim: '4QGNYPZ7OSBHCWWL', heckman: 'IR5IYN4G5HB66BOA' }

You then use the name heckman to use the secret for heckman.

USAGE

> totp heckman
596049

# or

> hotp tim 42
368274

# or

> token heckman
386015

> token tim 42
549634