Skip to content
/ 2fa Public

Two-factor authentication for Symfony applications πŸ”

License

Notifications You must be signed in to change notification settings

scheb/2fa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

42c8476 Β· Oct 20, 2024
Oct 20, 2024
Oct 20, 2024
Dec 28, 2021
Apr 17, 2024
Oct 20, 2024
Oct 5, 2024
Jan 7, 2022
Jun 15, 2020
Dec 30, 2021
May 4, 2021
Dec 3, 2023
Apr 19, 2024
Dec 3, 2023
Dec 3, 2023
Jan 3, 2022
Dec 3, 2023
Jun 4, 2020
Dec 3, 2023
Oct 20, 2024
Dec 3, 2023
Dec 3, 2023
Aug 5, 2023

Repository files navigation

scheb/2fa

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

Build Status 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 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)
  • 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) (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

Two-factor authentication methods:

Installation

Follow the installation instructions.

Documentation

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

Demo

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 app 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 EOL 3.4, ^4.0, ^5.0
5.x EOL 4.4, ^5.0
6.x Bug & security fixes 5.4, ^6.0
7.x New features + Bug fixes 6.4, ^7.0

License

This software 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.