C4/Auth_with_cas.pm

   1 package C4::Auth_with_cas;
   2
   3 # Copyright 2009 BibLibre SARL
   4 #
   5 # This file is part of Koha.
   6 #
   7 # Koha is free software; you can redistribute it and/or modify it under the
   8 # terms of the GNU General Public License as published by the Free Software
   9 # Foundation; either version 2 of the License, or (at your option) any later
  10 # version.
  11 #
  12 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
  13 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  14 # A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  15 #
  16 # You should have received a copy of the GNU General Public License along
  17 # with Koha; if not, write to the Free Software Foundation, Inc.,
  18 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19
  20 use strict;
  21 use warnings;
  22
  23 use C4::Debug;
  24 use C4::Context;
  25 use C4::Utils qw( :all );
  26 use Authen::CAS::Client;
  27 use CGI;
  28 use FindBin;
  29
  30
  31 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS $debug);
  32
  33 BEGIN {
  34         require Exporter;
  35     $VERSION = 3.08.01.002;     # set the version for version checking
  36         $debug = $ENV{DEBUG};
  37         @ISA    = qw(Exporter);
  38         @EXPORT = qw(check_api_auth_cas checkpw_cas login_cas logout_cas login_cas_url);
  39 }
  40 my $context = C4::Context->new() or die 'C4::Context->new failed';
  41 my $defaultcasserver;
  42 my $casservers;
  43 my $yamlauthfile = "../C4/Auth_cas_servers.yaml";
  44
  45
  46 # If there's a configuration for multiple cas servers, then we get it
  47 if (multipleAuth()) {
  48     ($defaultcasserver, $casservers) = YAML::LoadFile(qq($FindBin::Bin/$yamlauthfile));
  49     $defaultcasserver = $defaultcasserver->{'default'};
  50 } else {
  51 # Else, we fall back to casServerUrl syspref
  52     $defaultcasserver = 'default';
  53     $casservers = { 'default' => C4::Context->preference('casServerUrl') };
  54 }
  55
  56 # Is there a configuration file for multiple cas servers?
  57 sub multipleAuth {
  58     return (-e qq($FindBin::Bin/$yamlauthfile));
  59 }
  60
  61 # Returns configured CAS servers' list if multiple authentication is enabled
  62 sub getMultipleAuth {
  63    return $casservers;
  64 }
  65
  66 # Logout from CAS
  67 sub logout_cas {
  68     my ($query) = @_;
  69     my $uri = C4::Context->preference('OPACBaseURL') . $query->script_name();
  70     my $casparam = $query->param('cas');
  71     # FIXME: This should be more generic and handle whatever parameters there might be
  72     $uri .= "?cas=" . $casparam if (defined $casparam);
  73     $casparam = $defaultcasserver if (not defined $casparam);
  74     my $cas = Authen::CAS::Client->new($casservers->{$casparam});
  75     print $query->redirect( $cas->logout_url($uri));
  76 }
  77
  78 # Login to CAS
  79 sub login_cas {
  80     my ($query) = @_;
  81     my $uri = C4::Context->preference('OPACBaseURL') . $query->script_name();
  82     my $casparam = $query->param('cas');
  83     # FIXME: This should be more generic and handle whatever parameters there might be
  84     $uri .= "?cas=" . $casparam if (defined $casparam);
  85     $casparam = $defaultcasserver if (not defined $casparam);
  86     my $cas = Authen::CAS::Client->new($casservers->{$casparam});
  87     print $query->redirect( $cas->login_url($uri));
  88 }
  89
  90 # Returns CAS login URL with callback to the requesting URL
  91 sub login_cas_url {
  92
  93     my ($query, $key) = @_;
  94     my $uri = C4::Context->preference('OPACBaseURL') . $query->url( -absolute => 1, -query => 1 );
  95     my $casparam = $query->param('cas');
  96     $casparam = $defaultcasserver if (not defined $casparam);
  97     $casparam = $key if (defined $key);
  98     my $cas = Authen::CAS::Client->new($casservers->{$casparam});
  99     return $cas->login_url($uri);
 100 }
 101
 102 # Checks for password correctness
 103 # In our case : is there a ticket, is it valid and does it match one of our users ?
 104 sub checkpw_cas {
 105     $debug and warn "checkpw_cas";
 106     my ($dbh, $ticket, $query) = @_;
 107     my $retnumber;
 108     my $uri = C4::Context->preference('OPACBaseURL') . $query->script_name();
 109     my $casparam = $query->param('cas');
 110     # FIXME: This should be more generic and handle whatever parameters there might be
 111     $uri .= "?cas=" . $casparam if (defined $casparam);
 112     $casparam = $defaultcasserver if (not defined $casparam);
 113     my $cas = Authen::CAS::Client->new($casservers->{$casparam});
 114
 115     # If we got a ticket
 116     if ($ticket) {
 117         $debug and warn "Got ticket : $ticket";
 118
 119         # We try to validate it
 120         my $val = $cas->service_validate($uri, $ticket );
 121
 122         # If it's valid
 123         if ( $val->is_success() ) {
 124
 125             my $userid = $val->user();
 126             $debug and warn "User CAS authenticated as: $userid";
 127
 128             # Does it match one of our users ?
 129             my $sth = $dbh->prepare("select cardnumber from borrowers where userid=?");
 130             $sth->execute($userid);
 131             if ( $sth->rows ) {
 132                 $retnumber = $sth->fetchrow;
 133                 return ( 1, $retnumber, $userid );
 134             }
 135             $sth = $dbh->prepare("select userid from borrowers where cardnumber=?");
 136             $sth->execute($userid);
 137             if ( $sth->rows ) {
 138                 $retnumber = $sth->fetchrow;
 139                 return ( 1, $retnumber, $userid );
 140             }
 141
 142             # If we reach this point, then the user is a valid CAS user, but not a Koha user
 143             $debug and warn "User $userid is not a valid Koha user";
 144
 145         } else {
 146             $debug and warn "Invalid session ticket : $ticket";
 147             return 0;
 148         }
 149     }
 150     return 0;
 151 }
 152
 153 # Proxy CAS auth
 154 sub check_api_auth_cas {
 155     $debug and warn "check_api_auth_cas";
 156     my ($dbh, $PT, $query) = @_;
 157     my $retnumber;
 158     my $url = C4::Context->preference('OPACBaseURL') . $query->script_name();
 159
 160     my $casparam = $query->param('cas');
 161     $casparam = $defaultcasserver if (not defined $casparam);
 162     my $cas = Authen::CAS::Client->new($casservers->{$casparam});
 163
 164     # If we have a Proxy Ticket
 165     if ($PT) {
 166         my $r = $cas->proxy_validate( $url, $PT );
 167
 168         # If the PT is valid
 169         if ( $r->is_success ) {
 170
 171             # We've got a username !
 172             $debug and warn "User authenticated as: ", $r->user, "\n";
 173             $debug and warn "Proxied through:\n";
 174             $debug and warn "  $_\n" for $r->proxies;
 175
 176             my $userid = $r->user;
 177
 178             # Does it match one of our users ?
 179             my $sth = $dbh->prepare("select cardnumber from borrowers where userid=?");
 180             $sth->execute($userid);
 181             if ( $sth->rows ) {
 182                 $retnumber = $sth->fetchrow;
 183                 return ( 1, $retnumber, $userid );
 184             }
 185             $sth = $dbh->prepare("select userid from borrowers where cardnumber=?");
 186             return $r->user;
 187             $sth->execute($userid);
 188             if ( $sth->rows ) {
 189                 $retnumber = $sth->fetchrow;
 190                 return ( 1, $retnumber, $userid );
 191             }
 192
 193             # If we reach this point, then the user is a valid CAS user, but not a Koha user
 194             $debug and warn "User $userid is not a valid Koha user";
 195
 196         } else {
 197             $debug and warn "Proxy Ticket authentication failed";
 198             return 0;
 199         }
 200     }
 201     return 0;
 202 }
 203
 204
 205 1;
 206 __END__
 207
 208 =head1 NAME
 209
 210 C4::Auth - Authenticates Koha users
 211
 212 =head1 SYNOPSIS
 213
 214   use C4::Auth_with_cas;
 215
 216 =cut
 217
 218 =head1 SEE ALSO
 219
 220 CGI(3)
 221
 222 Authen::CAS::Client
 223
 224 =cut