View on
Nguon Hao Ching > Apache2-AuthzNIS-0.13 > Apache2::AuthzNIS



Annotate this POD


New  2
Open  0
View/Report Bugs
Module Version: 0.13   Source  


Apache2::AuthzNIS - mod_perl2 NIS Group Authorization module


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

    # The following is actually only needed when you will authenticate
    # via NIS passwd as well as authorize via NIS group.
    # Apache2::AuthenNIS is a separate module.
    PerlAuthenHandler Apache2::AuthenNIS

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

    PerlAuthzHandler Apache2::AuthzNIS


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


This perl module is designed to work with mod_perl, the Net::NIS module by Rik Haris (, and the Apache2::AuthenNIS module. Version 0.11 of Apache::AuthzNIS was renamed and modified to use mod_perl2. That module was a direct adaptation of Michael Parker's ( Apache::AuthenSmb module (which also included an authorization routine).

The module calls Net::NIS::yp_match using each of the require group elements as keys to the the group.byname map, until a match with the (already authenticated) user is found.

For completeness, the module also handles require user and require valid-user directives.

Apache2::AuthenNIS vs. Apache2::AuthzNIS

The following comments are from Apache::AuthzNIS.

I've taken "authentication" to be meaningful only in terms of a user and password combination, not group membership. This means that you can use Apache::AuthenNIS with the require user and require valid-user directives. In the NIS context I consider require group to be an "authorization" concern. I.e., Group authorization consists of establishing whether the already authenticated user is a member of one of the indicated groups in the require group directive. This process may be handled by Apache::AuthzNIS.



This is the mod_perl2 handler function.


To install this module, run the following commands:

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


Demetrios E. Paneras <dep at>

Ported to mod_perl by Shannon Eric Peevey <speeves at>

Ported to mod_perl2 by Nguon Hao Ching <hao at>


Please report any bugs or feature requests to bug-apache2-authznis at, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


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

    perldoc Apache2::AuthzNIS

You can also look for information at:


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: