NAME

Apache::AuthenRadius - Authentication via a Radius server

SYNOPSIS

# Configuration in httpd.conf

PerlModule Apache::AuthenRadius

# Authentication in .htaccess

AuthName Radius
AuthType Basic

# authenticate via Radius
PerlAuthenHandler Apache::AuthenRadius

PerlSetVar Auth_Radius_host radius.foo.com
PerlSetVar Auth_Radius_port 1647
PerlSetVar Auth_Radius_secret MySharedSecret
PerlSetVar Auth_Radius_timeout 5

require valid-user

DESCRIPTION

This module allows authentication against a Radius server.

LIST OF TOKENS

• Auth_Radius_host

  The Radius server host: either its name or its dotted quad IP number. The parameter is passed as the PeerHost option to IO::Socket::INET->new.

• Auth_Radius_port

  The port on which the Radius server is listening: either its service name or its actual port number. This parameter defaults to "1647" which is the official service name for Radius servers. The parameter is passed as the PeerPort option to IO::Socket::INET->new.

• Auth_Radius_secret

  The shared secret for connection to the Radius server.

• Auth_Radius_timeout

  The timeout in seconds to wait for a response from the Radius server.

CONFIGURATION

The module should be loaded upon startup of the Apache daemon. Add the following line to your httpd.conf:

PerlModule Apache::AuthenRadius

PREREQUISITES

For AuthenRadius you need to enable the appropriate call-back hook when making mod_perl:

perl Makefile.PL PERL_AUTHEN=1

SEE ALSO

Apache, mod_perl, Authen::Radius

AUTHORS

• mod_perl by Doug MacEachern <dougm@osf.org>

• Authen::Radius by Carl Declerck <carl@miskatonic.inbe.net>

• Apache::AuthenRadius by Daniel Sully <daniel-cpan-authenradius@electricrain.com>

COPYRIGHT

The Apache::AuthenRadius module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.