Files
postfixadmin/model/Login.php
T
Rodrigo Cortés Cano e638095d58 Harden password recovery requests (#1130)
Require a validated canonical site_url for recovery links, keep responses uniform, and persist a five-minute per-account request limit.

The token update is atomic across supported database engines and performs the same password hashing work for unknown accounts.

Refs #1128

thanks @TrapoSAMA
2026-08-29 14:55:49 +01:00

235 lines
7.4 KiB
PHP

<?php
class Login
{
private string $key_table;
private string $table;
public function __construct(string $tableName)
{
$ok = ['mailbox', 'admin'];
if (!in_array($tableName, $ok)) {
throw new \InvalidArgumentException("Unsupported tableName for login: " . $tableName);
}
$this->table = $tableName;
$this->key_table = table_by_key($tableName);
}
/**
* Attempt to log a user in.
* @return boolean true on successful login (i.e. password matches etc)
*/
public function login(string $username, string $password): bool
{
$query = "SELECT password FROM {$this->key_table} WHERE username = :username AND active = :active";
$values = ['username' => $username, 'active' => true];
$result = db_query_all($query, $values);
if (sizeof($result) == 1 && strlen($password) > 0) {
$row = $result[0];
try {
$crypt_password = pacrypt($password, $row['password'], $username);
} catch (\Exception $e) {
error_log(__FILE__ . " - error while trying to call pacrypt() (1): " . $e->getMessage());
$_ = hash_equals("not", "comparable");
return false; // just refuse to login?
}
return hash_equals($row['password'], $crypt_password);
}
// try and be near constant time regardless of whether the db user exists or not
try {
// this causes errors with e.g. dovecot as there is no prefix.
$_ = pacrypt('abc', 'def');
} catch (\Exception $e) {
error_log(__FILE__ . " - error trying to call pacrypt() (2): " . $e->getMessage());
}
return hash_equals('not', 'comparable');
}
/**
* Updates db with password recovery code, and returns it.
* @param string $username
* @return false|string
* @throws Exception
*/
public function generatePasswordRecoveryCode(string $username)
{
$token = generate_password();
$token_hash = pacrypt($token);
$token_validity = date('Y-m-d H:i:s', strtotime('+1 hour'));
$cooldown = date('Y-m-d H:i:s', strtotime('+55 minutes'));
$now = db_sqlite() ? "datetime('now')" : 'now()';
$sql = "UPDATE {$this->key_table}
SET token = :token, token_validity = :token_validity, modified = $now
WHERE username = :username AND active = :active
AND (token IS NULL OR token = '' OR token_validity <= :cooldown)";
$updatedRows = db_execute($sql, [
'token' => $token_hash,
'token_validity' => $token_validity,
'username' => $username,
'active' => true,
'cooldown' => $cooldown,
]);
if ($updatedRows == 1) {
return $token;
}
return false;
}
/**
* returns user's domain name
* @param $username
* @return string|null
* @throws Exception
*/
protected function getUserDomain(string $username)
{
$sql = "SELECT domain FROM {$this->table} WHERE username = :username AND active = :active";
$values = [
'username' => $username,
'active' => true,
];
// Fetch the domain
$result = db_query_one($sql, $values);
if (is_array($result) && isset($result['domain'])) {
return $result['domain'];
} else {
return null;
}
}
/**
* @param string $username
* @param string $new_password
* @param string $old_password
*
* All passwords need to be plain text; they'll be hashed appropriately
* as per the configuration in config.inc.php
*
* @return boolean true on success; false on failure
* @throws \Exception if invalid user, or db update fails.
*/
public function changePassword($username, $new_password, $old_password): bool
{
list(/*NULL*/, $domain) = explode('@', $username);
if (!$this->login($username, $old_password)) {
throw new \Exception(Config::Lang('pPassword_password_current_text_error'));
}
$set = array(
'password' => pacrypt($new_password, '', $username),
);
$user_domain = $this->getUserDomain($username);
if (!is_null($user_domain)) {
$domain = $user_domain;
$set['password_expiry'] = get_mailbox_password_expiry($user_domain);
}
$result = db_update($this->table, 'username', $username, $set);
if ($result != 1) {
db_log($domain, 'edit_password', "FAILURE: " . $username);
throw new \Exception(Config::lang('pEdit_mailbox_result_error'));
}
db_log($domain, 'edit_password', $username);
$cmd_pw = Config::read('mailbox_postpassword_script');
if (empty($cmd_pw)) {
return true;
}
$warnmsg_pw = Config::Lang('mailbox_postpassword_failed');
$cmdarg1 = escapeshellarg($username);
$cmdarg2 = escapeshellarg($domain);
$command = "$cmd_pw $cmdarg1 $cmdarg2 2>&1";
$stdin = $old_password . "\0" . $new_password . "\0";
$exec = Exec::run($command, $stdin);
if ($exec->retval !== 0) {
throw new \Exception($warnmsg_pw);
}
return true;
}
/**
* @param string $username - current user
* @param string $password - password for $username
* @param string $app_desc - desc. for the app we're adding
* @param string $app_pass - password for the app we're adding
*
* All passwords need to be plain text; they'll be hashed appropriately
* as per the configuration in config.inc.php
*
* @return boolean true on success; false on failure
* @throws \Exception if invalid user, or db update fails.
*/
public function addAppPassword(string $username, string $password, string $app_desc, string $app_pass): bool
{
list(/*NULL*/, $domain) = explode('@', $username);
if (!$app_pass) {
throw new \Exception(Config::Lang('pAppPassAdd_pass_empty_error'));
}
if (!$app_desc) {
throw new \Exception(Config::Lang('pException_desc_empty_error'));
}
if (!$this->login($username, $password)) {
throw new \Exception(Config::Lang('pPassword_password_current_text_error'));
}
$app_pass = pacrypt($app_pass, '', $username);
// @todo - should an admin be able to add an application password for a user? this doesn't allow them to.
$result = db_insert('mailbox_app_password', ['username' => $username, 'description' => $app_desc, 'password_hash' => $app_pass], []);
if ($result != 1) {
db_log($domain, 'add_app_password', "FAILURE: " . $username);
throw new \Exception(Config::lang('pAdd_app_password_result_error'));
}
db_log($domain, 'add_app_password', $username);
$cmd_pw = Config::read('mailbox_postapppassword_script');
if (empty($cmd_pw)) {
return true;
}
$warnmsg_pw = Config::Lang('mailbox_postapppassword_failed');
$cmdarg1 = escapeshellarg($username);
$cmdarg2 = escapeshellarg($app_desc);
$command = "$cmd_pw $cmdarg1 $cmdarg2 2>&1";
$stdin = $app_pass . "\0";
$exec = Exec::run($command, $stdin);
if ($exec->retval !== 0) {
throw new \Exception($warnmsg_pw);
}
return true;
}
}