umbraco-mfa-login-provider

Implement Umbraco backoffice MFA login provider UI with manifest and configuration element.

4|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-mfa-login-provider-albanistrefi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-mfa-login-provider
Source: https://github.com/albanistrefi/umbraco_CLI/tree/main/skills/backend/umbraco-mfa-login-provider
Command: npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-mfa-login-provider-albanistrefi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you implement a Two-Factor Authentication (2FA) login provider experience in the Umbraco backoffice by generating the required frontend configuration UI and wiring it to your backend ITwoFactorProvider.

Core Features & Use Cases

  • Docs-driven implementation workflow: Fetches and uses the latest Umbraco documentation for two-factor authentication, extension types, and foundation concepts to avoid drift and incorrect integration patterns.
  • MFA provider frontend setup: Produces the manifest configuration for an mfaLoginProvider, including aliasing, labeling, and configuration element wiring.
  • Config element implementation guidance: Provides a pattern for a setup element that loads QR/secret setup data from the Management API and validates user codes via a callback, with clear UI states (loading, submit, success/error).
  • Use Case: When you add a custom MFA method (e.g., authenticator app provider backed by your own ITwoFactorProvider), you use this skill to ensure the backoffice UI is properly registered and testable.

Quick Start

Ask the AI to implement an Umbraco MFA login provider UI for your chosen 2FA method by following the official docs, generating the manifest, and producing the frontend setup element that calls the Management API to render QR/secret and validate verification codes.

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 implement two-factor authentication UI for the Umbraco backoffice?

To implement two-factor authentication UI for the Umbraco backoffice, you define an mfaLoginProvider extension and a configuration element that loads setup data from the Management API and validates codes via a callback. This connects your custom backend provider to the backoffice interface.

What is an mfaLoginProvider extension in Umbraco used for?

An mfaLoginProvider extension in Umbraco is used to register a custom two-factor authentication interface within the backoffice. It wires the frontend configuration element to your backend ITwoFactorProvider, enabling users to view QR codes and submit verification tokens.

How do I wire a custom ITwoFactorProvider to the Umbraco Management API for MFA setup?

Wiring a custom ITwoFactorProvider to the Management API involves creating a frontend setup element that fetches QR and secret data from the setup endpoint. The element then validates user-submitted verification codes through a defined callback contract.

Can I use lit web components to build an MFA setup interface in Umbraco?

Yes, you can use lit web components to build an MFA setup interface in Umbraco. The configuration element manages UI states like loading, submit, and success or error, while directly calling the Management API to fetch setup data and validate codes.

Do I need to fetch official Umbraco documentation before creating a two-factor login provider?

Fetching official Umbraco documentation before creating a two-factor login provider is required to avoid integration drift. The skill uses a docs-driven workflow to ensure correct manifest metadata wiring and proper extension configuration patterns.

Why is my custom Umbraco two-factor authentication setup not showing in the backoffice?

If your custom Umbraco two-factor authentication setup is not showing, the manifest likely lacks correct metadata wiring to the forProviderName property. Properly defining the mfaLoginProvider extension and its configuration element ensures the UI registers correctly.