Umbraco.Community.User2FA 19.0.0

dotnet add package Umbraco.Community.User2FA --version 19.0.0
                    
NuGet\Install-Package Umbraco.Community.User2FA -Version 19.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Umbraco.Community.User2FA" Version="19.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Umbraco.Community.User2FA" Version="19.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Umbraco.Community.User2FA" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Umbraco.Community.User2FA --version 19.0.0
                    
#r "nuget: Umbraco.Community.User2FA, 19.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Umbraco.Community.User2FA@19.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Umbraco.Community.User2FA&version=19.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Umbraco.Community.User2FA&version=19.0.0
                    
Install as a Cake Tool

Umbraco Community User2FA

This is a simple package designed for Umbraco V17+ (see version compatibility) 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.

Version compatibility

The package major version matches the Umbraco major version it supports.

Package version Umbraco version
19.x 19
18.x 18
17.x 17

Upgrading a site to Umbraco 19? If your build fails with ApplyCompressionNegotiation ... Endpoints not found for related asset, add <CompressionEnabled>false</CompressionEnabled> to your site's .csproj (the project containing the /umbraco folder). Umbraco has recommended this since v15 and the dotnet new umbraco template already includes it, but sites missing it fail to build on Umbraco 19. This is a site setting, not something this package needs. See Umbraco's docs on handling precompressed files.

How to use

  • Install the Nuget package version matching your Umbraco major version
  • 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

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❤️<br/> Available for hire

Product Compatible and additional computed target framework versions.
.NET net11.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
19.0.0 66 11/13/2026
18.0.0 238 6/25/2026
17.0.0 5,365 11/27/2025
1.0.3 390 11/7/2025
1.0.2 627 3/17/2025
1.0.1 302 7/14/2024
1.0.0 233 7/11/2024