README

⚠ Unmaintained version

Please upgrade your project to a recent version. Use bundle version 5 (or newer), which is available as scheb/2fa-bundle from the scheb/2fa repository.

This bundle provides two-factor authentication for your Symfony application.

It comes with the following two-factor authentication methods:

• TOTP authentication
• Google Authenticator
• Authentication code via email

Additional features you will like:

• Interface for custom two-factor authentication methods
• Trusted IPs
• Trusted devices (once passed, no more two-factor authentication on that device)
• Single-use backup codes for when you don't have access to the second factor device
• Multi-factor authentication (more than 2 steps)
• CSRF protection
• Whitelisted routes (accessible during two-factor authentication)

Installation

composer require scheb/two-factor-bundle

... and follow the installation instructions.

Documentation

Detailed documentation of all features can be found in the Resources/doc directory.

Version Guidance

⚠ Version 4.x is no longer maintained.

Please upgrade your project to a recent version. Use bundle version 5 (or newer), which is available as scheb/2fa-bundle from the scheb/2fa repository.

License

This bundle is available under the MIT license.

Security

For information about the security policy and know security issues, see SECURITY.md.

Contributing

Want to contribute to this project? See CONTRIBUTING.md.

Support Me

I'm developing this library since 2014. I love to hear from people using it, giving me the motivation to keep working on my open source projects.

If you want to let me know you're finding it useful, please consider giving it a star ⭐ on GitHub.

If you love my work and want to say thank you, you can help me out for a beer 🍻️ via PayPal.