tinect / shopware6-two-factor-auth
Two Factor Authentication plugin
Package info
github.com/tinect/shopware6-two-factor-auth
Type:shopware-platform-plugin
pkg:composer/tinect/shopware6-two-factor-auth
Requires
- bacon/bacon-qr-code: ^3.1
- pragmarx/google2fa: ^9.1
- shopware/administration: ~6.7.2
- shopware/core: ~6.7.2
- shopware/storefront: ~6.7.2
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
Replaces
None
This package is auto-updated.
Last update: 2026-11-16 09:10:21 UTC
README
Fork notice This is a maintained fork of runelaenen/shopware6-two-factor-auth, originally created and published by Rune Laenen and Kraftware. The original repository seems no longer maintained, so this fork continues development under the package name
tinect/shopware6-two-factor-auth.
Add extra security to your Shopware 6 shop by enabling Two Factor Authentication.
Adds an extra prompt to admin- or customer-accounts in your Shopware 6 website.
Features
- 'Google Authenticator' provider
- Storefront customer 2FA
- Admin user 2FA
- Local QR code generation
- Fully localized:
- English
- German
- French
- Dutch
- Polish
Providers
At the moment only Google Authenticator (compatible) apps are supported. For example Google Authenticator, Authy, LastPass, Bitwarden, ...
Installation guide
This plugin can only be installed using Composer.
# Install plugin using composer
composer require tinect/shopware6-two-factor-auth
# Refresh plugins & install & activate plugin
bin/console plugin:refresh
bin/console plugin:install --activate TinectTwoFactorAuth
# Build javascript files
bin/build-js.sh
Store API
Customers with 2FA enabled have to send their one-time password with the login request as tinect2faOtp:
POST /store-api/account/login
{"email": "customer@example.com", "password": "...", "tinect2faOtp": "123456"}
Without it the request fails with a 401 and the error code TINECT_2FA__OTP_REQUIRED, so the frontend knows to ask for
the code and send the login again. A wrong code returns TINECT_2FA__OTP_INVALID.
Updating from 8.0 or older
Secrets used to be stored in the rl_2fa_secret custom field of customers and users, where the Store API and
Admin API returned them. The update moves them to their own tables and removes the custom field. Enabled accounts
keep working, but downgrading after the update turns 2FA off for those accounts.
Development
Keep in mind that 2FA authentication will not work in the development Administration watcher mode.
Migrating from runelaenen/shopware6-two-factor-auth
The plugin technical name changed from RuneLaenenTwoFactorAuth to TinectTwoFactorAuth.
Existing 2FA secrets (the rl_2fa_secret custom field, or the rl_2fa_customer_secret /
rl_2fa_user_secret tables of newer versions) are kept as-is, so users do not have to
re-register their authenticator apps. The plugin configuration
(RuneLaenenTwoFactorAuth.config.* vs. TinectTwoFactorAuth.config.*) is not migrated
and has to be set again after switching.
Everything else that carried the rl prefix is now prefixed with tinect. Adjust your
project if you rely on any of these:
| Before | After |
|---|---|
snippet keys rl-2fa.* |
tinect-2fa.* |
routes frontend.rl2fa.*, widgets.rl-2fa.* |
frontend.tinect2fa.*, widgets.tinect-2fa.* |
URLs /rl-2fa/... |
/tinect-2fa/... |
admin API _action/rl-2fa |
_action/tinect-2fa |
OAuth token parameters rl_2fa_otp, rl_2fa_ticket |
tinect_2fa_otp, tinect_2fa_ticket |
Store API login parameter rl2faOtp |
tinect2faOtp |
error codes / session keys RL_2FA_* |
TINECT_2FA_* |
CSS .rl-2fa-*, .rl2fa-* |
.tinect-2fa-*, .tinect2fa-* |
storefront plugin Rl2faVerificationPlugin, data-rl2fa-verification-plugin |
Tinect2faVerificationPlugin, data-tinect2fa-verification-plugin |
admin component rl-user-otp, service rl2faService, Twig filter rl2fa_main_js |
tinect-user-otp, tinect2faService, tinect2fa_main_js |
custom field rl_2fa_secret, tables rl_2fa_customer_secret, rl_2fa_user_secret |
unchanged |
composer remove runelaenen/shopware6-two-factor-auth
composer require tinect/shopware6-two-factor-auth
bin/console plugin:refresh
bin/console plugin:install --activate TinectTwoFactorAuth
Credits
Original author: Rune Laenen / Kraftware — MIT licensed. Thanks to all contributors of the original project.
