ElnurBlowfishPasswordEncoderBundle

Still using MD5 or SHA family hashing algorithms for password “encryption”? If you are, read this and that and then come back to get yourself a copy of this bundle.

Installation

1. Add this to the deps file:

   [ElnurBlowfishPasswordEncoderBundle]
       git=http://github.com/elnur/ElnurBlowfishPasswordEncoderBundle.git
       target=/bundles/Elnur/BlowfishPasswordEncoderBundle
   

   And run bin/vendors install.

2. Register the Elnur namespace in the app/autoload.php file:

   $loader->registerNamespaces(array(
       // ...
       'Elnur'            => __DIR__.'/../vendor/bundles',
   ));
   

3. Register the bundle in the app/AppKernel.php file:

   public function registerBundles()
   {
       $bundles = array(
           // ...
           new Elnur\BlowfishPasswordEncoderBundle\ElnurBlowfishPasswordEncoderBundle(),
       );
   }
   

4. And, finally, set the encoder in the app/config/security.yml file:

   security:
       encoders:
           Symfony\Component\Security\Core\User\User:
               id: security.encoder.blowfish
   

Configuration

By default the encoder uses a cost factor of 15, which is pretty reasonable, but you can change it to a different value in the range of 4-31 by editing the config.yml file:

elnur_blowfish_password_encoder:
    cost: 10

Each increment of the cost doubles the time it takes to encode a password.

You can change the cost factor at any time — even if you already have some passwords encoded using a different cost factor. New passwords will be encoded using the new cost factor, while the already encoded ones will be validated using a cost factor that was used back when they were encoded.

Usage

A salt for each new password is generated automatically and need not be persisted. Since an encoded password contains the salt used to encode it, persisting the encoded password alone is enough.

All the encoded passwords are 60 characters long, so make sure to allocate enough space for them to be persisted.

License

This bundle is under the MIT license. See the complete license in the bundle:

Resources/meta/LICENSE

Acknowledgements

I thank asm89 for enlightening me by giving the links you see above and answering my other related questions on the #symfony channel.

And I thank dustin10 for suggesting to add the extension class to make the bundle easier to install and configure.