Information
***********

mod_access_referer Module for the Apache HTTP Server

This is an module for the Apache HTTP Server that provides access control based
on "Referer" HTTP header content. 

Read the file 'LICENSE.txt' for the terms under which this program is
distributed.

Version 1.0.0 should work with Apache HTTP Server Version 1.3 at least.

For documentation about the module itsef, read the file
'mod_access_referer.html'.


To compile
**********

Just run 'make'.

To compile and install, it's necessary to have the Apache program 'apxs' in the
PATH. Such program is installed by Apache (or in the apache-devel packages, if
you are using RedHat or something close). You will need the Apache include
headers, a C compiler and C libraries too, as usual.


To install
**********

Just run 'make install'. And restart your Apache Web server.

This will add two lines into your apache configuration file, in order to load
the module when the Web server starts.

Note for RedHat Linux users:

  After running 'make install', you must change the following line in
  '/etc/httpd/conf/httpd.conf':

  LoadModule access_referer_module lib/apache/mod_access_referer.so

  by the following line:

  LoadModule access_referer_module modules/mod_access_referer.so


If you want to install the module by hand, instead:

1) Add the following line in the file 'httpd.conf', in the section
   "Section 1: Global Environment", in the begining of the part
   "Dynamic Shared Object (DSO) Support", after all of the rest of the lines:

LoadModule access_referer_module libexec/mod_access_referer.so

Note:

  You must substitute 'libexec' in the previous line by the name of the
  directory where the modules are (in RedHat Linux: 'modules').

2) Add the following line in the file 'httpd.conf', in the section
   "Section 1: Global Environment", in the end of the part
   "Dynamic Shared Object (DSO) Support", after all of the rest of the lines:

AddModule mod_access_referer.c


To configure
************

Add some of the directives that this module provides. For documentation about
the directives, read the file 'mod_access_referer.html'.

Example:

<Location /secret>
	Default_Referer		deny_referer
	Order_Referer		deny_referer,allow_referer
	Deny_Referer from	all
	Allow_Referer from	.w3.org 200.10.243.0/255.255.255.0
</Location>

