https://github.com/hryvinskyi/magento2-two-factor-auth-bypass
Module for bypassing Magento 2 two-factor authentication via environment configuration
https://github.com/hryvinskyi/magento2-two-factor-auth-bypass
2fa 2fa-security 2factor development magento
Last synced: 5 months ago
JSON representation
Module for bypassing Magento 2 two-factor authentication via environment configuration
- Host: GitHub
- URL: https://github.com/hryvinskyi/magento2-two-factor-auth-bypass
- Owner: hryvinskyi
- Created: 2025-09-11T20:34:50.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-11T20:35:56.000Z (9 months ago)
- Last Synced: 2025-11-10T01:14:12.365Z (7 months ago)
- Topics: 2fa, 2fa-security, 2factor, development, magento
- Language: PHP
- Homepage:
- Size: 26.4 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bypass Two Factor (2FA) Auth for Magento 2 (Adobe Commerce)
This Magento 2 module developed for bypassing two-factor authentication on staging or development environments.
It allows you to disable 2FA for admin panel access and API token generation via environment configuration (app/etc/env.php) or console commands.
## Installation
### Manual Installation
1. Copy the module to `app/code/Hryvinskyi/TwoFactorAuthBypass/`
2. Run: `bin/magento module:enable Hryvinskyi_TwoFactorAuthBypass`
3. Run: `bin/magento setup:upgrade`
4. Run: `bin/magento setup:di:compile`
### Composer Installation
```bash
composer require hryvinskyi/magento2-two-factor-auth-bypass
bin/magento module:enable Hryvinskyi_TwoFactorAuthBypass
bin/magento setup:upgrade
bin/magento setup:di:compile
```
## Configuration
### Manual Configuration
Add the following configuration to your `app/etc/env.php`:
```php
return [
// ... other configuration
'two_factor_auth_bypass' => [
'enabled' => true, // Bypass 2FA for admin access
'api_enabled' => true, // Bypass 2FA for API token generation
],
];
```
### Console Commands
Alternatively, use the provided console commands:
```bash
# Enable bypass for both admin and API (default)
bin/magento hryvinskyi:2fa:bypass:enable
# Enable bypass for admin access only
bin/magento hryvinskyi:2fa:bypass:enable --admin
# Enable bypass for API token generation only
bin/magento hryvinskyi:2fa:bypass:enable --api
# Disable bypass for both admin and API (default)
bin/magento hryvinskyi:2fa:bypass:disable
# Disable bypass for admin access only
bin/magento hryvinskyi:2fa:bypass:disable --admin
# Disable bypass for API token generation only
bin/magento hryvinskyi:2fa:bypass:disable --api
# Check current bypass status
bin/magento hryvinskyi:2fa:bypass:status
```
### Configuration Options
| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `enabled` | boolean | `false` | Enable bypass for admin panel access |
| `api_enabled` | boolean | `false` | Enable bypass for API token generation |
## Requirements
- PHP 8.1+
- Magento 2.4.6+
- Magento_TwoFactorAuth module
## Support
If you encounter any issues or have questions, please contact the author or open an issue on GitHub.
## License
This module is licensed under the MIT License - see the LICENSE file for details.
## Author
Volodymyr Hryvinskyi
Email: volodymyr@hryvinskyi.com
GitHub: https://github.com/hryvinskyi