View on
MetaCPAN
Nguon Hao Ching > Apache2-AuthenNIS-0.15 > Apache2::AuthenNIS

Download:
Apache2-AuthenNIS-0.15.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  3
Open  0
View/Report Bugs
Module Version: 0.15   Source  

NAME ^

Apache2::AuthenNIS - mod_perl2 NIS Authentication module

VERSION ^

Version 0.14

SYNOPSIS ^

    <Directory /foo/bar>
    # This is the standard authentication stuff
    AuthName "Foo Bar Authentication"
    AuthType Basic

    PerlAuthenHandler Apache::AuthenNIS

    # Set if you want to allow an alternate method of authentication
    PerlSetVar AllowAlternateAuth yes | no

    # Standard require stuff, NIS users or groups, and
    # "valid-user" all work OK
    require user username1 username2 ...
    require valid-user

    # The following is actually only needed when authorizing
    # against NIS groups. This is a separate module.
    PerlAuthzHandler Apache::AuthzNIS

    </Directory>

    These directives can also be used in the <Location> directive or in
    an .htaccess file.

DESCRIPTION ^

This perl module is designed to work with mod_perl2 and the Net::NIS module by Rik Haris (rik.harris@fulcrum.com.au). Version 0.13 of Apache::AuthenNIS was renamed and modified to use mod_perl2. That module was a direct adaptation of Michael Parker's (parker@austx.tandem.com) Apache::AuthenSmb module.

The module uses Net::NIS::yp_match to retrieve the "passwd" entry from the passwd.byname map, using the supplied username as the search key. It then uses crypt() to verify that the supplied password matches the retrieved hashed password.

Parameters

PerlSetVar AllowAlternateAuth

This attribute allows you to set an alternative method of authentication (Basically, this allows you to mix authentication methods, if you don't have all users in the NIS database). It does this by returning a DECLINE and checking for the next handler, which could be another authentication, such as Apache-AuthenNTLM or basic authentication.

Functions

handler

This is the mod_perl2 handler function.

INSTALLATION ^

To install this module, run the following commands:

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

AUTHOR ^

Demetrios E. Paneras, <dep at media.mit.edu>

Ported to mod_perl by Shannon Eric Peevey, <speeves at unt.edu>

Ported to mod_perl2 by Nguon Hao Ching, <hao at iteaha.us>

BUGS ^

Please report any bugs or feature requests to bug-apache2-authennis at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Apache2-AuthenNIS. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT & DOCUMENTATION ^

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

    perldoc Apache2::AuthenNIS

You can also look for information at:

COPYRIGHT & LICENSE ^

Copyright (c) 1998 Demetrios E. Paneras, MIT Media Laboratory.

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

syntax highlighting: