PasswordTestCase.php

Go to the documentation of this file.

<?php
abstract class PasswordTestCase extends MediaWikiTestCase {
    protected $passwordFactory;
 
    protected function setUp() {
        parent::setUp();
 
        $this->passwordFactory = new PasswordFactory();
        foreach ( $this->getTypeConfigs() as $type => $config ) {
            $this->passwordFactory->register( $type, $config );
        }
    }
 
    abstract protected function getTypeConfigs();
 
    public static function providePasswordTests() {
        throw new MWException( "Not implemented" );
    }
 
    public function testHashing( $shouldMatch, $hash, $password ) {
        $passwordObj = $this->passwordFactory->newFromCiphertext( $hash );
        $this->assertSame( $shouldMatch, $passwordObj->verify( $password ) );
    }
 
    public function testStringSerialization( $shouldMatch, $hash, $password ) {
        $hashObj = $this->passwordFactory->newFromCiphertext( $hash );
        $serialized = $hashObj->toString();
        $unserialized = $this->passwordFactory->newFromCiphertext( $serialized );
        $this->assertEquals( $hashObj->toString(), $unserialized->toString() );
    }
 
    public function testInvalidUnequalNormal( $shouldMatch, $hash, $password ) {
        $invalid = $this->passwordFactory->newFromCiphertext( null );
        $normal = $this->passwordFactory->newFromCiphertext( $hash );
 
        $this->assertFalse( $invalid->equals( $normal ) );
        $this->assertFalse( $normal->equals( $invalid ) );
        $this->assertFalse( $invalid->verify( $hash ) );
    }
 
    protected function getValidTypes() {
        return array_keys( $this->getTypeConfigs() );
    }
 
    public function provideTypes( $type ) {
        $params = [];
        foreach ( $this->getValidTypes() as $type ) {
            $params[] = [ $type ];
        }
        return $params;
    }
 
    public function testCrypt( $type ) {
        $fromType = $this->passwordFactory->newFromType( $type );
        $fromType->crypt( 'password' );
        $fromPlaintext = $this->passwordFactory->newFromPlaintext( 'password', $fromType );
        $this->assertTrue( $fromType->verify( 'password' ) );
        $this->assertTrue( $fromPlaintext->verify( 'password' ) );
        $this->assertFalse( $fromType->verify( 'different password' ) );
        $this->assertFalse( $fromPlaintext->verify( 'different password' ) );
        $this->assertEquals( get_class( $fromType ),
            get_class( $fromPlaintext ),
            'newFromPlaintext() should produce instance of the same class as newFromType()'
        );
    }
}