Rpam

• github.com/canweriotnow/rpam-ruby19

DESCRIPTION:

This extension provides PAM (Pluggable Authentication Modules) integration.
The library provides a stable API for applications to defer to for
authentication tasks.

FEATURES/PROBLEMS:

• Not reported

SYNOPSIS:

In a nutshell (using the 'rpam' PAM service):

require 'rpam'

if Rpam.auth("user","password") == true
      puts "Authenticate Successful"
else
  puts "Authenticate Failure"
end

Or, to use a different PAM service:

if Rpam.auth("user", "password", :service => 'my_foo') == true

This also supports compatibility with the original 'rpam':

include Rpam
if authpam("user","password") == true

REQUIREMENTS:

• pam-devel

• ruby-devel

INSTALL:

• gem install rpam-ruby19 (might need sudo privileges)

Or, you can do it the hard way (without Rubygems):

• tar xzf rpam-*.tar.gz

• cd rpam-*/ext

• ruby extconf.rb

• make

• make install (might need sudo privileges)

LICENSE:

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

This program 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 General Public License for more details.

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

A full copy of the GNU license is provided in the file LICENSE.