=== Google Authenticator for WordPress ===
Contributors: julien731
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=E9SPA3AV3J364
Tags: security,authenticator,2-factor authentication,2fa,google,app,google authenticator
Requires at least: 3.0
Tested up to: 3.8
Stable tag: 1.0.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A Google Authenticator WordPress plugin which adds 2-factor authentication to your blog.

== Description ==

If you are concerned about security, you should look into 2-factor authentication.

*Quick reminder:* 2-factor authentication adds an extra layer of security by requesting a one time password in addition to standard username / password credentials.

This plugin uses the Google Authenticator app. I bet you know Google, and you probably know they have some good products out there. Google Authenticator is one of them.

[Download the Google Authenticator app](https://support.google.com/accounts/answer/1066447?hl=en) on your phone (iPhone, Android or Blackberry). Install this plugin on your site. After activating it and generating a secret key, you will be able to add the site to your app by scanning a QR code. That's it!

The QR code is generated with Google Charts API using HTTPS to avoid security issues while sending your secret for generation.

What the plugin does:
---
- Adds 2-factor authentication to WordPress login page,
- Can be eanbled for each user independantly,
- Admin can force users to use 2FA (and limit the number of allowed logins without setting up 2FA),
- If admin forces users to use 2FA, users who didn't set it up will be reminded with a warning in their dashboard,
- Set any name you want to appear in the Google Authenticator app,
- Allow clock discrepancy (mins +/-),
- Users can generate a new secret key anytime,
- Admin can revoke any user's key at anytime,
- If a user is locked-out after logging-in too many times without using 2FA, admin can reset the counter,
- Used one time passwords are hashed and stored in the DB to avoid multiple use (in case of interception by an attacker)
- Recovery code in case the user can't use the app

== Installation ==

1. Upload `wp-google-authenticator` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Activate, generate your secret, scann the QR code with your phone

Setup tutorial [available here](http://julienliabeuf.com/wordpres-2-factor-authentication/).

== Frequently asked questions ==

= What if a user is unable to generate his TOTP (phone lost, stolen, reset...)? =

The user can use his recovery code to disable 2FA for his account. Alternatively, an admin can edit the user's profile and revoke his secret. The user will then be able to login again and re-generate a secret.

== Screenshots ==

1. Plugin settings
2. Edit profile screen
3. Admin view of the user edit screen

== Changelog ==

= v1.0.4 =
* Add recovery code feature
* Update translations

= v1.0.3 =
* Add support for WordPress Android / iPhone app
* Add French translation

= v1.0.2 =
* Update version number
* Remove double confirmation message after saving options
* Update option label and disable TOTP if plugin is not set to Active

= v1.0.1 =
* Only push the trunk

= v1.0.0 =
* First release of the plugin