Events
Authentication Events
The bundle dispatches the following events during the authentication process:
scheb_two_factor.authentication.require
Constant: Scheb
Event class: Scheb
Is dispatched when two-factor authentication is required for the user. This happens when you try to access a path that requires you to be fully authenticated. It also happens when you successfully complete a two-factor authentication step, but there's another two-factor step required (multi-factor authentication).
Usually, when this event is dispatched, the request is redirected to the two-factor authentication form.
scheb_two_factor.authentication.form
Constant: Scheb
Event class: Scheb
Is dispatched when the two-factor authentication form is shown.
scheb_two_factor.authentication.attempt
Constant: Scheb
Event class: Scheb
Is dispatched when two-factor authentication is attempted, right before checking the code.
scheb_two_factor.authentication.success
Constant: Scheb
Event class: Scheb
Is dispatched when two-factor authentication was successful for a single provider. That doesn't mean the entire two-factor process is completed.
scheb_two_factor.authentication.failure
Constant: Scheb
Event class: Scheb
Is dispatched when the given two-factor authentication code was incorrect.
scheb_two_factor.authentication.complete
Constant: Scheb
Event class: Scheb
Is dispatched when the entire two-factor authentication process was completed successfully, that means two-factor authentication code was correct for all providers required and the user is now fully authenticated.
Backup Code Events
If you have the backup codes extension installed, the following events are dispatched:
scheb_two_factor.backup_code.check
Constant: Scheb
Event class: Scheb
Is dispatched whenever a code is checked if it is a valid backup code.
scheb_two_factor.backup_code.valid
Constant: Scheb
Event class: Scheb
Is dispatched when the code was deemed to be a valid backup code.
scheb_two_factor.backup_code.invalid
Constant: Scheb
Event class: Scheb
Is dispatched when the code was deemed to be a invalid backup code.
Email Authentication Events
The following events are dispatched when the email code authentication provider is used:
scheb_two_factor.provider.email.sent
Constant: Scheb
Event class: Scheb
Is dispatched whenever a code was sent via email to the user.
scheb_two_factor.provider.email.check
Constant: Scheb
Event class: Scheb
Is dispatched whenever a code is checked if it is a valid email code.
scheb_two_factor.provider.email.valid
Constant: Scheb
Event class: Scheb
Is dispatched when the code was deemed to be a valid email code.
scheb_two_factor.provider.email.invalid
Constant: Scheb
Event class: Scheb
Is dispatched when the code was deemed to be a invalid email code.
Google Authenticator Events
The following events are dispatched when the Google Authenticator authentication provider is used:
scheb_two_factor.provider.google.check
Constant: Scheb
Event class: Scheb
Is dispatched whenever a code is checked if it is a valid Google Authenticator code.
scheb_two_factor.provider.google.valid
Constant: Scheb
Event class: Scheb
Is dispatched when the code was deemed to be a valid Google Authenticator code.
scheb_two_factor.provider.google.invalid
Constant: Scheb
Event class: Scheb
Is dispatched when the code was deemed to be a invalid Google Authenticator code.
TOTP Authentication Events
The following events are dispatched when the TOTP authentication provider is used:
scheb_two_factor.provider.totp.check
Constant: Scheb
Event class: Scheb
Is dispatched whenever a code is checked if it is a valid TOTP code.
scheb_two_factor.provider.totp.valid
Constant: Scheb
Event class: Scheb
Is dispatched when the code was deemed to be a valid TOTP code.
scheb_two_factor.provider.totp.invalid
Constant: Scheb
Event class: Scheb
Is dispatched when the code was deemed to be a invalid TOTP code.