NAME¶

Apache2_4::AuthCookieDBI - A subclass of Apache2::AuthCookieDBI that implements a "group" authorization provider for Apache 2.4.x.

SYNOPSIS¶

 # In httpd.conf or .htaccess:
 #   Configure as you would with Apache2::AuthCookieDBI, but leave out
 #   the PerlAuthzHandler directive and add the following when using
 #   "require group":
 PerlModule Apache2_4::AuthCookieDBI
 PerlAddAuthzProvider group Apache2_4::AuthCookieDBI->group
 <Location /www/domain.com/authcookiedbi/admin>
   require group admin
 </Location>

DESCRIPTION¶

Apache2_4::AuthCookieDBI provides an Apache 2.4.x-compatible authorization provider for handling "group" authorization requirements.

This module is a subclass of Apache2::AuthCookieDBI. All the methods for Apache2::AuthCookieDBI still work for this module as well. The only method that this class overrides is "group".

This module is for mod_perl version 2 and Apache version 2.4.x. If you are running Apache 2.0.0-2.2.x, refer to Apache2::AuthCookieDBI.

Make sure your mod_perl is at least 2.0.9, with StackedHandlers, MethodHandlers, Authen, and Authz compiled in.

HISTORY¶

The implementation herein is based on Apache2::AuthCookieDBI's "group" method with heavy inspiration from the sample "authz_handler" in Apache2_4::AuthCookie by Michael Schout. Huge thanks to Michael Schout for his documentation on the changes to authorization under Apache 2.4.x.

COPYRIGHT¶

 Copyright (C) 2002 SF Interactive
 Copyright (C) 2003-2004 Jacob Davies
 Copyright (C) 2004-2019 Matisse Enzer

LICENSE¶

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

CREDITS¶

  Original Author: Jacob Davies
  Incomplete list of additional contributors (alphabetical by first name):
    Carl Gustafsson
    Chad Columbus
    Edward J Sabol
    Jay Strauss
    Joe Ingersoll
    Keith Lawson
    Lance P Cleveland
    Matisse Enzer
    Nick Phillips
    William McKee

MAINTAINER¶

Matisse Enzer

        <matisse@cpan.org>

SEE ALSO¶

 Latest version: http://search.cpan.org/dist/Apache2-AuthCookieDBI
 Apache2::AuthCookie - http://search.cpan.org/dist/Apache2-AuthCookie
 Apache2::Session    - http://search.cpan.org/dist/Apache2-Session
 Apache::AuthDBI     - http://search.cpan.org/dist/Apache-DBI