punkTwoFactor 18.0.0
dotnet add package punkTwoFactor --version 18.0.0
NuGet\Install-Package punkTwoFactor -Version 18.0.0
<PackageReference Include="punkTwoFactor" Version="18.0.0" />
<PackageVersion Include="punkTwoFactor" Version="18.0.0" />
<PackageReference Include="punkTwoFactor" />
paket add punkTwoFactor --version 18.0.0
#r "nuget: punkTwoFactor, 18.0.0"
#:package punkTwoFactor@18.0.0
#addin nuget:?package=punkTwoFactor&version=18.0.0
#tool nuget:?package=punkTwoFactor&version=18.0.0
punkTwoFactor
An Umbraco package that sets up Two Factor Authentication (2FA) for Umbraco backoffice users and members using standard TOTP authenticator apps (e.g., Google Authenticator, Microsoft Authenticator, 1Password).
NuGet
dotnet add package punkTwoFactor
or
Install-Package punkTwoFactor
https://www.nuget.org/packages/punkTwoFactor/
Configuration
In Umbraco 18+, punkTwoFactor automatically registers itself via an Umbraco IComposer on startup.
Optionally add the following section to your appsettings.json to customize the authenticator issuer name or provider identifier:
"punkTwoFactor": {
"ProviderName": "Two Factor Authentication",
"Issuer": "My Umbraco Site"
}
Issuer: The display name shown inside authenticator apps (e.g. Google Authenticator, Microsoft Authenticator).ProviderName: The technical name used to register the provider (defaults to"Two Factor Authentication").
Usage in Backoffice
- Log into the Umbraco backoffice.
- Click your user avatar in the top-right corner.
- Click Configure Two-Factor.
- Click Enable on Two Factor Authentication.
- Scan the QR code with your mobile authenticator app and enter the 6-digit verification code.
Custom Registration (Optional)
If you prefer to configure or register the provider manually in code:
using punkTwoFactor.Extensions;
// Configure options from appsettings:
services.ConfigureTwoFactorConfig(builder.Config);
// Or configure via builder:
builder.AddBackOfficeTwoFactorAuthentication();
builder.AddMemberTwoFactorAuthentication();
Compatibility
- Umbraco 18+
- .NET 10+
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- GoogleAuthenticator (>= 3.2.0)
- Umbraco.Cms.Api.Management (>= 18.2.1)
- Umbraco.Cms.Core (>= 18.2.1)
- Umbraco.Cms.Web.Common (>= 18.2.1)
- Umbraco.Cms.Web.Website (>= 18.2.1)
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 |
|---|---|---|
| 18.0.0 | 352 | 10/8/2026 |
| 17.0.0 | 100 | 10/6/2026 |
| 10.6.1 | 19,377 | 7/14/2023 |
| 10.4.4 | 3,727 | 3/17/2023 |
| 10.4.3 | 456 | 3/17/2023 |
| 10.4.2 | 546 | 1/25/2023 |
| 10.4.1 | 475 | 1/25/2023 |
| 10.1.1 | 863 | 8/24/2022 |
| 10.1.0 | 651 | 8/12/2022 |
| 1.0.5 | 756 | 6/15/2022 |
| 1.0.4 | 697 | 5/23/2022 |
| 1.0.3 | 673 | 5/23/2022 |
| 1.0.2 | 694 | 5/23/2022 |
| 1.0.1 | 675 | 5/23/2022 |
| 1.0.0 | 655 | 5/23/2022 |
| 0.0.9 | 705 | 5/23/2022 |
| 0.0.7 | 678 | 5/18/2022 |
| 0.0.6 | 687 | 5/18/2022 |
| 0.0.5 | 654 | 5/18/2022 |
| 0.0.4 | 673 | 5/18/2022 |