NAME

Gantry::Control::C::Access - Authentication by IP

DESCRIPTION

This is an Authentication module against an IP range.

APACHE

This is the minimum configuration to set up Authen on a location, it is probably more usefull with Authz on and the App based authz handlers turned on as well. The "auth_allow_ranges" takes ranges of ip address in cidr notation comma seperated. The "auth_allow_ips" takes single ip addresses seperated by commas. The "auth_ignore_access_handler" allows the access not to over ride authen and authz if needed, set to 1 not to override do not set if you want the override to happen.

  <Location / >
    
    PerlSetVar  auth_allow_ranges  "192.168.1.0/24,192.168.2.0/24"
    PerlSetVar  auth_allow_ips     "127.0.0.1" 
    PerlSetVar  auth_ignore_access_handler  1 

    AuthType Basic
    AuthName "My Auth Location"

    PerlAccessHandler   Gantry::Control::C::Access

    require valid-user
 </Location>

DATABASE

No database is specfically required for this module.

METHODS

handler: The mod_perl access handler.
ip2bin: For internal use.

LIMITATIONS

It only checks against the IP addresses and users table and only provides yes/no access. For more granuality check out the Authz handlers to turn on as well.

AUTHOR

Tim Keefer <tkeefer@gmail.com>

COPYRIGHT

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.