Awesome Open Source
Awesome Open Source


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

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


ℹ️ The repository contains bundle versions ≥ 5, versions 1-4 are located in scheb/two-factor-bundle.

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

Core features provided by scheb/2fa-bundle:

  • 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)

Additional features:

  • Trusted devices (once passed, no more two-factor authentication on that device) (scheb/2fa-trusted-device)
  • Single-use backup codes for when you don't have access to the second factor device (scheb/2fa-backup-code)
  • QR codes to scan with your mobile device (scheb/2fa-qr-code)

Two-factor authentication methods:


Follow the installation instructions.


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

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


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


Want to contribute to this project? See


This software is available under the MIT license.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
php (15,831
security (1,767
symfony (450
symfony-bundle (163
2fa (47
two-factor-authentication (38

Find Open Source By Browsing 7,000 Topics Across 59 Categories