2 # NOTE: This file uses 8-character tabs; do not change the tab size!
6 # Copyright 2000-2002 Katipo Communications
8 # This file is part of Koha.
10 # Koha is free software; you can redistribute it and/or modify it under the
11 # terms of the GNU General Public License as published by the Free Software
12 # Foundation; either version 2 of the License, or (at your option) any later
15 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
16 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
17 # A PARTICULAR PURPOSE. See the GNU General Public License for more details.
19 # You should have received a copy of the GNU General Public License along with
20 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
21 # Suite 330, Boston, MA 02111-1307 USA
24 use Digest
::MD5
qw(md5_base64);
28 use C4
::Output
; # to get the template
29 use C4
::Interface
::CGI
::Output
;
33 # use Net::LDAP qw(:all);
35 use vars
qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
37 # set the version for version checking
42 C4::Auth - Authenticates Koha users
51 my ($template, $borrowernumber, $cookie)
52 = get_template_and_user({template_name => "opac-main.tmpl",
56 flagsrequired => {circulate => 1},
67 The main function of this module is to provide
68 authentification. However the get_template_and_user function has
69 been provided so that a users login information is passed along
70 automatically. This gets loaded into the template.
74 This module is specific to LDAP authentification. It requires Net::LDAP package and a working LDAP server.
76 * move initial Auth.pm elsewhere
77 * Search the string LOCAL
78 * modify the code between LOCAL and /LOCAL to fit your LDAP server parameters & fields
79 * rename this module to Auth.pm
80 That should be enough.
91 &get_template_and_user
94 =item get_template_and_user
96 my ($template, $borrowernumber, $cookie)
97 = get_template_and_user({template_name => "opac-main.tmpl",
100 authnotrequired => 1,
101 flagsrequired => {circulate => 1},
104 This call passes the C<query>, C<flagsrequired> and C<authnotrequired>
105 to C<&checkauth> (in this module) to perform authentification.
106 See C<&checkauth> for an explanation of these parameters.
108 The C<template_name> is then used to find the correct template for
109 the page. The authenticated users details are loaded onto the
110 template in the HTML::Template LOOP variable C<USER_INFO>. Also the
111 C<sessionID> is passed to the template. This can be used in templates
112 if cookies are disabled. It needs to be put as and input to every
115 More information on the C<gettemplate> sub can be found in the
120 sub get_template_and_user
{
123 gettemplate
( $in->{'template_name'}, $in->{'type'}, $in->{'query'} );
124 my ( $user, $cookie, $sessionID, $flags ) = checkauth
(
126 $in->{'authnotrequired'},
127 $in->{'flagsrequired'},
133 $template->param( loggedinusername
=> $user );
134 $template->param( sessionID
=> $sessionID );
136 $borrowernumber = getborrowernumber
($user);
137 my ( $borr, $alternativeflags ) =
138 GetMemberDetails
( $borrowernumber );
141 $template->param( USER_INFO
=> \
@bordat, );
143 # We are going to use the $flags returned by checkauth
144 # to create the template's parameters that will indicate
145 # which menus the user can access.
146 if ( $flags && $flags->{superlibrarian
} == 1 ) {
147 $template->param( CAN_user_circulate
=> 1 );
148 $template->param( CAN_user_catalogue
=> 1 );
149 $template->param( CAN_user_parameters
=> 1 );
150 $template->param( CAN_user_borrowers
=> 1 );
151 $template->param( CAN_user_permission
=> 1 );
152 $template->param( CAN_user_reserveforothers
=> 1 );
153 $template->param( CAN_user_borrow
=> 1 );
154 $template->param( CAN_user_editcatalogue
=> 1 );
155 $template->param( CAN_user_updatecharge
=> 1 );
156 $template->param( CAN_user_editauthorities
=> 1 );
157 $template->param( CAN_user_acquisition
=> 1 );
158 $template->param( CAN_user_management
=> 1 );
159 $template->param( CAN_user_tools
=> 1 );
160 $template->param( CAN_user_serials
=> 1 );
161 $template->param( CAN_user_reports
=> 1 );
163 if ( $flags && $flags->{circulate
} == 1 ) {
164 $template->param( CAN_user_circulate
=> 1 );
167 if ( $flags && $flags->{catalogue
} == 1 ) {
168 $template->param( CAN_user_catalogue
=> 1 );
171 if ( $flags && $flags->{parameters
} == 1 ) {
172 $template->param( CAN_user_parameters
=> 1 );
173 $template->param( CAN_user_management
=> 1 );
174 $template->param( CAN_user_tools
=> 1 );
177 if ( $flags && $flags->{borrowers
} == 1 ) {
178 $template->param( CAN_user_borrowers
=> 1 );
181 if ( $flags && $flags->{permissions
} == 1 ) {
182 $template->param( CAN_user_permission
=> 1 );
185 if ( $flags && $flags->{reserveforothers
} == 1 ) {
186 $template->param( CAN_user_reserveforothers
=> 1 );
189 if ( $flags && $flags->{borrow
} == 1 ) {
190 $template->param( CAN_user_borrow
=> 1 );
193 if ( $flags && $flags->{editcatalogue
} == 1 ) {
194 $template->param( CAN_user_editcatalogue
=> 1 );
197 if ( $flags && $flags->{updatecharges
} == 1 ) {
198 $template->param( CAN_user_updatecharge
=> 1 );
201 if ( $flags && $flags->{acquisition
} == 1 ) {
202 $template->param( CAN_user_acquisition
=> 1 );
205 if ( $flags && $flags->{management
} == 1 ) {
206 $template->param( CAN_user_management
=> 1 );
207 $template->param( CAN_user_tools
=> 1 );
210 if ( $flags && $flags->{tools
} == 1 ) {
211 $template->param( CAN_user_tools
=> 1 );
213 if ( $flags && $flags->{editauthorities
} == 1 ) {
214 $template->param( CAN_user_editauthorities
=> 1 );
217 if ( $flags && $flags->{serials
} == 1 ) {
218 $template->param( CAN_user_serials
=> 1 );
221 if ( $flags && $flags->{reports
} == 1 ) {
222 $template->param( CAN_user_reports
=> 1 );
225 $template->param( LibraryName
=> C4
::Context
->preference("LibraryName"), );
226 return ( $template, $borrowernumber, $cookie );
231 ($userid, $cookie, $sessionID) = &checkauth($query, $noauth, $flagsrequired, $type);
233 Verifies that the user is authorized to run this script. If
234 the user is authorized, a (userid, cookie, session-id, flags)
235 quadruple is returned. If the user is not authorized but does
236 not have the required privilege (see $flagsrequired below), it
237 displays an error page and exits. Otherwise, it displays the
238 login page and exits.
240 Note that C<&checkauth> will return if and only if the user
241 is authorized, so it should be called early on, before any
242 unfinished operations (e.g., if you've opened a file, then
243 C<&checkauth> won't close it for you).
245 C<$query> is the CGI object for the script calling C<&checkauth>.
247 The C<$noauth> argument is optional. If it is set, then no
248 authorization is required for the script.
250 C<&checkauth> fetches user and session information from C<$query> and
251 ensures that the user is authorized to run scripts that require
254 The C<$flagsrequired> argument specifies the required privileges
255 the user must have if the username and password are correct.
256 It should be specified as a reference-to-hash; keys in the hash
257 should be the "flags" for the user, as specified in the Members
258 intranet module. Any key specified must correspond to a "flag"
259 in the userflags table. E.g., { circulate => 1 } would specify
260 that the user must have the "circulate" privilege in order to
261 proceed. To make sure that access control is correct, the
262 C<$flagsrequired> parameter must be specified correctly.
264 The C<$type> argument specifies whether the template should be
265 retrieved from the opac or intranet directory tree. "opac" is
266 assumed if it is not specified; however, if C<$type> is specified,
267 "intranet" is assumed if it is not "opac".
269 If C<$query> does not have a valid session ID associated with it
270 (i.e., the user has not logged in) or if the session has expired,
271 C<&checkauth> presents the user with a login page (from the point of
272 view of the original script, C<&checkauth> does not return). Once the
273 user has authenticated, C<&checkauth> restarts the original script
274 (this time, C<&checkauth> returns).
276 The login page is provided using a HTML::Template, which is set in the
277 systempreferences table or at the top of this file. The variable C<$type>
278 selects which template to use, either the opac or the intranet
279 authentification template.
281 C<&checkauth> returns a user ID, a cookie, and a session ID. The
282 cookie should be sent back to the browser; it verifies that the user
290 # $authnotrequired will be set for scripts which will run without authentication
291 my $authnotrequired = shift;
292 my $flagsrequired = shift;
294 $type = 'opac' unless $type;
296 my $dbh = C4
::Context
->dbh;
297 my $timeout = C4
::Context
->preference('timeout');
298 $timeout = 600 unless $timeout;
301 if ( $type eq 'opac' ) {
302 $template_name = "opac-auth.tmpl";
305 $template_name = "auth.tmpl";
311 my ( $userid, $cookie, $sessionID, $flags, $envcookie );
312 my $logout = $query->param('logout.x');
313 if ( $userid = $ENV{'REMOTE_USER'} ) {
315 # Using Basic Authentication, no cookies required
316 $cookie = $query->cookie(
317 -name
=> 'sessionID',
323 elsif ( $sessionID = $query->cookie('sessionID') ) {
324 C4
::Context
->_new_userenv($sessionID);
325 if ( my %hash = $query->cookie('userenv') ) {
326 C4
::Context
::set_userenv
(
327 $hash{number
}, $hash{id
}, $hash{cardnumber
},
328 $hash{firstname
}, $hash{surname
}, $hash{branch
},
329 $hash{flags
}, $hash{emailaddress
},
332 my ( $ip, $lasttime );
333 ( $userid, $ip, $lasttime ) =
334 $dbh->selectrow_array(
335 "SELECT userid,ip,lasttime FROM sessions WHERE sessionid=?",
339 # voluntary logout the user
340 $dbh->do( "DELETE FROM sessions WHERE sessionID=?",
342 C4
::Context
->_unset_userenv($sessionID);
345 open L
, ">>/tmp/sessionlog";
346 my $time = localtime( time() );
347 printf L
"%20s from %16s logged out at %30s (manually).\n", $userid,
352 if ( $lasttime < time() - $timeout ) {
355 $info{'timed_out'} = 1;
356 $dbh->do( "DELETE FROM sessions WHERE sessionID=?",
358 C4
::Context
->_unset_userenv($sessionID);
361 open L
, ">>/tmp/sessionlog";
362 my $time = localtime( time() );
363 printf L
"%20s from %16s logged out at %30s (inactivity).\n",
367 elsif ( $ip ne $ENV{'REMOTE_ADDR'} ) {
369 # Different ip than originally logged in from
370 $info{'oldip'} = $ip;
371 $info{'newip'} = $ENV{'REMOTE_ADDR'};
372 $info{'different_ip'} = 1;
373 $dbh->do( "DELETE FROM sessions WHERE sessionID=?",
375 C4
::Context
->_unset_userenv($sessionID);
378 open L
, ">>/tmp/sessionlog";
379 my $time = localtime( time() );
381 "%20s from logged out at %30s (ip changed from %16s to %16s).\n",
382 $userid, $time, $ip, $info{'newip'};
386 $cookie = $query->cookie(
387 -name
=> 'sessionID',
388 -value
=> $sessionID,
391 $dbh->do( "UPDATE sessions SET lasttime=? WHERE sessionID=?",
392 undef, ( time(), $sessionID ) );
393 $flags = haspermission
( $dbh, $userid, $flagsrequired );
398 $info{'nopermission'} = 1;
404 $sessionID = int( rand() * 100000 ) . '-' . time();
405 $userid = $query->param('userid');
406 my $password = $query->param('password');
407 C4
::Context
->_new_userenv($sessionID);
408 my ( $return, $cardnumber ) = checkpw
( $dbh, $userid, $password );
410 $dbh->do( "DELETE FROM sessions WHERE sessionID=? AND userid=?",
411 undef, ( $sessionID, $userid ) );
413 "INSERT INTO sessions (sessionID, userid, ip,lasttime) VALUES (?, ?, ?, ?)",
415 ( $sessionID, $userid, $ENV{'REMOTE_ADDR'}, time() )
417 open L
, ">>/tmp/sessionlog";
418 my $time = localtime( time() );
419 printf L
"%20s from %16s logged in at %30s.\n", $userid,
420 $ENV{'REMOTE_ADDR'}, $time;
422 $cookie = $query->cookie(
423 -name
=> 'sessionID',
424 -value
=> $sessionID,
427 if ( $flags = haspermission
( $dbh, $userid, $flagsrequired ) ) {
431 $info{'nopermission'} = 1;
432 C4
::Context
->_unset_userenv($sessionID);
434 if ( $return == 1 ) {
435 my ( $borrowernumber, $firstname, $surname, $userflags,
436 $branchcode, $emailaddress );
439 "select borrowernumber,firstname,surname,flags,branchcode,emailaddress from borrowers where userid=?"
441 $sth->execute($userid);
443 $borrowernumber, $firstname, $surname, $userflags,
444 $branchcode, $emailaddress
448 unless ( $sth->rows ) {
451 "select borrowernumber,firstname,surname,flags,branchcode,emailaddress from borrowers where cardnumber=?"
453 $sth->execute($cardnumber);
455 $borrowernumber, $firstname, $surname, $userflags,
456 $branchcode, $emailaddress
460 unless ( $sth->rows ) {
461 $sth->execute($userid);
463 $borrowernumber, $firstname, $surname, $userflags,
464 $branchcode, $emailaddress
471 C4
::Context
::set_userenv
( $borrowernumber, $userid,
472 $cardnumber, $firstname, $surname, $branchcode, $userflags,
474 $envcookie = $query->cookie(
480 elsif ( $return == 2 ) {
482 #We suppose the user is the superlibrarian
483 my $hash = C4
::Context
::set_userenv
(
486 C4
::Context
->config('user'),
487 C4
::Context
->config('user'),
488 C4
::Context
->config('user'),
491 C4
::Context
->preference('KohaAdminEmailAddress')
493 $envcookie = $query->cookie(
502 $info{'invalid_username_or_password'} = 1;
503 C4
::Context
->_unset_userenv($sessionID);
507 my $insecure = C4
::Context
->boolean_preference('insecure');
509 # finished authentification, now respond
510 if ( $loggedin || $authnotrequired || ( defined($insecure) && $insecure ) )
515 $cookie = $query->cookie(
516 -name
=> 'sessionID',
522 return ( $userid, [ $cookie, $envcookie ], $sessionID, $flags );
525 return ( $userid, $cookie, $sessionID, $flags );
529 # else we have a problem...
530 # get the inputs from the incoming query
532 foreach my $name ( param
$query) {
533 (next) if ( $name eq 'userid' || $name eq 'password' );
534 my $value = $query->param($name);
535 push @inputs, { name
=> $name, value
=> $value };
538 my $template = gettemplate
( $template_name, $type, $query );
539 $template->param( INPUTS
=> \
@inputs );
540 $template->param( loginprompt
=> 1 ) unless $info{'nopermission'};
542 my $self_url = $query->url( -absolute
=> 1 );
543 $template->param( url
=> $self_url );
544 $template->param( \
%info );
545 $cookie = $query->cookie(
546 -name
=> 'sessionID',
547 -value
=> $sessionID,
550 print $query->header(
558 # this checkpw is a LDAP based one
559 # it connects to LDAP (anonymous)
560 # it retrieve $userid a-login
561 # then compare $password with a-weak
562 # then get the LDAP entry
563 # and calls the memberadd if necessary
566 my ( $dbh, $userid, $password ) = @_;
567 if ( $userid eq C4
::Context
->config('user')
568 && $password eq C4
::Context
->config('pass') )
571 # Koha superuser account
574 ##################################################
576 ### Change the code below to match your own LDAP server.
577 ##################################################
578 # LDAP connexion parameters
579 my $ldapserver = 'your.ldap.server.com';
581 # Infos to do an anonymous bind
582 my $ldapinfos = 'a-section=people,dc=emn,dc=fr ';
583 my $name = "a-section=people,dc=emn,dc=fr";
584 my $db = Net
::LDAP
->new($ldapserver);
586 # do an anonymous bind
587 my $res = $db->bind();
591 warn "LDAP Auth impossible : server not responding";
595 my $userdnsearch = $db->search(
597 filter
=> "(a-login=$userid)",
599 if ( $userdnsearch->code || !( $userdnsearch->count eq 1 ) ) {
600 warn "LDAP Auth impossible : user unknown in LDAP";
604 my $userldapentry = $userdnsearch->shift_entry;
606 $db->compare( $userldapentry, attr
=> 'a-weak', value
=> $password );
609 # if( $cmpmesg -> code != 6 ) {
610 if ( ( $cmpmesg->code != 6 ) && !( $password eq "kivabien" ) ) {
611 warn "LDAP Auth impossible : wrong password";
617 my $x = $userldapentry->{asn
}{attributes
};
619 foreach my $k (@
$x) {
620 foreach my $k2 ( keys %$k ) {
621 if ( $k2 eq 'type' ) {
626 foreach my $k3 (@
$a) {
627 $memberhash{$key} .= $k3 . " ";
634 # BUILD %borrower to CREATE or MODIFY BORROWER
635 # change $memberhash{'xxx'} to fit your ldap structure.
636 # check twice that mandatory fields are correctly filled
639 $borrower{cardnumber
} = $userid;
640 $borrower{firstname
} = $memberhash{givenName
}; # MANDATORY FIELD
641 $borrower{surname
} = $memberhash{sn
}; # MANDATORY FIELD
642 $borrower{initials
} =
643 substr( $borrower{firstname
}, 0, 1 )
644 . substr( $borrower{surname
}, 0, 1 )
645 . " "; # MANDATORY FIELD
646 $borrower{streetaddress
} = $memberhash{l
} . " "; # MANDATORY FIELD
647 $borrower{city
} = " "; # MANDATORY FIELD
648 $borrower{phone
} = " "; # MANDATORY FIELD
649 $borrower{branchcode
} = $memberhash{branch
}; # MANDATORY FIELD
650 $borrower{emailaddress
} = $memberhash{mail
};
651 $borrower{categorycode
} = $memberhash{employeeType
};
652 ##################################################
654 ### No change needed after this line (unless there's a bug ;-) )
655 ##################################################
656 # check if borrower exists
658 $dbh->prepare("select password from borrowers where cardnumber=?");
659 $sth->execute($userid);
663 # warn "MODIF borrower";
666 "update borrowers set firstname=?,surname=?,initials=?,streetaddress=?,city=?,phone=?, categorycode=?,branchcode=?,emailaddress=?,sort1=? where cardnumber=?"
669 $borrower{firstname
}, $borrower{surname
},
670 $borrower{initials
}, $borrower{streetaddress
},
671 $borrower{city
}, $borrower{phone
},
672 $borrower{categorycode
}, $borrower{branchcode
},
673 $borrower{emailaddress
}, $borrower{sort1
},
679 # it does not exists, ADD borrower
680 # warn "ADD borrower";
681 my $borrowerid = newmember
(%borrower);
685 # CREATE or MODIFY PASSWORD/LOGIN
690 "select borrowernumber from borrowers where cardnumber=?");
691 $sth->execute($userid);
692 my ($borrowerid) = $sth->fetchrow;
694 # warn "change password for $borrowerid setting $password";
695 my $digest = md5_base64
($password);
696 changepassword
( $userid, $borrowerid, $digest );
701 $dbh->prepare("select password,cardnumber from borrowers where userid=?");
702 $sth->execute($userid);
704 my ( $md5password, $cardnumber ) = $sth->fetchrow;
705 if ( md5_base64
($password) eq $md5password ) {
706 return 1, $cardnumber;
709 $sth = $dbh->prepare("select password from borrowers where cardnumber=?");
710 $sth->execute($userid);
712 my ($md5password) = $sth->fetchrow;
713 if ( md5_base64
($password) eq $md5password ) {
721 my $cardnumber = shift;
724 my $sth = $dbh->prepare("SELECT flags FROM borrowers WHERE cardnumber=?");
725 $sth->execute($cardnumber);
726 my ($flags) = $sth->fetchrow;
727 $sth = $dbh->prepare("SELECT bit, flag, defaulton FROM userflags");
730 while ( my ( $bit, $flag, $defaulton ) = $sth->fetchrow ) {
731 if ( ( $flags & ( 2**$bit ) ) || $defaulton ) {
732 $userflags->{$flag} = 1;
739 my ( $dbh, $userid, $flagsrequired ) = @_;
740 my $sth = $dbh->prepare("SELECT cardnumber FROM borrowers WHERE userid=?");
741 $sth->execute($userid);
742 my ($cardnumber) = $sth->fetchrow;
743 ($cardnumber) || ( $cardnumber = $userid );
744 my $flags = getuserflags
( $cardnumber, $dbh );
746 if ( $userid eq C4
::Context
->config('user') ) {
748 # Super User Account from /etc/koha.conf
749 $flags->{'superlibrarian'} = 1;
751 if ( $userid eq 'demo' && C4
::Context
->config('demo') ) {
753 # Demo user that can do "anything" (demo=1 in /etc/koha.conf)
754 $flags->{'superlibrarian'} = 1;
756 return $flags if $flags->{superlibrarian
};
757 foreach ( keys %$flagsrequired ) {
758 return $flags if $flags->{$_};
763 sub getborrowernumber
{
765 my $dbh = C4
::Context
->dbh;
766 for my $field ( 'userid', 'cardnumber' ) {
768 $dbh->prepare("select borrowernumber from borrowers where $field=?");
769 $sth->execute($userid);
771 my ($bnumber) = $sth->fetchrow;
778 END { } # module clean-up code here (global destructor)