opsmekanix/authen-krb5-effortless

Authen::Krb5::Effortless is a subclass of Authen::Krb5, adding 'Effortless' ways to authenticate against a Kerberos Domain Controller

Authen-Krb5-Effortless

This module is a subclass to Authen::Krb5, and adds an 'Effortless' interface to authenticate against a Kerberos Domain Control server.
It's intention is to provide a kinder means of integrating Kerberos tickets with your application. While there is Authen::Krb5::Simple, Authen::Krb5::Simple doesn't support keytab authentication.

As I really needed both passphrase and keytab authentication, I wrote a module to subclass Authen::Krb5. After releasing this module to CPAN, I became aware of Authen::Krb5::Easy and that it supports keytab for authentication. I still belive Authen::Krb5::Effortless has merit as it combines both keytab and passphrase authentication in a single module.

REQUIREMENETS

Carp is used for warnings and errors. Authen::Krb5 needs to be installed as this is a subclass.
In addition, I'm using the parent pragma introduced with perl 5.10.1. One can download the 'parent' module from CPAN if using earlier versions of perl.

INSTALLATION

To install this module, run the following commands:

perl Build.PL
./Build
./Build test
./Build install

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the perldoc command.

perldoc Authen::Krb5::Effortless

You can also look for information at:

Bugs and feature requests
    https://github.com/opsmekanix/Authen-Krb5-Effortless/issues

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/

LICENSE AND COPYRIGHT

Copyright (C) 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.

authen-krb5-effortless's Issues

Fix tests so this can get turned into into a cpan module.

Need to fix 't' tests so I can actually build a package. These existing tests are the basic ones added by 'module-starter'.

-=-=-=-=-=-
-bash-4.2$ perl Build.PL 
Created MYMETA.yml and MYMETA.json
Creating new 'Build' script for 'Authen-Krb5-Effortless' version '0.01'
-bash-4.2$ ./Build test
t/00-load.t ....... 1/1 # Testing Authen::Krb5::Effortless 0.01, Perl 5.014003, /usr/bin/perl
t/00-load.t ....... ok   
t/boilerplate.t ... ok   
t/manifest.t ...... skipped: Author tests not required for installation
t/pod-coverage.t .. 1/1 
#   Failed test 'Pod coverage on Authen::Krb5::Effortless'
#   at /usr/share/perl5/vendor_perl/Test/Pod/Coverage.pm line 126.
# Coverage for Authen::Krb5::Effortless is 0.0%, with 5 naked subroutines:
#       clear_cache
#       fetch_TGT_KEYTAB
#       fetch_TGT_PW
#       new
#       read_cache
# Looks like you failed 1 test of 1.
t/pod-coverage.t .. Dubious, test returned 1 (wstat 256, 0x100)
Failed 1/1 subtests 
t/pod.t ........... ok   

Test Summary Report
-------------------
t/boilerplate.t (Wstat: 0 Tests: 3 Failed: 0)
  TODO passed:   3
t/pod-coverage.t (Wstat: 256 Tests: 1 Failed: 1)
  Failed test:  1
  Non-zero exit status: 1
Files=5, Tests=6,  1 wallclock secs ( 0.01 usr  0.01 sys +  0.09 cusr  0.01 csys =  0.12 CPU)
Result: FAIL
Failed 1/5 test programs. 1/6 subtests failed.
-=-=-=-=-=-