Developer’s Guide

The Salted user password hashes extension is written in an OOP style and thus makes it very easy to extend or use it in your TYPO3 extension.

Creating a hash

When you want to create a new salted user password hash from a given plain-text password, these are the steps to be done:

  • check if salted user password hashes is enabled for the desired TYPO3 mode (frontend/backend)
  • let the factory deliver an instance of the default hashing class
  • create the salted user password hash

Example implementation for TYPO3 frontend:

// plain-text password
$password = 'XXX';
$saltedPassword = '';

    if (\TYPO3\CMS\Saltedpasswords\Utility\SaltedPasswordsUtility::isUsageEnabled('FE')) {
            $objSalt = \TYPO3\CMS\Saltedpasswords\Salt\SaltFactory::getSaltingInstance(NULL);
            if (is_object($objSalt)) {
                    $saltedPassword = $objSalt->getHashedPassword($password);
            }
    }

Checking a password

When you want to check a plain-text password against a salted user password hash, these are the steps to be done:

  • check if salted user password hashes is enabled for the TYPO3 mode (frontend only)
  • let the factory deliver an instance of the according hashing class
  • compare plain-text password with salted user password hash

Example implementation for TYPO3 frontend:

// plain-text password
$password = 'XXX';
// salted user password hash
$saltedPassword = 'YYY';
// keeps status if plain-text password matches given salted user password hash
$success = FALSE;

if (\TYPO3\CMS\Saltedpasswords\Utility\SaltedPasswordsUtility::isUsageEnabled('FE')) {
        $objSalt = \TYPO3\CMS\Saltedpasswords\Salt\SaltFactory::getSaltingInstance($saltedPassword);
        if (is_object($objSalt)) {
                $success = $objSalt->checkPassword($password, $saltedPassword);
        }
}

Adding a new salting method

If you decide to add an additional salting method, you can easily make such additional method available for this extension.

Steps to be done:

  • create a new salting class that implements interface \TYPO3\CMS\Saltedpasswords\Salt\SaltInterface and abstract class \TYPO3\CMS\Saltedpasswords\Salt\AbstractSalt (see class \TYPO3\CMS\Saltedpasswords\Salt\Md5Salt for an example implementation)
  • register your salting method class ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/saltedpasswords']['saltMethods']) to make it available for the salt factory (see ClassesSaltSaltFactory.php for an example)