Free apache2 software for linux

Apache2::Pod is a Perl base class for converting Pod files to prettier forms.

SYNOPSIS

The Apache2::Pod::* are mod_perl handlers to easily convert Pod to HTML or other forms. You can also emulate perldoc.

FUNCTIONS

No functions are exported. I dont want to dink around with Exporter in mod_perl if I dont need to.

getpodfile( $r )

Returns the filename requested off of the $r request object, or what Perldoc would find, based on Pod::Find.

resolve_modname( $r )

Returns a module name based on $r->path_info.

getpodfuncdoc( $file, $function_name )

Given the full filepath of the perlfunc pod file and a function name, returns the section of that pod document pertaining to the function. If the function is not found, returns a pod document phrase stating so.

Apache2::SiteMap is a Perl module that can dynamically create Google SiteMap files.

SYNOPSIS

Create a Google SiteMap much like a mod_dir listing.
< Location "/sitemap.xml" >
SetHandler modperl
PerlHandler Apache2::SiteMap
PerlSetVar SiteMapBase http://host/
PerlSetVar SiteMapDir /path/to/dir
< /Location >

< Location "/music/sitemap.xml" >
SetHandler modperl
PerlHandler Apache2::SiteMap
PerlSetVar SiteMapBase http://host/archives/
PerlSetVar SiteMapDir /path/to/archives/dir
< /Location >

Apache2::JSONRPC is a mod_perl handler for JSONRPC.

SYNOPSIS

< Location /json-rpc >
SetHandler perl-script
PerlOptions +GlobalRequest
PerlResponseHandler Apache2::JSONRPC->handler
JSONRPC_Class CGI::JSONRPC::Dispatcher
< /Location >

Apache2::JSONRPC is a subclass of CGI::JSONRPC that provides some extra bells and whistles in a mod_perl2 environment.
Currently, the main feature is the "JSONRPC_Class" apache2 config directive, which allows you to define what class to use for invoking JSONRPC methods. The default is the same as CGI::JSONRPC uses, CGI::JSONRPC::Dispatcher.

Apache2::PageKit is a MVCC web framework using mod_perl, XML and HTML::Template.

SYNOPSIS

In httpd.conf
SetHandler perl-script
PerlSetVar PKIT_ROOT /path/to/pagekit/files
PerlSetVar PKIT_SERVER staging

PerlHandler +Apache2::PageKit

Apache2::PageKit->startup(/path/to/pagekit/files, staging);

In MyPageKit/Common.pm
package MyPageKit::Common;

use base Apache2::PageKit::Model;

sub pkit_dbi_connect {
return DBI->connect("DBI:mysql:db","user","passwd");
}

sub pkit_session_setup {
my $model = shift;
my $dbh = $model->dbh;
return {
session_lock_class => MySQL,
session_store_class => MySQL,
session_args => {
Handle => $dbh,
LockHandle => $dbh,
},
};
}

sub pkit_auth_credential {
my ($model) = @_;

# in this example, login and passwd are the names of the credential fields
my $login = $model->input(login);
my $passwd = $model->input(passwd);

# create a session key
# your code here.........

return $ses_key;
}

sub pkit_auth_session_key {
my ($model, $ses_key) = @_;

# check whether $ses_key is valid, if so return user id in $user_id
# your code here.........

return $ok ? $user_id : undef;
}

PageKit is an mod_perl based application framework that uses HTML::Template and XML to separate code, design, and content. Includes session management, authentication, form validation, co-branding, and a content management system.

Its goal is to solve all the common problems of web programming, and to make the creation and maintenance of dynamic web sites fast, easy and enjoyable.
You have to write a module named MyPageKit::Common that inherits from Apache2::PageKit::Model and provides methods common across the site. For example, if you wish to support authentication, it must include the two methods pkit_auth_credential and pkit_auth_session_key.

Apache2::AuthenMSAD is a Perl module with Microsoft Active Directory authentication for Apache.

SYNOPSIS

< Directory /foo/bar >
# Authentication Realm and Type (only Basic supported)

AuthName "Microsoft Active Directory Authentication"
AuthType Basic

# Authentication method/handler

PerlAuthenHandler Apache2::AuthenMSAD

# The Microsoft Active Directory Domain Name must be set
# The Active Directory Server Name will default to the domain.

PerlSetVar MSADDomain ads.foo.com
PerlSetVar MSADServer dc.ads.foo.com

# Require lines can be any of the following -- any user, one of a list

require valid-user
require user joe mary tom
< /Directory >

These directives can also be used in a .htaccess file.

This perl module is designed to work with mod_perl2 and Net::LDAP. It will authenticate users in a Windows 2000 or later Microsoft Active Directory -- hence the acronym MSAD. Configuration parameters give the DNS name used for the cluster of Microsoft Domain Controllers and the Microsoft Domain name used within the Active Directory.

This relies on a surprising feature first brought to our attention by Yvan Rodrigues here at the University of Waterloo. You can authenticate with a Distinguished Name like "reggers@ads.foo.com" (ie. the userPrincipalName in the Active Directory) and you dont need to resort to the X509 Distinguished Name. Most LDAP authentication methods require a guest account where you can login to find the users Distinguished Name and then login again as that name. Active Directory has this extra feature which makes life much simpler.

