PhpassPasswordHashTest.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Core\Tests\Unit\Crypto\PasswordHashing;
 
use PHPUnit\Framework\Attributes\Test;
use ‪TYPO3\CMS\Core\Crypto\PasswordHashing\PhpassPasswordHash;
use TYPO3\TestingFramework\Core\Unit\UnitTestCase;
 
final class ‪PhpassPasswordHashTest extends UnitTestCase
{
    #[Test]
    public function ‪constructorThrowsExceptionIfHashCountIsTooLow(): void
    {
        $this->expectException(\InvalidArgumentException::class);
        $this->expectExceptionCode(1533940454);
        new ‪PhpassPasswordHash(['hash_count' => 6]);
    }
 
    #[Test]
    public function ‪constructorThrowsExceptionIfHashCountIsTooHigh(): void
    {
        $this->expectException(\InvalidArgumentException::class);
        $this->expectExceptionCode(1533940454);
        new ‪PhpassPasswordHash(['hash_count' => 25]);
    }
 
    #[Test]
    public function ‪getHashedPasswordReturnsNullWithEmptyPassword(): void
    {
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        self::assertNull($subject->getHashedPassword(''));
    }
 
    #[Test]
    public function ‪getHashedPasswordReturnsNotNullWithNotEmptyPassword(): void
    {
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        self::assertNotNull($subject->getHashedPassword('a'));
    }
 
    #[Test]
    public function ‪getHashedPasswordValidates(): void
    {
        $password = 'password';
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        $saltedHashPassword = $subject->getHashedPassword($password);
        self::assertTrue($subject->isValidSaltedPW($saltedHashPassword));
    }
 
    #[Test]
    public function ‪checkPasswordReturnsTrueWithValidAlphaCharClassPasswordAndFixedHash(): void
    {
        $password = 'password';
        $saltedHashPassword = '$P$C7u7E10SBEie/Jbdz0jDtUcWhzgOPF.';
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        self::assertTrue($subject->checkPassword($password, $saltedHashPassword));
    }
 
    #[Test]
    public function ‪checkPasswordReturnsFalseWithBrokenHash(): void
    {
        $password = 'password';
        $saltedHashPassword = '$P$C7u7E10SBEie/Jbdz0jDtUcWhzgOPF';
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        self::assertFalse($subject->checkPassword($password, $saltedHashPassword));
    }
 
    #[Test]
    public function ‪checkPasswordReturnsTrueWithValidAlphaCharClassPassword(): void
    {
        $password = 'aEjOtY';
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        $saltedHashPassword = $subject->getHashedPassword($password);
        self::assertTrue($subject->checkPassword($password, $saltedHashPassword));
    }
 
    #[Test]
    public function ‪checkPasswordReturnsTrueWithValidNumericCharClassPassword(): void
    {
        $password = '01369';
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        $saltedHashPassword = $subject->getHashedPassword($password);
        self::assertTrue($subject->checkPassword($password, $saltedHashPassword));
    }
 
    #[Test]
    public function ‪checkPasswordReturnsTrueWithValidAsciiSpecialCharClassPassword(): void
    {
        $password = ' !"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~';
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        $saltedHashPassword = $subject->getHashedPassword($password);
        self::assertTrue($subject->checkPassword($password, $saltedHashPassword));
    }
 
    #[Test]
    public function ‪checkPasswordReturnsTrueWithValidLatin1SpecialCharClassPassword(): void
    {
        $password = '';
        for ($i = 160; $i <= 191; $i++) {
            $password .= chr($i);
        }
        $password .= chr(215) . chr(247);
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        $saltedHashPassword = $subject->getHashedPassword($password);
        self::assertTrue($subject->checkPassword($password, $saltedHashPassword));
    }
 
    #[Test]
    public function ‪checkPasswordReturnsTrueWithValidLatin1UmlautCharClassPassword(): void
    {
        $password = '';
        for ($i = 192; $i <= 214; $i++) {
            $password .= chr($i);
        }
        for ($i = 216; $i <= 246; $i++) {
            $password .= chr($i);
        }
        for ($i = 248; $i <= 255; $i++) {
            $password .= chr($i);
        }
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        $saltedHashPassword = $subject->getHashedPassword($password);
        self::assertTrue($subject->checkPassword($password, $saltedHashPassword));
    }
 
    #[Test]
    public function ‪checkPasswordReturnsFalseWithNonValidPassword(): void
    {
        $password = 'password';
        $password1 = $password . 'INVALID';
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        $saltedHashPassword = $subject->getHashedPassword($password);
        self::assertFalse($subject->checkPassword($password1, $saltedHashPassword));
    }
 
    #[Test]
    public function ‪isHashUpdateNeededReturnsFalseForValidSaltedPassword(): void
    {
        $password = 'password';
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        $saltedHashPassword = $subject->getHashedPassword($password);
        self::assertFalse($subject->isHashUpdateNeeded($saltedHashPassword));
    }
 
    #[Test]
    public function ‪isHashUpdateNeededReturnsFalseForChangedHashCountSaltedPassword(): void
    {
        $password = 'password';
        $subject = new ‪PhpassPasswordHash(['hash_count' => 7]);
        $saltedHashPassword = $subject->getHashedPassword($password);
        $subject = new ‪PhpassPasswordHash(['hash_count' => 8]);
        self::assertTrue($subject->isHashUpdateNeeded($saltedHashPassword));
    }
}