A simple package to add 2FA login to Umbraco backoffice users
Get Started
$ dotnet add package Umbraco.Community.User2FAReadme
Umbraco Community User2FA
This is a simple package designed for Umbraco V17+ that adds Two Factor Auth (2FA) login to Umbraco backoffice users.
This is based on an Umbraco Docs tutorial, howver I saw this tutorial as mostly plumbing of creating C# files in order to add 2FA and thus package is designed to help save you time in creating these files over and over again.
How to use
- Install the Nuget package into your Umbraco V17 site
- Login to Umbraco backoffice
- Click User avatar top right
- Click button labeled Configure Two Factor
- Enable Two Factor by scanning QR code with a phone such as
2FA Mobile Applications
- Microsoft Authenticator (iOS) | (Android)
- Google Authenticator (iOS) | (Android)
- Twilio Authy (iOS) | (Android)
I have also verified this to work with 1Password Desktop App to save/store the 2FA QR code and generate the correct pin.
Configuration
| Configuration Key | Description |
|---|---|
User2FA:AuthenticatorIssuerName | This is the name that will be displayed in the 2FA app when you scan the QR code, this is useful if you have multiple Umbraco sites and want to differentiate between them. |
{
...
"Umbraco": {
...
},
"User2FA": {
"AuthenticatorIssuerName": "My Awesome Website"
}
...
}
Contributing
The example website project has a backoffice user account setup ready to have a 2FA account applied to it, you can login in with the following credentials.
| Username | Password |
|---|---|
| warren@hackmakedo.com | password1234 |
Attribution
QR Code icons created by small.smiles - Flaticon
Lovingly crafted for you by Warren Buckley❤️
Available for hire