- Copyright (c) 2012-2016, http://www.phpgangsta.de
- Author: Michael Kliewe, @PHPGangsta and contributors
- Licensed under the BSD License.
This PHP class can be used to interact with the Google Authenticator mobile app for 2-factor-authentication. This class can generate secrets, generate codes, validate codes and present a QR-Code for scanning the secret. It implements TOTP according to RFC6238
For a secure installation you have to make sure that used codes cannot be reused (replay-attack). You also need to limit the number of verifications, to fight against brute-force attacks. For example you could limit the amount of verifications to 10 tries within 10 minutes for one IP address (or IPv6 block). It depends on your environment.
Exemplo:
<?php
require 'GoogleAuthenticator.php';
$mytoken = "AndersonBravo";
$ga = new PHPGangsta_GoogleAuthenticator();
$secret = $ga->createSecret();
// SECRET deve ser salvo no banco de dados ou arquivo de configuração
// para comparação mais tarde quando o usuário digitar o
// código gerado no app GoogleAuthenticator
// Gerando a url do QR-Code para ser scaneado
// pelo app GoogleAuthenticator
$qrCodeUrl = $ga->getQRCodeGoogleUrl($mytoken, $secret);
Autenticando pelo Google Authenticator:
<?php
// Acessar página que vai solicitar o código do Google Authenticator
// Abrir app e verificar o código para digitar na página
// podemos gerar os códigos via php também:
// $code = $ga->getCode($secret);
$code = $_POST['code'];
// a funcao abaixo verifica se o codigo informado bate com
// a chave gerada e armazenada anteriormente
$checkResult = $ga->verifyCode($secret, $code, 2); // 2 = 2*30sec clock tolerance
if ($checkResult) {
echo 'OK';
} else {
echo 'FAILED';
}
-
Use Composer to install the package
-
From project root directory execute following
composer install
-
Composer will take care of autoloading the library. Just include the following at the top of your file
require_once __DIR__ . '/../vendor/autoload.php';
- All tests are inside
tests
folder. - Execute
composer install
and then run the tests from project root directory - Run as
phpunit tests
from the project root directory
- ??? What do you need?
If you like this script or have some features to add: contact me, visit my blog, fork this project, send pull requests, you know how it works.