umbraco-mfa-login-provider

Implement Umbraco backoffice MFA login provider UI for two-factor authentication enrollment.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-mfa-login-provider-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-mfa-login-provider
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/umbraco-mfa-login-provider
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-mfa-login-provider-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the need to provide a working two-factor authentication (2FA) configuration experience in the Umbraco backoffice so users can enable MFA providers reliably.

Core Features & Use Cases

  • Backoffice MFA setup UI: Implements the front-end login/provider configuration UI for an Umbraco MFA provider, including QR/secret-based enrollment and code verification.
  • Integration with ITwoFactorProvider backend: Loads provider setup data from Umbraco’s management API endpoint and submits verification via a provided callback to validate the secret + code.
  • Extensible provider manifest: Registers the MFA login provider through an Umbraco extension type manifest (alias, provider mapping, UI element, and metadata).

Quick Start

Use the skill to implement your Umbraco MFA login provider UI by wiring a custom element (or the default element) to your backend ITwoFactorProvider and calling the setup/enable APIs.

Frequently Asked Questions about umbraco-mfa-login-provider

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add two-factor authentication setup UI to the Umbraco backoffice?

To add two-factor authentication setup UI to the Umbraco backoffice, you implement a custom MFA login provider by registering an mfaLoginProvider extension type manifest and building a lit-element interface for QR secret enrollment and 6-digit PIN validation.

How does the Umbraco MFA login provider validate user enrollment?

The Umbraco MFA login provider validates user enrollment by loading setup data from the Umbraco management API endpoint and using a provided callback to validate the authenticator secret and 6-digit code, returning an optional error if validation fails.

Can I use lit-element to build a custom two-factor authentication interface for Umbraco?

Yes, you can use lit-element to build a custom two-factor authentication interface for Umbraco by wiring it to your backend ITwoFactorProvider and calling the Umbraco management API setup and enable endpoints for provider configuration.

What is an mfaLoginProvider extension manifest in Umbraco?

An mfaLoginProvider extension manifest in Umbraco is a registration mechanism that maps your custom two-factor authentication provider alias to a UI element and metadata, enabling the backoffice to display the MFA setup and configuration screen.

Do I need a backend ITwoFactorProvider to use Umbraco backoffice MFA setup?

Yes, you need a backend ITwoFactorProvider to supply the setup data loaded from the Umbraco management API and to process the verification callback that validates the user submitted 6-digit PIN and secret.