package Koha::Encryption; # Copyright 2022 Koha Development Team # # This file is part of Koha. # # 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 # 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 Koha; if not, see . use Modern::Perl; use base qw( Crypt::CBC ); use C4::Context; use Koha::Exceptions; =head1 NAME Koha::Encryption - Koha class to encrypt or decrypt strings =head1 SYNOPSIS use Koha::Encryption; my $secret = Koha::AuthUtils::generate_salt( 'weak', 16 ); my $crypt = Koha::Encryption->new; my $encrypted = $crypt->encrypt_hex($secret); my $decrypted = $crypt->decrypt_hex($encrypted); return 1 if $decrypted eq $secret; It's based on Crypt::CBC =cut =head2 METHODS =head3 new my $cipher = Koha::Encryption->new; Constructor. Uses encryption_key from koha-conf.xml. =cut sub new { my ($class) = @_; my $encryption_key = C4::Context->config('encryption_key'); if ( !$encryption_key || $encryption_key eq '__ENCRYPTION_KEY__' ) { Koha::Exceptions::MissingParameter->throw( q{No encryption_key in koha-conf.xml. Please generate a key. We recommend one of at least 32 bytes. (You might use 'pwgen 32' to do so.)} ); } return $class->SUPER::new( -key => $encryption_key, -cipher => 'Cipher::AES', -nodeprecate => 1, ); } 1;