At our site the domain mentioned in the userPrincipalName is "ads.uwaterloo.ca" -- that is also the name we use for our collection of Domain Controllers. You might not implement that convention. If you do the MSADServer parameter is optional -- it defaults to the MSADDomain.This version is patched to use mod_per2 (>=2.0x) and apache2. It was tested in an production environment to work perfectly.

Apache2::Autocomplete is a Perl module to autocomplete service backend via mod_perl.

SYNOPSIS

Given some form that using Googles autocomplete that receives suggestions from http://localhost/complete/search:

######################################################
# in httpd.conf
PerlModule Apache2::MyAutoComplete
< Location /complete/search >
SetHandler perl-script
PerlResponseHandler Apache2::MyAutoComplete
< /Location >
######################################################

######################################################
# module file Apache2/MyAutoComplete.pm
package Apache2::MyAutoComplete;
use base qw(Apache2::Autocomplete);
# use whatever else

my @NAMES = qw(bob carol ted alice);
sub expand {
my ($self, $query) = @_;
my $re = qr/^Q$queryE/i;
my @names = grep /$re/, @NAMES;
my @values = map {"some description"} @names;
(lc $query, @names, @values, [""]);
}

sub handler {
my $r = shift;
my $ac = __PACKAGE__->new($r);
$ac->run();
return Apache2::Const::OK;
}
######################################################

This module is a mod_perl2 interface to JavaScript::Autocomplete::Backend, which is a base class for implementing an autocomplete service for a form using the Google Suggest protocol. See http://www.google.com/webhp?complete=1&hl=en for an illustration of Google Suggest in operation, as well as http://serversideguy.blogspot.com/2004/12/google-suggest-dissected.html for a description of how the JavaScript code works.

As well as mod_perl2, this package requires JavaScript::Autocomplete::Backend, as well as a CGI.pm-compatible CGI module for supplying the param() and header() methods. If available, CGI::Apache2::Wrapper will be used, which is a minimal module that uses methods of mod_perl2 and Apache2::Request to provide these methods; if this is not available, CGI (version 2.93 or greater) will be used.

Operation of this service requires inclusion of the Autocomplete JavaScript code; a copy of this is included in this distribution, the latest version of which is available at http://www.google.com/ac.js.

Apache2::AuthNetLDAP is a mod_perl module that uses the Net::LDAP module for user authentication for Apache.

SYNOPSIS

AuthName "LDAP Test Auth"
AuthType Basic

#only set the next two if you need to bind as a user for searching
#PerlSetVar BindDN "uid=user1,ou=people,o=acme.com" #optional
#PerlSetVar BindPWD "password" #optional
PerlSetVar BaseDN "ou=people,o=acme.com"
PerlSetVar LDAPServer ldap.acme.com
PerlSetVar LDAPPort 389
#PerlSetVar UIDAttr uid
PerlSetVar UIDAttr mail
#PerlSetVar AlternatePWAttribute alternateAttribute
#PerlSetVar SearchScope base | one | sub # default is sub
#PerlSetVar LDAPFilter "(&(course=CSA)(class=A))" #optional

# Set if you want to encrypt communication with LDAP server
# and avoid sending clear text passwords over the network
PerlSetVar UseStartTLS yes | no

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

require valid-user

PerlAuthenHandler Apache2::AuthNetLDAP

This module authenticates users via LDAP using the Net::LDAP module. This module is Graham Barrs "pure" Perl LDAP API.

It also uses all of the same parameters as the Apache::AuthPerLDAP, but I have added four extra parameters.

The parameters are:

PerlSetVar BindDN

Used to set initial LDAP user.

PerlSetVar BindPWD

Used to set initial LDAP password.

PerlSetVar BaseDN

This sets the search base used when looking up a user in an LDAP server.

PerlSetVar LDAPServer

This is the hostname of the LDAP server you wish to use.

PerlSetVar LDAPPort

This is the port the LDAP server is listening on.

PerlSetVar UIDAttr

The attribute used to lookup the user.

PerlSetVar AlternatePWAttribute

The an alternate attribute with which the $password will be tested. This allows you to test with another attribute, instead of just trying to bind the userdn and password to the ldap server.

If this option is used, then a BindDN and BindPWD must be used for the initial bind.

PerlSetVar AllowAlternateAuth

This attribute allows you to set an alternative method of authentication (Basically, this allows you to mix authentication methods, if you dont have all users in the LDAP 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.

PerlSetVar SearchScope

Optional. Can be base, one or sub. Default is sub. Determines the scope of the LDAP search.

PerlSetVar LDAPFilter

This is an LDAP filter, as defined in RFC 2254. This is optional. If provided, it will be ANDed with the filter that verifies the UID. For example, if you have these set:

PerlSetVar UIDAttr uid

PerlSetVar LDAPFilter "(&(course=41300)(year=3)(classCode=Y))"

and a user authenticates with the username "nicku" then the following filter will be generated to search for the entry to authenticate against:

(&(&(course=41300)(year=3)(classCode=Y))(uid=nicku))

This will then allow nicku access only if nickus LDAP entry has the attribute course equal to 41300, the attribute year equal to 3, and attribute classCode equal to Y. And of course, if the password is correct. This may be useful for restricting access to a group of users in a large directory, e.g., at a university.

PerlSetVar UseStartTLS

Optional; can be yes or no. If yes, will fail unless can start a TLS encrypted connection to the LDAP server before sending passwords over the network. Note that this requires that the optional module IO::Socket::SSL is installed; this depends on Net::SSLeay, which depends on openssl. Of course, the LDAP server must support Start TLS also.