This repository is what we call a "subtree split": a read-only copy of one directory of the main repository. It is used by Composer to allow developers to depend on specific bundles.
If you want to report or contribute, you should instead open your issue on the main repository: https://github.com/Novactive/Nova-eZPlatform-Bundles
Documentation is available in this repository via .md
files but also packaged here: https://novactive.github.io/Nova-eZPlatform-Bundles/master/2FABundle/README.md.html
Novactive eZ 2FA Bundle provides two-factor authentication for your ezplatform/ibexa project.
- eZ Platform 3.1+
- PHP 7.3
Add the lib to your composer.json, run composer require novactive/ez2fabundle
to refresh dependencies.
Then inject the bundle in the config\bundles.php
of your application.
return [
// ...
Scheb\TwoFactorBundle\SchebTwoFactorBundle::class => ['all' => true],
Novactive\Bundle\eZ2FABundle\NovaeZ2FABundle::class => [ 'all'=> true ],
];
Make sure you add this route to your routing:
# config/routes.yaml
_novaez2fa_routes:
resource: '@NovaeZ2FABundle/Resources/config/routing.yaml'
# config/security.yaml
security:
...
firewalls:
...
ezpublish_front:
pattern: ^/
user_checker: eZ\Publish\Core\MVC\Symfony\Security\UserChecker
anonymous: ~
ezpublish_rest_session: ~
form_login:
require_previous_session: false
csrf_token_generator: security.csrf.token_manager
logout: ~
two_factor:
auth_form_path: 2fa_login # The route name you have used in the routes.yaml
check_path: 2fa_login_check # The route name you have used in the routes.yaml
default_target_path: / # Where to redirect by default after successful authentication
always_use_default_target_path: true # If it should always redirect to default_target_path
...
access_control:
- { path: ^/_fos_user_context_hash, role: PUBLIC_ACCESS }
- { path: ^/logout, role: IS_AUTHENTICATED_ANONYMOUSLY }
- { path: ^/logout, role: IS_AUTHENTICATED_2FA_IN_PROGRESS }
- { path: 2fa_setup$, role: ROLE_USER }
- { path: 2fa_reset$, role: ROLE_USER }
- { path: ^/2fa, role: IS_AUTHENTICATED_2FA_IN_PROGRESS }
- { path: ^/admin/2fa, role: IS_AUTHENTICATED_2FA_IN_PROGRESS }
- { path: ^/_fos_user_context_hash, role: IS_AUTHENTICATED_2FA_IN_PROGRESS }
The values can be updated according to the project specification
# config/packages/scheb_two_factor.yaml
scheb_two_factor:
backup_codes:
enabled: '%nova_ez2fa.backup_codes.enabled%' # Reading the value from the nova_ez2fa.backup_codes.enabled value in parameters section
manager: Novactive\Bundle\eZ2FABundle\Core\BackupCodeManager # This should either remain or be replaced with another one developed for that purpose
google:
enabled: true
server_name: Local Ez Server # Server name used in QR code
issuer: EzIssuer # Issuer name used in QR code
digits: 6 # Number of digits in authentication code
window: 1 # How many codes before/after the current one would be accepted as valid
template: "@ezdesign/2fa/auth.html.twig" # Template for the 2FA login page
# TOTP Authenticator config
totp:
enabled: true # If TOTP authentication should be enabled, default false
server_name: Server Name # Server name used in QR code
issuer: TOTP Issuer # Issuer name used in QR code
window: 1 # How many codes before/after the current one would be accepted as valid
template: "@ezdesign/2fa/auth.html.twig" # Template used to render the authentication form
# Trusted device feature
trusted_device:
enabled: true # If the trusted device feature should be enabled
# manager: acme.custom_trusted_device_manager # Use a custom trusted device manager
lifetime: 259200 # Lifetime of the trusted device token, in seconds
extend_lifetime: false # Automatically extend lifetime of the trusted cookie on re-login
cookie_name: trusted_device # Name of the trusted device cookie
cookie_secure: true # Set the 'Secure' (HTTPS Only) flag on the trusted device cookie
cookie_same_site: "lax" # The same-site option of the cookie, can be "lax", "strict" or null
# cookie_domain: "" # Domain to use when setting the cookie, fallback to the request domain if not set
cookie_path: "/" # Path to use when setting the cookie
email:
enabled: true # If email authentication should be enabled, default false
mailer: Novactive\Bundle\eZ2FABundle\Core\AuthCodeMailer # Use alternative service to send the authentication code
code_generator: Novactive\Bundle\eZ2FABundle\Core\EmailCodeGenerator # Use alternative service to generate authentication code
sender_email: [email protected] # Sender email address
sender_name: John Doe # Sender name
digits: 6 # Number of digits in authentication code
template: "@ezdesign/2fa/auth.html.twig" # Template used to render the authentication form
# The security token classes, which trigger two-factor authentication.
# By default the bundle only reacts to Symfony's username+password authentication. If you want to enable
# two-factor authentication for other authentication methods, add their security token classes.
# See the configuration reference at https://github.com/scheb/two-factor-bundle/blob/4.x/Resources/doc/configuration.md
security_tokens:
- Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken
# If you're using guard-based authentication, you have to use this one:
# - Symfony\Component\Security\Guard\Token\PostAuthenticationGuardToken
# If you're using authenticator-based security (introduced in Symfony 5.1), you have to use this one:
# - Symfony\Component\Security\Http\Authenticator\Token\PostAuthenticationToken
# Whether to use the backup codes or not should be specified here in parameters section, then used in scheb_two_factor.backup_codes
# It's done this way in order to let the user customize if the backup codes should be generated or not
parameters:
nova_ez2fa.backup_codes.enabled: true
If email method is enabled then MAILER_DSN env variable should be specified in the .env file
For full scheb_two_factor reference visit the following resource: https://github.com/scheb/two-factor-bundle/blob/4.x/Resources/doc/configuration.md
Note to keep in mind: This bundle is Siteaccess aware so each Siteaccess can have different authentication method.
# config/packages/nova_ez2fa.yaml
nova_ez2fa:
system:
# Available mobile methods - google, totp, microsoft or null.
# If microsoft is selected the totp mechanism is still used but the config is forced and static so Microsoft Authenticator app can be used.
# Email method can also be enabled or disabled for each siteaccess
# If 2fa_force_setup is true then the User must always set up 2FA upon authentication and reset function is off
default:
2fa_mobile_method: google
2fa_email_method_enabled: true
2fa_force_setup: false
site:
2fa_mobile_method: totp
# if microsoft method set - the config is forced to: algorithm: sha1, period: 30, digits: 6
config:
algorithm: sha1 #(md5, sha1, sha256, sha512)
period: 30
digits: 6
2fa_email_method_enabled: true
2fa_force_setup: false
See the file bundle/Resources/sql/schema.sql
Important!: For the HTTP Cache system (e.g. Varnish or Fastly) the following logic should be implemented:
if (req.url ~ "^/2fa") {
return (pass);
}
and it should be added before the call ez_user_context_hash
line.
We need it in order to avoid triggering the X User Hash mechanism when /2fa request is sent, so the /_fos_user_context_hash
request would not return 302 redirect response because of this bundle.
If some User needs its 2FA record in the database removed to be able to login without entering 2FA code run the following command acx:users:remove-2fa
with specifying user's login:
php ezplatform/bin/console nova:2fa:remove-secret-key user_login
Note to keep in mind: If you have the 2FA already set up for the user and you're going to reset it by following the corresponding link on the 2FA Setup page don't change the method for the current Siteaccess before that! Because in this case the secret key will be supposed to be removed for the new method not for the old one and hence the reset won't work!