Authen::TypeKey - TypeKey authentication verification
use CGI; use Authen::TypeKey; my $q = CGI->new; my $tk = Authen::TypeKey->new; my $res = $tk->verify($q) or die $tk->errstr;
Authen::TypeKey is an implementation of verification for signatures generated by TypeKey authentication. For information on the TypeKey protocol and using TypeKey in other applications, see http://www.movabletype.org/docs/tk-apps.html.
Create a new Authen::TypeKey object.
Verify a TypeKey signature based on the other parameters given. The signature and other parameters are found in the $query object, which should be any object that supports a param method--for example, a CGI or Apache::Request object.
If the signature is successfully verified, verify returns a reference to a hash containing the following values.
name
The unique username of the TypeKey user.
nick
The user's display name.
email
The user's email address. If the user has chosen not to pass his/her email address, this will contain the SHA-1 hash of the string mailto:<email>.
mailto:<email>
ts
The timestamp at which the signature was generated, expressed as seconds since the epoch.
If verification is unsuccessful, verify will return undef, and the error message can be found in $tk->errstr.
undef
$tk->errstr
Get/set the path to a local file where the TypeKey public key (at $tk->key_url) should be cached/mirrored. If this is unset, the key is not cached. By default, this is set to the empty string.
$tk->key_url
Get/set a value indicating whether verify should check the expiration date and time in the TypeKey parameters. The default is to check the expiration date and time.
Get/set the amount of time at which a TypeKey signature is intended to expire. The default value is 600 seconds, i.e. 10 minutes.
Get/set the URL from which the TypeKey public key can be obtained. The default URL is http://www.typekey.com/extras/regkeys.txt.
Authen::TypeKey is free software; you may redistribute it and/or modify it under the same terms as Perl itself.
Except where otherwise noted, Authen::TypeKey is Copyright 2004 Six Apart Ltd, cpan@sixapart.com. All rights reserved.
To install Authen::TypeKey, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Authen::TypeKey
CPAN shell
perl -MCPAN -e shell install Authen::TypeKey
For more information on module installation, please visit the detailed CPAN module installation guide.