Need help with 2fa?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

303 Stars 32 Forks MIT License 1.1K Commits 11 Opened issues


Two-factor authentication for Symfony applications 🔐

Services available


Need anything else?

Contributors list


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

Build Status Scrutinizer Code Quality Code Coverage Latest Stable Version Monthly Downloads Total Downloads License

SchebTwoFactorBundle Logo

ℹ️ The repository contains bundle versions ≥ 5, which are compatible with Symfony 4.4 or later. The older (unsupported) versions are located in the scheb/two-factor-bundle repository.

The bundle is split into sub-packages, so you can choose the exact feature set you need and keep installed dependencies to a minimum.

Core features are provided by

  • Interface for custom two-factor authentication methods
  • Trusted IPs
  • Multi-factor authentication (more than 2 steps)
  • CSRF protection
  • Whitelisted routes (accessible during two-factor authentication)
  • Fully customizable conditions when to perform two-factor authentication
  • Future proof: Supports the authenticator-based security system, which will replace the current system in Symfony 6

Additional features:

  • 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 (
  • QR codes to scan with your mobile device (

Two-factor authentication methods:


Follow the installation instructions.


Detailed documentation of all features can be found on the Symfony Bundles Documentation website.


This repository contains a small test application that can be quickly set-up locally to test two-factor authentication in a real Symfony environment. Check out the readme file in the

folder for more details.

Version Guidance

| Version | Status | Symfony Version | |--------------------|-------------------------------|------------------| | 1.x | EOL | >= 2.1, < 2.7 | | 2.x | EOL | ^2.6, ^3.0, ^4.0 | | 3.x | EOL | 3.4, ^4.0, ^5.0 | | 4.x | Security fixes until Nov 2021 | 3.4, ^4.0, ^5.0 | | 5.x | New features + Bug fixes | 4.4, ^5.0 | | 6.x | Planned for Nov 2021 | 5.4, ^6.0 |


This software is available under the MIT license.


For information about the security policy and know security issues, see


Want to contribute to this project? See

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.