NAME

VisualDreams::Yubikey::online - Yubikey online authentication

DESCRIPTION

This module will authenticate with the online Yubico API authentication server and return its results in a HASH. This module is to be implemented in the VisualDreams engine.

VERSION

Version 0.04

SYNOPSIS

  use VisualDreams::Yubikey::online;

  my $yubify = VisualDreams::Yubikey::online->new("ID","Base64 encoded API key");

  my $yubirecord = $yubify->verifyOnline($otp);

  my $url = $yubify->createUrl($otp);
  my $signedurl = $yubify->createSignedUrl($otp);
  my $signUrl = $yubify->signUrl($url);

FUNCTIONS

new

Input : API-ID and API-KEY

Initializes the module to standard API-ID, API-KEY and API-URL. WARNING: Signed messages will automagically work with a valid Base-64 API key!

signUrl

Signs the URL with API-ID, API-KEY and incoming url

Input : url Output : signed base-64 encoded hmac

createUrl

Create standard URL with API-ID and OTP

Input : otp Output : piece of url containing id and otp

createSignedUrl

Create Signed URL with API-ID, API-KEY and OTP

Input : otp Output : piece of url containing id, otp and base-64 hmac signature

verifyOnline

Verify the OTP with the Yubico server

Input : otp Output : record with hmac, status and timestamp

REQUIRES

Perl 5, Digest::HMAC_SHA1, LWP::Simple, MIME::Base64, URI::Escape

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc VisualDreams::Yubikey::online

EXPORT

None by default.

AUTHOR

Gunther Voet, Freaking Wildchild: <oss@xsrv.net> and <gunther.voet@gmail.com>

VisualDreams

Specifically created for the VisualDreams engine. More to come soon!

COPYRIGHT & LICENSE

Copyright 2008 Gunther Voet, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.