mirror of https://github.com/RobThree/TwoFactorAuth.git synced 2026-08-23 21:16:32 +00:00

Files

T

Nicolas CARPi 76f420e6b2 add SensitiveParameter to sensitive arguments

This change adds the PHP attribute SensitiveParameter to the secret
holding variables.
See: https://www.php.net/manual/en/class.sensitiveparameter

This feature is only available in PHP 8.2, so the minimum php version
required has been updated.

Github Actions now use PHP 8.2 and 8.3 for the tests.
The checkout action has been updated to v4, too.

Fix issue #118

2024-04-15 21:40:19 +02:00

3.8 KiB

Raw Blame History

PHP library for Two Factor Authentication

PHP library for two-factor (or multi-factor) authentication using TOTP and QR-codes. Inspired by, based on but most importantly an improvement on 'PHPGangsta/GoogleAuthenticator'. There's a .Net implementation of this library as well.

Warning:

By default, this package uses the lib/Providers/QRServerProvider.php as QR code generator. This provider is not suggested for applications where absolute security is needed, because it uses an external service for the QR code generation.

You can make use of the included Endroid or Bacon providers which generate locally.

Requirements

Requires PHP version >=8.2
cURL when using the provided QRServerProvider (default), ImageChartsQRCodeProvider or QRicketProvider but you can also provide your own QR-code provider.
random_bytes(), OpenSSL or Hash depending on which built-in RNG you use (TwoFactorAuth will try to 'autodetect' and use the best available); however: feel free to provide your own (CS)RNG.

Optionally, you may need:

sockets if you are using NTPTimeProvider
endroid/qr-code if using EndroidQrCodeProvider or EndroidQrCodeWithLogoProvider.
bacon/bacon-qr-code if using BaconQrCodeProvider.

Installation

The best way of installing this library is with composer:

php composer.phar require robthree/twofactorauth

Usage

For a quick start, have a look at the getting started page or try out the demo.

If you need more in-depth information about the configuration available then you can read through the rest of documentation.

Integrations

CakePHP 3

License

Licensed under MIT license. See LICENSE for details.

Logo / icon under CC0 1.0 Universal (CC0 1.0) Public Domain Dedication (Archived page)

3.8 KiB Raw Blame History