Authen::Krb5::Effortless - This module is a subclass to Authen::Krb5, adding 'Effortless' ways to authenticate against a Kerberos Domain Controller.
Version 0.02
Authen::Krb5::Effortless is more then a 'Simple' module, as it supports both pass-phrase and key-tab based authorization.
A keytab example:
use Authen::Krb5::Effortless; my $username = getlogin(); my $keytab = "/path/to/my/keytab"; my $krb5 = Authen::Krb5::Effortless->new(); $krb5->fetch_TGT_KEYTAB($keytab, $username);
A password example:
use Authen::Krb5::Effortless; my $username = getlogin(); my $krb5 = Authen::Krb5::Effortless->new(); $krb5->fetch_TGT_PW('sekret_phss_wurd', $username);
A example for reading cache:
use Authen::Krb5::Effortless; my $krb5 = Authen::Krb5::Effortless->new(); $krb5->read_cache(); if ($krb5->{'cache_present'}) { print $krb5->{'principal'}, "\n"; }
A example for deleting the cache:
use Authen::Krb5::Effortless; my $krb5 = Authen::Krb5::Effortless->new(); $krb5->clear_cache();
Authen::Krb5 needs to be installed for this module to work. In addition, because I'm using a pragma introduced with perl 5.10.1, I am requireing the use of perl 5.10.1 or newer.
Adam Faris, <authen-krb5-effortless at mekanix dot org>
<authen-krb5-effortless at mekanix dot org>
Bugs are tracked at github. Please report any bugs to https://github.com/opsmekanix/Authen-Krb5-Effortless/issues
You can find documentation for this module with the perldoc command.
perldoc Authen::Krb5::Effortless
You can also look for information at:
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Authen-Krb5-Effortless
CPAN Ratings
http://cpanratings.perl.org/d/Authen-Krb5-Effortless
Search CPAN
http://search.cpan.org/dist/Authen-Krb5-Effortless/
I would like to acknowledge Jeff Horwitz, Doug MacEachern, Malcolm Beattie, and Scott Hutton for their work on Authen::Krb5.
Copyright 2013 Adam Faris.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
L<http://www.apache.org/licenses/LICENSE-2.0>
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
To install Authen::Krb5::Effortless, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Authen::Krb5::Effortless
CPAN shell
perl -MCPAN -e shell install Authen::Krb5::Effortless
For more information on module installation, please visit the detailed CPAN module installation guide.