GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::RADIUS::SERVER::PAM (3)

.ds Aq ’

NAME

Net::Radius::Server::PAM - Authenticate users using the Linux-PAM framework

CONTENTS

SYNOPSIS



  use Net::Radius::Server::PAM;
  my $pam = new Net::Radius::Server({@args});

  # As match-method factory
  $pam->fmatch();

  # As set-method factory
  $pam->fset();



DESCRIPTION

Net::Radius::Server::PAM uses the PAM framework to authenticate and populate a RADIUS response within the Net::Radius::Server framework. The interface with the PAM infraestructure is provided by Authen::PAM(3).

The following methods are supported:
->fmatch Equivalent to invoking ->mk on a Net::Radius::Server::Match(3) - derived class. This will return a sub providing match functionality to Net::Server::Radius(3).
->fset Equivalent to invoking ->mk on a Net::Radius::Server::Set(3) - derived class. This will return a sub providing set functionality to Net::Server::Radius(3).
The match method will attempt authentication via username and password against the PAM framework. Succesful authentication causes the match method to return <B>NRS_MATCH_OKB>. Failure, as expected, causes the return of <B>NRS_MATCH_FAILB>.

The Authen::PAM object is left in the shared invocation hash at the specified key.

The set method attempts to fetch the environment provided by the PAM framework, translating any environment variables matching an attribute in the current dictionary into RADIUS attribute/value pairs within the response.

The set method will only perform its task if the account can be authenticated by PAM. Otherwise, a <B>NRS_SET_CONTINUEB> will be returned, causing the execution of the rules to continue.

The following properties or arguments can be specified to either the constructor or any factory:
<B>autoB> Causes the RADIUS identifier and authenticator from the request to be copied into the response.
<B>codeB> Sets the code of the RADIUS response. Defaults to ’Access-Accept’.
<B>resultB> What value to return when a succesful authentication occurs.
<B>descriptionB> Description of this rule, used for logging purposes.
<B>store_resultB> Specifies which key in the shared invocation hashref will be used to store the Authen::PAM object. Defaults to <B>_pamhB>.
<B>serviceB> Defines the PAM service that must be used to authenticate. This attribute defaults to <B>loginB>.
Note that this class inherits from Net::Radius::Server::Set::Simple(3), so all its attributes are available as well.

    EXPORT

None by default.

HISTORY



  $Log$
  Revision 1.6  2006/12/14 16:33:17  lem
  Rules and methods will only report failures in log level 3 and
  above. Level 4 report success and failure, for deeper debugging

  Revision 1.5  2006/11/15 05:54:04  lem

  NRS::PAM now inherits from NRS::Set::Simple to increase functionality.

  Revision 1.4  2006/11/15 05:39:15  lem

  Corrected invocation of the factories


  Revision 1.2  2006/11/15 05:23:57  lem

  service now can be left unspecified. Defaults to login

  Revision 1.1  2006/11/15 05:14:54  lem

  NRS::PAM has basic functionality.



SEE ALSO

Perl(1), Net::Radius::Server(3), Net::Radius::Server::Match(3), Net::Radius::Server::Set(3), Net::Radius::Server::Set::Simple(3), Authen::PAM(3).

AUTHOR

Luis E. Munõz, <luismunoz@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2006 by Luis E. Munõz

This library is free software; you can redistribute it and/or modify it under the same terms as Perl 5.8.6 itself.

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 275: Non-ASCII character seen before =encoding in ’Munõz,’. Assuming UTF-8
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::RADIUS::SERVER::PAM (3) 2009-09-20

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.