Main Koha release repository
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

130 lines
3.1 KiB

# This file is part of Koha.
# Copyright 2019 Koha Development Team
# Koha 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 3 of the License, or
# (at your option) any later version.
# Koha is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# GNU General Public License for more details.
# You should have received a copy of the GNU General Public License
# along with Koha; if not, see <>.
use Modern::Perl;
use Bytes::Random::Secure;
use Getopt::Long;
use Pod::Usage;
use String::Random;
use Koha::Patrons;
use Koha::Script;
my ( $help, $password, $cardnumber, $patron_id, $userid );
'help|?' => \$help,
'userid=s' => \$userid,
'password=s' => \$password,
'patron_id=s' => \$patron_id,
'cardnumber=s' => \$cardnumber,
pod2usage(1) if $help;
unless ( $userid or $patron_id or $cardnumber ) {
pod2usage("userid is mandatory") unless $userid;
pod2usage("patron_id is mandatory") unless $patron_id;
pod2usage("cardnumber is mandatory") unless $cardnumber;
unless ($password) {
my $generator = String::Random->new( rand_gen => \&alt_rand );
$password = $generator->randregex('[A-Za-z][A-Za-z0-9_]{6}.[A-Za-z][A-Za-z0-9_]{6}\d');
my $filter;
if ( $userid ) {
$filter->{userid} = $userid;
if ( $cardnumber ) {
$filter->{cardnumber} = $cardnumber;
if ( $patron_id ) {
$filter->{borrowernumber} = $patron_id;
my $patrons = Koha::Patrons->search( $filter );
unless ( $patrons->count > 0 ) {
pod2usage( "No patron found matching the specified criteria" );
my $patron = $patrons->next;
$patron->set_password({ password => $password, skip_validation => 1 });
print $patron->userid . " " . $password . "\n";
sub alt_rand { # Alternative randomizer
my ($max) = @_;
my $random = Bytes::Random::Secure->new( NonBlocking => 1 );
my $r = $random->irand / 2**32;
return int( $r * $max );
=head1 NAME - Set the specified password for the user in Koha
--userid <userid> --password <password> --patron_id <patron_id> --cardnumber <cardnumber>
-?|--help brief help message
--password the password to be set (optional)
--userid the userid to be used to find the patron
--patron_id the borrowernumber for the patron
--cardnumber the cardnumber for the patron
=head1 OPTIONS
=over 8
=item B<--help|-?>
Print a brief help message and exits
=item B<--userid>
The patron's userid (for finding the patron)
=item B<--password>
The password to be set in the database. If no password is passed, a random one is generated.
=item B<--patron_id>
The patron's internal id (for finding the patron)
=item B<--cardnumber>
Patron's cardnumber (for finding the patron)
A simple script to change an existing's user password in the Koha database