=== Drupal Password Encryption === Contributors: BevanR Tags: drupal, password, import, migration, authentication, security Requires at least: 4.1.1 Tested up to: 4.1.1 Stable tag: trunk License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html

Support Drupal's password encryption algorithms. Most useful for users imported from a Drupal website. Or simply for more secure password encryption.

== Description ==

The Drupal Password Encryption plugin enables support for Drupal's password encryption algorithms.

A password encryption algorithm is the method is used to secure a password when preparing to save it to the database, such as when registering a new user account, changing a password, or checking if a password is correct when logging in.

This plugin is most useful for users imported from a Drupal website. Users' passwords can be migrated (with no processing) from Drupal's users.pass database column to WP's wp_users.user_pass column. Then, once the plugin is activated, users can login to the WP website using the same password they used to login to the Drupal website, without needing a password reset.

This plugin is also useful to simply enable stronger password encryption in WordPress.

Once this plugin is activated, any existing WP user (that was not migrated from Drupal) will still be able to login using their same password. This is possible because phpass is one of several algorithms that Drupal supports. (phpass is WP core's default password encryption algorithm.) However, until the user changes or resets their password, it will remain encrypted using phpass.

The plugin works by overriding WP's pluggable functions wp_hash_password() and wp_check_password() to invoke the equivalent functions in Drupal 7's password.inc, which is included with the plugin's files.

This plugin may work on earlier versions of WordPress. Please share your findings if you try it.

== Installation ==

1. Upload the drupal-password-encryption/ directory to wp-content/plugins/drupal-password-encryption/.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Sleep more peacefully, knowing that if your database becomes compromised it will be significantly more difficult for a hacker to retrieve any passwords that are set or updated between now and when the database is compromised.
4. Optionally, import users from a Drupal website, migrating users.pass in the Drupal website's database to wp_users.user_pass in the WP website's database.
5. Optionally, change the password of any user account whose security is more important, such as administrators. You can change it to the same password.

== Frequently Asked Questions ==

= Will existing users need to reset their password before they can login? =

No. Drupal supports WP core's password encryption algorithm too. So they can continue to login using the same password even after the plugin is activated.

= Will imported users need to reset their password before they can login? =

No. Once the plugin is activated and passwords correctly migrated, the plugin will allow imported users to login with the same password as they used on the Drupal website.

= What will the imported user's username and email address be? =

This plugin does not migrate any user data for you. So imported users' usernames and email addresses will depend on how you import them from the source.

= Why does Drupal support multiple password encryption algorithms? =

Drupal has upgraded its password encryption several times. But stored passwords can not be updated without the unencrypted (plain text) password, which is only available when logging in.

Drupal does update passwords stored using older encryption algorithms when the user logs in. But all old algorithms must be supported until there are no more passwords stored using old algorithms, which might never be happen.

= Does the plugin update passwords encrypted by WP core? =

When a password is changed or reset Drupal's default encryption algorithm (the most secure) is used.

However this plugin does not update passwords when a user logs in, like Drupal does, as described above. This feature would be a welcome contribution.

= How can I contribute a bug fix or feature? =

Submit a GitHub pull request; https://github.com/BevanR/Drupal-password-encryption-for-WordPress

= What is wrong with WP core's password algorithm (phpass)? =

Nothing per se.

However as computer hardware gets faster and hackers create more powerful tools, encrypted data gets easier to break by "brute force". More advanced encryption algorithms keep data security ahead of the curve and make it harder to hack encrypted data.

WP core's password algorithm (phpass) is older than some alternatives. Many tools (e.g. rainbow tables) are available to make it relatively easy for hackers to get plain text passwords from phpass-encrypted data.

Of course, the attacker first needs a copy of the encrypted data (your database) before they can start trying to retrieve plain text passwords from the encrypted data.