Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Uwaga
Nie jest to najnowsza wersja tego artykułu. Aby zapoznać się z aktualną wersją, zobacz artykuł w wersji .NET 10.
Ostrzeżenie
Ta wersja ASP.NET Core nie jest już obsługiwana. Aby uzyskać więcej informacji, zobacz zasady pomocy technicznej platformy .NET i platformy .NET Core. Aby zapoznać się z aktualną wersją, zobacz artykuł w wersji .NET 10.
Autor: Damien Bowden
Uwierzytelnianie wieloskładnikowe (MFA) to proces, w którym użytkownik jest proszony podczas logowania o dodatkowe formy identyfikacji. Monit może poprosić użytkownika o wprowadzenie kodu z telefonu komórkowego, użycie klucza FIDO2 lub podanie skanowania odciskiem palca. Jeśli potrzebujesz drugiej formy uwierzytelniania, zabezpieczenia są ulepszone. Dodatkowy czynnik nie jest łatwo uzyskiwany ani duplikowany przez cyberatakę.
Ten artykuł zawiera omówienie uwierzytelniania wieloskładnikowego w ASP.NET Core i zalecanych przepływów uwierzytelniania z przykładami pokazującymi, jak:
- Skonfiguruj uwierzytelnianie wieloskładnikowe dla stron administracyjnych przy użyciu ASP.NET Core Identity.
- Wyślij do serwera OpenID Connect wymóg logowania z użyciem MFA.
- Wymuś, aby klient OpenID Connect w ASP.NET Core wymagał uwierzytelniania wieloskładnikowego.
Wyświetl lub pobierz przykładowy kod (jak pobrać).
MFA kontra 2FA
Uwierzytelnianie wieloskładnikowe wymaga co najmniej dwóch typów dowodu tożsamości. Typy dowodowe mogą być czymś, co znasz, czymś, co posiadasz, lub weryfikacją biometryczną, aby użytkownik mógł się uwierzytelnić.
Uwierzytelnianie dwuskładnikowe (2FA) jest jak podzbiór uwierzytelniania wieloskładnikowego. 2FA wymaga dokładnie dwóch typów dowodu, podczas gdy uwierzytelnianie wieloskładnikowe może wymagać co najmniej dwóch czynników w celu potwierdzenia tożsamości.
2FA jest domyślnie obsługiwane w przypadku korzystania z ASP.NET Core Identity. Aby włączyć lub wyłączyć 2FA dla określonego użytkownika, ustaw tę właściwość IdentityUser<TKey>.TwoFactorEnabled. Domyślny interfejs użytkownika platformy ASP.NET Core Identity zawiera strony służące do konfigurowania uwierzytelniania 2FA.
MFA TOTP (algorytm haseł jednorazowych oparty na czasie)
Uwierzytelnianie wieloskładnikowe z użyciem TOTP jest obsługiwane domyślnie podczas korzystania z ASP.NET Core Identity. Takie podejście może być używane razem z dowolną zgodną aplikacją uwierzytelniającą, w tym:
- Microsoft Authenticator
- Narzędzie uwierzytelniające Google
Aby uzyskać szczegółowe informacje o implementacji, zobacz Włączanie generowania kodu QR dla aplikacji uwierzytelniających TOTP na platformie ASP.NET Core.
Aby wyłączyć obsługę protokołu MFA TOTP, skonfiguruj uwierzytelnianie przy użyciu AddIdentity metody zamiast AddDefaultIdentity metody . Metoda AddDefaultIdentity wywołuje metodę AddDefaultTokenProviders wewnętrznie, która rejestruje wielu dostawców tokenów, w tym jednego dla protokołu MFA TOTP. Aby zarejestrować tylko określonych dostawców tokenów, wywołaj metodę AddTokenProvider dla każdego wymaganego dostawcy. Aby uzyskać więcej informacji na temat dostępnych dostawców tokenów, zobacz źródło referencyjne "AddDefaultTokenProviders w repozytorium dotnet/aspnetcore GitHub.
Uwaga
Linki dokumentacji do źródła referencyjnego platformy .NET zwykle ładują domyślną gałąź repozytorium, która reprezentuje bieżący etap rozwoju dla następnego wydania .NET. Aby wybrać tag dla określonej wersji, użyj listy rozwijanej Przełącz gałęzie lub tagi.
Hasła uwierzytelniania wieloskładnikowego/FIDO2 lub bez hasła
Podejście passkeys/FIDO2 jest obecnie następujące:
- Najbezpieczniejszy sposób na wdrożenie uwierzytelniania wieloskładnikowego.
- Uwierzytelnianie wieloskładnikowe chroniące przed atakami phishingowymi (także uwierzytelnianie za pomocą certyfikatów i Windows dla firm).
ASP.NET Core obsługuje klucze dostępu za pomocą ASP.NET Core Identity. W przypadku przepływów MFA lub bez hasła można używać kluczy dostępu/FIDO2. Aby uzyskać więcej informacji, zobacz sekcję Włączanie kluczy dostępu interfejsu API uwierzytelniania sieci Web (WebAuthn).
Microsoft Entra ID zapewnia obsługę kluczy dostępu/FIDO2 oraz metod uwierzytelniania bez hasła. Aby uzyskać więcej informacji, zobacz Metody uwierzytelniania w Microsoft Entra ID — klucze dostępu (FIDO2).
Inne formy uwierzytelniania wieloskładnikowego bez hasła nie są chronione lub mogą nie chronić przed wyłudzaniem informacji.
SMS z uwierzytelnianiem MFA
Uwierzytelnianie wieloskładnikowe za pomocą SMS znacząco zwiększa bezpieczeństwo w porównaniu z uwierzytelnianiem hasłem (pojedynczym czynnikiem). Jednak używanie wiadomości SMS jako drugiego czynnika nie jest już zalecane. Dla tego typu implementacji istnieje zbyt wiele znanych wektorów ataków.
Aby uzyskać więcej informacji, zobacz Wytyczne cyfrowe Identity NIST (specjalna publikacja 800-63B).
Konfigurowanie uwierzytelniania wieloskładnikowego dla stron administracyjnych przy użyciu ASP.NET Core Identity
Możesz wymusić na użytkownikach uwierzytelnianie wieloskładnikowe, aby umożliwić dostęp do poufnych stron w aplikacji ASP.NET Core Identity. Takie podejście może być przydatne w przypadku aplikacji, w których istnieją różne poziomy dostępu dla różnych tożsamości. Na przykład użytkownicy mogą wyświetlać dane profilu przy użyciu procesu logowania przy użyciu hasła, ale administrator musi użyć uwierzytelniania wieloskładnikowego w celu uzyskania dostępu do stron administracyjnych.
Rozszerz proces logowania za pomocą claimu MFA
Przykładowa konfiguracja kodu korzysta z platformy ASP.NET Core z Identity i Razor stronami. Metoda AddIdentity jest używana zamiast AddDefaultIdentity, więc implementacja IUserClaimsPrincipalFactory może służyć do dodawania oświadczeń do tożsamości po pomyślnym zalogowaniu.
Ostrzeżenie
W tym artykule przedstawiono użycie łańcuchów połączenia. Gdy lokalna baza danych jest używana do programowania i testowania, uwierzytelnianie użytkowników bazy danych za pośrednictwem parametry połączenia nie jest wymagane. W środowiskach produkcyjnych parametry połączenia czasami zawierają hasło do uwierzytelniania dostępu do bazy danych lub operacji bazy danych. Poświadczenie hasłem właściciela zasobu (ROPC) w ciągu połączenia stanowi zagrożenie bezpieczeństwa i należy go unikać w aplikacjach produkcyjnych. Aplikacje produkcyjne powinny korzystać z najbezpieczniejszego dostępnego przepływu uwierzytelniania. Aby uzyskać więcej informacji na temat uwierzytelniania aplikacji wdrożonych w środowiskach testowych lub produkcyjnych, zobacz tematy dotyczące zabezpieczeń ASP.NET Core.
builder.Services.AddDbContext<ApplicationDbContext>(options =>
options.UseSqlite(
Configuration.GetConnectionString("DefaultConnection")));
builder.Services.AddIdentity<IdentityUser, IdentityRole>(options =>
options.SignIn.RequireConfirmedAccount = false)
.AddEntityFrameworkStores<ApplicationDbContext>()
.AddDefaultTokenProviders();
builder.Services.AddSingleton<IEmailSender, EmailSender>();
builder.Services.AddScoped<IUserClaimsPrincipalFactory<IdentityUser>,
AdditionalUserClaimsPrincipalFactory>();
builder.Services.AddAuthorization(options =>
options.AddPolicy("TwoFactorEnabled", x => x.RequireClaim("amr", "mfa")));
builder.Services.AddRazorPages();
Klasa AdditionalUserClaimsPrincipalFactory dodaje amr oświadczenie (oświadczenia odwołania metod uwierzytelniania) do oświadczeń użytkownika tylko po pomyślnym zalogowaniu. Wartość oświadczenia jest odczytywana z bazy danych. Oświadczenie jest dodawane tutaj, ponieważ użytkownik powinien uzyskać dostęp tylko do wyższego widoku chronionego, jeśli tożsamość jest zalogowana przy użyciu uwierzytelniania wieloskładnikowego. Jeśli widok bazy danych jest odczytywany bezpośrednio z bazy danych zamiast korzystać z oświadczenia, można uzyskać dostęp do widoku bez uwierzytelniania wieloskładnikowego bezpośrednio po aktywowaniu uwierzytelniania wieloskładnikowego.
using Microsoft.AspNetCore.Identity;
using Microsoft.Extensions.Options;
using System.Collections.Generic;
using System.Security.Claims;
using System.Threading.Tasks;
namespace IdentityStandaloneMfa
{
public class AdditionalUserClaimsPrincipalFactory :
UserClaimsPrincipalFactory<IdentityUser, IdentityRole>
{
public AdditionalUserClaimsPrincipalFactory(
UserManager<IdentityUser> userManager,
RoleManager<IdentityRole> roleManager,
IOptions<IdentityOptions> optionsAccessor)
: base(userManager, roleManager, optionsAccessor)
{
}
public async override Task<ClaimsPrincipal> CreateAsync(IdentityUser user)
{
var principal = await base.CreateAsync(user);
var identity = (ClaimsIdentity)principal.Identity;
var claims = new List<Claim>();
if (user.TwoFactorEnabled)
{
claims.Add(new Claim("amr", "mfa"));
}
else
{
claims.Add(new Claim("amr", "pwd"));
}
identity.AddClaims(claims);
return principal;
}
}
}
Identity Ponieważ konfiguracja usługi zmieniła się w Startup klasie, układy Identity muszą zostać zaktualizowane:
Utwórz szkielet Identity stron w aplikacji.
Zdefiniuj układ w pliku /Account/Manage/_Layout.cshtml.Identity
@{ Layout = "/Pages/Shared/_Layout.cshtml"; }Przypisz też układ wszystkim stronom zarządzania ze stron Identity:
@{ Layout = "_Layout.cshtml"; }
Zweryfikuj wymaganie uwierzytelniania wieloskładnikowego na stronie administracyjnej
Strona administracyjna Razor sprawdza, czy użytkownik jest zalogowany za pośrednictwem uwierzytelniania wieloskładnikowego. W metodzie OnGet tożsamość jest używana do uzyskiwania dostępu do oświadczeń użytkownika. Oświadczenie amr jest sprawdzane pod kątem wartości mfa. Jeśli tożsamość nie ma tego oświadczenia lub ma wartość false, strona przekierowuje do strony Włączanie uwierzytelniania wieloskładnikowego. Ta akcja jest możliwa, ponieważ użytkownik jest już zalogowany, ale bez uwierzytelniania wieloskładnikowego.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
namespace IdentityStandaloneMfa
{
public class AdminModel : PageModel
{
public IActionResult OnGet()
{
var claimTwoFactorEnabled =
User.Claims.FirstOrDefault(t => t.Type == "amr");
if (claimTwoFactorEnabled != null &&
"mfa".Equals(claimTwoFactorEnabled.Value))
{
// You logged in with MFA, do the administrative stuff
}
else
{
return Redirect(
"/Identity/Account/Manage/TwoFactorAuthentication");
}
return Page();
}
}
}
Logika interfejsu użytkownika w celu przełączania informacji o logowaniu użytkownika
Zasady autoryzacji zostały dodane podczas uruchamiania. Ta zasada wymaga oświadczenia amr o wartości mfa:
services.AddAuthorization(options =>
options.AddPolicy("TwoFactorEnabled",
x => x.RequireClaim("amr", "mfa")));
Te zasady można następnie użyć w _Layout widoku, aby wyświetlić lub ukryć menu Administratora z ostrzeżeniem:
@using Microsoft.AspNetCore.Authorization
@using Microsoft.AspNetCore.Identity
@inject SignInManager<IdentityUser> SignInManager
@inject UserManager<IdentityUser> UserManager
@inject IAuthorizationService AuthorizationService
Jeśli użytkownik jest zalogowany przy użyciu MFA, menu Admin jest wyświetlane bez ostrzeżenia w podpowiedzi.
Gdy użytkownik jest zalogowany bez uwierzytelniania wieloskładnikowego, wyświetlane jest menu Admin (nie włączono) wraz z podpowiedzią informującą użytkownika i wyjaśniającą ostrzeżenie.
@if (SignInManager.IsSignedIn(User))
{
@if ((AuthorizationService.AuthorizeAsync(User, "TwoFactorEnabled")).Result.Succeeded)
{
<li class="nav-item">
<a class="nav-link text-dark" asp-area="" asp-page="/Admin">Admin</a>
</li>
}
else
{
<li class="nav-item">
<a class="nav-link text-dark" asp-area="" asp-page="/Admin"
id="tooltip-demo"
data-toggle="tooltip"
data-placement="bottom"
title="MFA is NOT enabled. This is required for the Admin Page. If you have activated MFA, then logout, login again.">
Admin (Not Enabled)
</a>
</li>
}
}
Jeśli użytkownik zaloguje się bez uwierzytelniania wieloskładnikowego, opcja Administrator wyświetli ostrzeżenie (Nie włączono):
Gdy użytkownik wybierze opcję Administrator , zostanie przekierowany do widoku, w którym można włączyć uwierzytelnianie wieloskładnikowe:
Wysłanie wymogu logowania wieloskładnikowego do serwera OpenID Connect
Parametr acr_values może służyć do przekazywania wymaganej mfa wartości z klienta do serwera w żądaniu uwierzytelniania.
Uwaga
Aby acr_values to podejście działało, należy obsłużyć parametr na serwerze OpenID Connect.
Klient OpenID Connect ASP.NET Core
Aplikacja kliencka ASP.NET Core Razor Pages OpenID Connect używa metody AddOpenIdConnect do logowania się na serwerze OpenID Connect. Parametr acr_values jest ustawiany z wartością mfa i wysyłany z żądaniem uwierzytelniania. Element OpenIdConnectEvents służy do dodania tej wartości.
Zalecane wartości parametru acr_values podano w specyfikacji Referencyjne wartości metod uwierzytelniania IETF.
build.Services.AddAuthentication(options =>
{
options.DefaultScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.DefaultChallengeScheme =
OpenIdConnectDefaults.AuthenticationScheme;
})
.AddCookie()
.AddOpenIdConnect(options =>
{
options.SignInScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.Authority = "<OpenID Connect server URL>";
options.RequireHttpsMetadata = true;
options.ClientId = "<OpenID Connect client ID>";
options.ClientSecret = "<>";
options.ResponseType = "code";
options.UsePkce = true;
options.Scope.Add("profile");
options.Scope.Add("offline_access");
options.SaveTokens = true;
options.AdditionalAuthorizationParameters.Add("acr_values", "mfa");
});
Przykład: serwer Duende IdentityServer OpenID Connect
W poniższym przykładzie pokazano serwer OpenID Connect Duende IdentityServer z ASP.NET Core Identity. Na serwerze OpenID Connect, który jest implementowany przy użyciu ASP.NET Core Identity z Razor Pages, zostanie utworzona nowa strona o nazwie ErrorEnable2FA.cshtml.
Widok strony:
- Pojawia się, jeśli Identity pochodzi z aplikacji wymagającej MFA, ale użytkownik nie aktywował MFA w Identity.
- Informuje użytkownika i dodaje link, aby to aktywować.
@{
ViewData["Title"] = "ErrorEnable2FA";
}
<h1>The client application requires you to have MFA enabled. Enable this, try login again.</h1>
<br />
You can enable MFA to login here:
<br />
<a href="~/Identity/Account/Manage/TwoFactorAuthentication">Enable MFA</a>
W metodzie Login implementacja interfejsu IIdentityServerInteractionService_interaction służy do uzyskiwania dostępu do parametrów żądania OpenID Connect. Dostęp do parametru acr_values można uzyskać za pomocą właściwości AcrValues. Ponieważ klient wysłał to z ustawionym parametrem mfa, można to następnie sprawdzić.
Jeśli uwierzytelnianie wieloskładnikowe jest wymagane, a użytkownik w ASP.NET Core Identity jest włączony za pomocą uwierzytelniania wieloskładnikowego, proces logowania będzie kontynuowany. Gdy użytkownik nie ma włączonego uwierzytelniania wieloskładnikowego, jest przekierowywany do niestandardowego widoku ErrorEnable2FA.cshtml. Następnie ASP.NET Core Identity loguje użytkownika.
Fido2Store służy do sprawdzania, czy użytkownik aktywował MFA za pomocą niestandardowego dostawcy tokenów FIDO2.
public async Task<IActionResult> OnPost()
{
// check if we are in the context of an authorization request
var context = await _interaction.GetAuthorizationContextAsync(Input.ReturnUrl);
var requires2Fa = context?.AcrValues.Count(t => t.Contains("mfa")) >= 1;
var user = await _userManager.FindByNameAsync(Input.Username);
if (user != null && !user.TwoFactorEnabled && requires2Fa)
{
return RedirectToPage("/Home/ErrorEnable2FA/Index");
}
// code omitted for brevity
if (ModelState.IsValid)
{
var result = await _signInManager.PasswordSignInAsync(Input.Username, Input.Password, Input.RememberLogin, lockoutOnFailure: true);
if (result.Succeeded)
{
// code omitted for brevity
}
if (result.RequiresTwoFactor)
{
var fido2ItemExistsForUser = await _fido2Store.GetCredentialsByUserNameAsync(user.UserName);
if (fido2ItemExistsForUser.Count > 0)
{
return RedirectToPage("/Account/LoginFido2Mfa", new { area = "Identity", Input.ReturnUrl, Input.RememberLogin });
}
return RedirectToPage("/Account/LoginWith2fa", new { area = "Identity", Input.ReturnUrl, RememberMe = Input.RememberLogin });
}
await _events.RaiseAsync(new UserLoginFailureEvent(Input.Username, "invalid credentials", clientId: context?.Client.ClientId));
ModelState.AddModelError(string.Empty, LoginOptions.InvalidCredentialsErrorMessage);
}
// something went wrong, show form with error
await BuildModelAsync(Input.ReturnUrl);
return Page();
}
Jeśli użytkownik jest już zalogowany, aplikacja kliencka:
Nadal sprawdza poprawność
amroświadczenia.Można skonfigurować uwierzytelnianie wieloskładnikowe za pomocą linku do widoku ASP.NET Core Identity, takiego jak Enable MFA:
Wymuszanie, aby klient ASP.NET Core OpenID Connect wymagał uwierzytelniania wieloskładnikowego.
W tym przykładzie pokazano, jak aplikacja ASP.NET Core Razor Page, która używa funkcji OpenID Connect do logowania, może wymagać uwierzytelnienia użytkowników przy użyciu uwierzytelniania wieloskładnikowego.
Aby zweryfikować wymaganie MFA, zostanie utworzone wymaganie IAuthorizationRequirement. To wymaganie jest dodawane na stronach za pomocą zasad wymagających uwierzytelniania wieloskładnikowego.
using Microsoft.AspNetCore.Authorization;
namespace AspNetCoreRequireMfaOidc;
public class RequireMfa : IAuthorizationRequirement{}
Element AuthorizationHandler jest implementowany w celu używania amr oświadczenia i sprawdzania wartości mfa. Element amr jest zwracany w elemencie id_token po pomyślnym uwierzytelnieniu i może mieć wiele różnych wartości zgodnie ze specyfikacją Referencyjne wartości metod uwierzytelniania IETF.
Zwrócona wartość zależy od sposobu uwierzytelniania tożsamości i implementacji serwera OpenID Connect.
AuthorizationHandler wykorzystuje RequireMfa wymaganie i weryfikuje amr oświadczenie. Serwer OpenID Connect można zaimplementować przy użyciu serwera Duende Identity Server z ASP.NET Core Identity. Gdy użytkownik uwierzytelnia się za pomocą TOTP, zwracany jest claim amr o wartości MFA. Jeśli używasz innej implementacji serwera OpenID Connect lub innego typu uwierzytelniania wieloskładnikowego, element claim amr może mieć inną wartość. Kod musi zostać rozszerzony, aby zaakceptować inne możliwe wartości.
public class RequireMfaHandler : AuthorizationHandler<RequireMfa>
{
protected override Task HandleRequirementAsync(
AuthorizationHandlerContext context,
RequireMfa requirement)
{
if (context == null)
throw new ArgumentNullException(nameof(context));
if (requirement == null)
throw new ArgumentNullException(nameof(requirement));
var amrClaim =
context.User.Claims.FirstOrDefault(t => t.Type == "amr");
if (amrClaim != null && amrClaim.Value == Amr.Mfa)
{
context.Succeed(requirement);
}
return Task.CompletedTask;
}
}
W pliku AddOpenIdConnect programu metoda jest używana jako domyślny schemat wyzwania. Procedura obsługi autoryzacji używana do sprawdzania amr oświadczenia jest dodawana do kontenera Inversion of Control. Następnie zostanie utworzona zasada, która dodaje wymaganie RequireMfa.
builder.Services.ConfigureApplicationCookie(options =>
options.Cookie.SecurePolicy =
CookieSecurePolicy.Always);
builder.Services.AddSingleton<IAuthorizationHandler, RequireMfaHandler>();
builder.Services.AddAuthentication(options =>
{
options.DefaultScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.DefaultChallengeScheme =
OpenIdConnectDefaults.AuthenticationScheme;
})
.AddCookie()
.AddOpenIdConnect(options =>
{
options.SignInScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.Authority = "https://localhost:44352";
options.RequireHttpsMetadata = true;
options.ClientId = "AspNetCoreRequireMfaOidc";
options.ClientSecret = "AspNetCoreRequireMfaOidcSecret";
options.ResponseType = "code";
options.UsePkce = true;
options.Scope.Add("profile");
options.Scope.Add("offline_access");
options.SaveTokens = true;
});
builder.Services.AddAuthorization(options =>
{
options.AddPolicy("RequireMfa", policyIsAdminRequirement =>
{
policyIsAdminRequirement.Requirements.Add(new RequireMfa());
});
});
builder.Services.AddRazorPages();
Polityka jest następnie używana na stronie Razor, zgodnie z wymaganiami. Zasady można również dodać globalnie dla całej aplikacji.
[Authorize(Policy= "RequireMfa")]
public class IndexModel : PageModel
{
public void OnGet()
{
}
}
Jeśli użytkownik uwierzytelnia się bez MFA, claim amr prawdopodobnie ma wartość pwd (hasło). W związku z tym żądanie nie jest upoważnione do uzyskania dostępu do strony. Przy użyciu wartości domyślnych użytkownik jest przekierowywany do stronyDostęp do kontaDenied>. To zachowanie można zmienić lub zaimplementować własną logikę niestandardową. W tym przykładzie zostanie dodany link, aby prawidłowy użytkownik mógł skonfigurować uwierzytelnianie wieloskładnikowe dla swojego konta.
@page
@model AspNetCoreRequireMfaOidc.AccessDeniedModel
@{
ViewData["Title"] = "AccessDenied";
Layout = "~/Pages/Shared/_Layout.cshtml";
}
<h1>AccessDenied</h1>
You require MFA to login here
<a href="https://localhost:44352/Manage/TwoFactorAuthentication">Enable MFA</a>
Po tej zmianie tylko użytkownicy uwierzytelnieni za pomocą usługi MFA mogą uzyskiwać dostęp do strony lub witryny internetowej. Jeśli są używane różne typy uwierzytelniania wieloskładnikowego lub jeśli uwierzytelnianie 2FA jest dozwolone, amr oświadczenie ma różne wartości i musi być przetwarzane poprawnie. Różne serwery OpenID Connect zwracają również różne wartości dla tego oświadczenia. Te wartości mogą nie być zgodne ze specyfikacją referencyjnych wartości metod uwierzytelniania IETF.
Gdy użytkownik zaloguje się bez uwierzytelniania wieloskładnikowego (na przykład przy użyciu tylko hasła):
Oświadczenie
amrma wartość hasłapwd:
Odmowa dostępu:
Alternatywnie, gdy użytkownik loguje się za pomocą OTP przy użyciu Identity, oświadczenie amr ma wartość mfa:
Dostosowywanie parametrów OIDC i OAuth
Opcja AdditionalAuthorizationParameters modułów obsługi uwierzytelniania OAuth i OIDC umożliwia dostosowanie parametrów wiadomości autoryzacyjnych, które są często dołączane w ciągu zapytania przekierowania:
builder.Services.AddAuthentication().AddOpenIdConnect(options =>
{
options.AdditionalAuthorizationParameters.Add("prompt", "login");
options.AdditionalAuthorizationParameters.Add("audience", "https://api.example.com");
});
Treści powiązane
Autor: Damien Bowden
Uwierzytelnianie wieloskładnikowe (MFA) to proces, w którym użytkownik jest proszony podczas zdarzenia logowania o dodatkowe formy identyfikacji. Wskazówka może polegać na wprowadzeniu kodu z telefonu komórkowego, użyciu klucza FIDO2 lub zeskanowaniu odcisku palca. Jeśli potrzebujesz drugiej formy uwierzytelniania, zabezpieczenia są ulepszone. Dodatkowy czynnik nie jest łatwo uzyskiwany ani duplikowany przez cyberatakę.
W tym artykule opisano następujące obszary:
- Co to jest uwierzytelnianie wieloskładnikowe i jakie przepływy uwierzytelniania wieloskładnikowego są zalecane
- Konfigurowanie uwierzytelniania wieloskładnikowego dla stron administracyjnych przy użyciu platformy ASP.NET Core Identity
- Wysłanie wymogu logowania wieloskładnikowego do serwera OpenID Connect
- Wymuszanie, aby klient ASP.NET Core OpenID Connect wymagał uwierzytelniania wieloskładnikowego.
Uwierzytelnianie wieloskładnikowe, 2FA
Uwierzytelnianie wieloskładnikowe wymaga co najmniej dwóch lub więcej rodzajów dowodów potwierdzających tożsamość, takich jak coś, co wiesz, coś, co posiadasz, lub weryfikacja biometryczna, aby użytkownik mógł się uwierzytelnić.
Uwierzytelnianie dwuskładnikowe (2FA) przypomina podzbiór uwierzytelniania wieloskładnikowego, ale różnica polega na tym, że uwierzytelnianie wieloskładnikowe może wymagać co najmniej dwóch czynników w celu potwierdzenia tożsamości.
2FA jest domyślnie obsługiwane w przypadku korzystania z ASP.NET Core Identity. Aby włączyć lub wyłączyć 2FA dla określonego użytkownika, ustaw tę właściwość IdentityUser<TKey>.TwoFactorEnabled. Domyślny interfejs użytkownika platformy ASP.NET Core Identity zawiera strony służące do konfigurowania uwierzytelniania 2FA.
MFA TOTP (algorytm haseł jednorazowych oparty na czasie)
Uwierzytelnianie wieloskładnikowe przy użyciu protokołu TOTP jest domyślnie obsługiwane w przypadku korzystania z usługi ASP.NET Core Identity. Takie podejście może być używane razem z dowolną zgodną aplikacją uwierzytelniającą, w tym:
- Microsoft Authenticator
- Narzędzie uwierzytelniające Google
Aby uzyskać szczegółowe informacje o implementacji, zobacz Włączanie generowania kodu QR dla aplikacji uwierzytelniających TOTP na platformie ASP.NET Core.
Aby wyłączyć obsługę protokołu MFA TOTP, skonfiguruj uwierzytelnianie przy użyciu AddIdentity zamiast AddDefaultIdentity.
AddDefaultIdentity wywołuje AddDefaultTokenProviders wewnętrznie, co rejestruje wielu dostawców tokenów, w tym jednego dla uwierzytelniania wieloskładnikowego TOTP. Aby zarejestrować tylko określonych dostawców tokenów, wywołaj AddTokenProvider dla każdego wymaganego dostawcy. Aby uzyskać więcej informacji na temat dostępnych dostawców tokenów, zobacz metody rozszerzeń pod adresem IdentityBuilderExtensions.
Hasła uwierzytelniania wieloskładnikowego/FIDO2 lub bez hasła
Klucz dostępu/FIDO2 jest obecnie:
- Najbezpieczniejszy sposób osiągnięcia uwierzytelniania wieloskładnikowego.
- Uwierzytelnianie wieloskładnikowe chroniące przed atakami phishingowymi. (Oprócz uwierzytelniania certyfikatów i systemu Windows dla firm)
Obecnie ASP.NET Core nie obsługuje bezpośrednio kluczy dostępu/FIDO2. W przypadku przepływów MFA lub bez hasła można używać kluczy dostępu/FIDO2.
Microsoft Entra ID zapewnia obsługę kluczy dostępu/FIDO2 oraz metod uwierzytelniania bez hasła. Aby uzyskać więcej informacji, zobacz Opcje uwierzytelniania bez hasła.
Inne formy uwierzytelniania wieloskładnikowego bez hasła mogą nie chronić przed wyłudzaniem informacji.
SMS z uwierzytelnianiem MFA
Uwierzytelnianie wieloskładnikowe za pomocą SMS znacząco zwiększa bezpieczeństwo w porównaniu z uwierzytelnianiem hasłem (pojedynczym czynnikiem). Jednak używanie wiadomości SMS jako drugiego czynnika nie jest już zalecane. Dla tego typu implementacji istnieje zbyt wiele znanych wektorów ataków.
Konfigurowanie uwierzytelniania wieloskładnikowego dla stron administracyjnych przy użyciu platformy ASP.NET Core Identity
Można wymusić uwierzytelnianie wieloskładnikowe na użytkownikach, aby uzyskać dostęp do poufnych stron w aplikacji ASP.NET Core Identity. Może to być przydatne w przypadku aplikacji, w których istnieją różne poziomy dostępu dla różnych tożsamości. Na przykład użytkownicy mogą wyświetlać dane profilu przy użyciu logowania przy użyciu hasła, ale administrator musi użyć uwierzytelniania wieloskładnikowego w celu uzyskania dostępu do stron administracyjnych.
Rozszerzenie logowania za pomocą żądania MFA
Kod demonstracyjny jest konfigurowany przy użyciu platformy ASP.NET Core z usługami Identity i Razor Pages. Metoda AddIdentity jest używana zamiast AddDefaultIdentity, więc implementacja IUserClaimsPrincipalFactory może służyć do dodawania oświadczeń do tożsamości po pomyślnym zalogowaniu.
Ostrzeżenie
W tym artykule przedstawiono użycie łańcuchów połączenia. Gdy lokalna baza danych jest używana do programowania i testowania, uwierzytelnianie użytkowników bazy danych za pośrednictwem parametry połączenia nie jest wymagane. W środowiskach produkcyjnych parametry połączenia czasami zawierają hasło do uwierzytelniania dostępu do bazy danych lub operacji bazy danych. Poświadczenie hasłem właściciela zasobu (ROPC) w ciągu połączenia stanowi zagrożenie bezpieczeństwa i należy go unikać w aplikacjach produkcyjnych. Aplikacje produkcyjne powinny korzystać z najbezpieczniejszego dostępnego przepływu uwierzytelniania. Aby uzyskać więcej informacji na temat uwierzytelniania aplikacji wdrożonych w środowiskach testowych lub produkcyjnych, zobacz tematy dotyczące zabezpieczeń ASP.NET Core.
builder.Services.AddDbContext<ApplicationDbContext>(options =>
options.UseSqlite(
Configuration.GetConnectionString("DefaultConnection")));
builder.Services.AddIdentity<IdentityUser, IdentityRole>(options =>
options.SignIn.RequireConfirmedAccount = false)
.AddEntityFrameworkStores<ApplicationDbContext>()
.AddDefaultTokenProviders();
builder.Services.AddSingleton<IEmailSender, EmailSender>();
builder.Services.AddScoped<IUserClaimsPrincipalFactory<IdentityUser>,
AdditionalUserClaimsPrincipalFactory>();
builder.Services.AddAuthorization(options =>
options.AddPolicy("TwoFactorEnabled", x => x.RequireClaim("amr", "mfa")));
builder.Services.AddRazorPages();
Klasa AdditionalUserClaimsPrincipalFactory dodaje amr roszczenie do roszczeń użytkownika tylko po pomyślnym logowaniu. Wartość oświadczenia jest odczytywana z bazy danych. Oświadczenie jest dodawane tutaj, ponieważ użytkownik powinien uzyskać dostęp tylko do bardziej chronionego widoku, jeśli tożsamość została uwierzytelniona przy użyciu uwierzytelniania wieloskładnikowego. Jeśli widok bazy danych jest odczytywany bezpośrednio z bazy danych zamiast korzystać z oświadczenia, można uzyskać dostęp do widoku bez uwierzytelniania wieloskładnikowego bezpośrednio po aktywowaniu uwierzytelniania wieloskładnikowego.
using Microsoft.AspNetCore.Identity;
using Microsoft.Extensions.Options;
using System.Collections.Generic;
using System.Security.Claims;
using System.Threading.Tasks;
namespace IdentityStandaloneMfa
{
public class AdditionalUserClaimsPrincipalFactory :
UserClaimsPrincipalFactory<IdentityUser, IdentityRole>
{
public AdditionalUserClaimsPrincipalFactory(
UserManager<IdentityUser> userManager,
RoleManager<IdentityRole> roleManager,
IOptions<IdentityOptions> optionsAccessor)
: base(userManager, roleManager, optionsAccessor)
{
}
public async override Task<ClaimsPrincipal> CreateAsync(IdentityUser user)
{
var principal = await base.CreateAsync(user);
var identity = (ClaimsIdentity)principal.Identity;
var claims = new List<Claim>();
if (user.TwoFactorEnabled)
{
claims.Add(new Claim("amr", "mfa"));
}
else
{
claims.Add(new Claim("amr", "pwd"));
}
identity.AddClaims(claims);
return principal;
}
}
}
Identity Ponieważ konfiguracja usługi zmieniła się w Startup klasie, układy Identity muszą zostać zaktualizowane. Utwórz szkielet Identity stron w aplikacji. Zdefiniuj układ w pliku Identity/Account/Manage/_Layout.cshtml.
@{
Layout = "/Pages/Shared/_Layout.cshtml";
}
Przypisz również układ dla wszystkich stron zarządzania na Identity stronach:
@{
Layout = "_Layout.cshtml";
}
Zweryfikuj wymaganie uwierzytelniania wieloskładnikowego na stronie administracyjnej
Strona administracyjna Razor sprawdza, czy użytkownik zalogował się przy użyciu uwierzytelniania wieloskładnikowego. W metodzie OnGet tożsamość jest używana do uzyskiwania dostępu do oświadczeń użytkownika. Oświadczenie amr jest sprawdzane pod kątem wartości mfa. Jeśli tożsamość nie ma tego oświadczenia lub ma wartość false, strona przekierowuje do strony Włączanie uwierzytelniania wieloskładnikowego. Jest to możliwe, ponieważ użytkownik zalogował się już, ale bez uwierzytelniania wieloskładnikowego.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
namespace IdentityStandaloneMfa
{
public class AdminModel : PageModel
{
public IActionResult OnGet()
{
var claimTwoFactorEnabled =
User.Claims.FirstOrDefault(t => t.Type == "amr");
if (claimTwoFactorEnabled != null &&
"mfa".Equals(claimTwoFactorEnabled.Value))
{
// You logged in with MFA, do the administrative stuff
}
else
{
return Redirect(
"/Identity/Account/Manage/TwoFactorAuthentication");
}
return Page();
}
}
}
Logika interfejsu użytkownika do przełączania danych logowania użytkownika
Zasady autoryzacji zostały dodane podczas uruchamiania. Ta polityka wymaga amr oświadczenia o wartości mfa.
services.AddAuthorization(options =>
options.AddPolicy("TwoFactorEnabled",
x => x.RequireClaim("amr", "mfa")));
Te zasady można następnie użyć w _Layout widoku, aby wyświetlić lub ukryć menu Administratora z ostrzeżeniem:
@using Microsoft.AspNetCore.Authorization
@using Microsoft.AspNetCore.Identity
@inject SignInManager<IdentityUser> SignInManager
@inject UserManager<IdentityUser> UserManager
@inject IAuthorizationService AuthorizationService
Jeśli tożsamość zalogowała się przy użyciu uwierzytelniania wieloskładnikowego, menu Admin jest wyświetlane bez ostrzeżenia o podpowiedzi. Gdy użytkownik zalogował się bez uwierzytelniania wieloskładnikowego, zostanie wyświetlone menu Administrator (nie włączono) wraz z etykietkę narzędzia informującą użytkownika (wyjaśnienie ostrzeżenia).
@if (SignInManager.IsSignedIn(User))
{
@if ((AuthorizationService.AuthorizeAsync(User, "TwoFactorEnabled")).Result.Succeeded)
{
<li class="nav-item">
<a class="nav-link text-dark" asp-area="" asp-page="/Admin">Admin</a>
</li>
}
else
{
<li class="nav-item">
<a class="nav-link text-dark" asp-area="" asp-page="/Admin"
id="tooltip-demo"
data-toggle="tooltip"
data-placement="bottom"
title="MFA is NOT enabled. This is required for the Admin Page. If you have activated MFA, then logout, login again.">
Admin (Not Enabled)
</a>
</li>
}
}
Jeśli użytkownik zaloguje się bez uwierzytelniania wieloskładnikowego, zostanie wyświetlone ostrzeżenie:
Użytkownik jest przekierowywany do widoku włączania uwierzytelniania wieloskładnikowego po kliknięciu linku Administratora :
Wysłanie wymogu logowania wieloskładnikowego do serwera OpenID Connect
Parametr acr_values może służyć do przekazywania wymaganej mfa wartości z klienta do serwera w żądaniu uwierzytelniania.
Uwaga
Aby acr_values parametr zadziałał, należy go obsłużyć na serwerze OpenID Connect.
Klient OpenID Connect ASP.NET Core
Aplikacja kliencka OpenID Connect ASP.NET Core Razor Pages używa AddOpenIdConnect metody logowania do serwera OpenID Connect. Parametr acr_values jest ustawiany z wartością mfa i wysyłany z żądaniem uwierzytelniania. Element OpenIdConnectEvents jest używany do dodawania tego.
Aby uzyskać zalecane acr_values wartości parametrów, zobacz Wartości referencyjne metody uwierzytelniania.
build.Services.AddAuthentication(options =>
{
options.DefaultScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.DefaultChallengeScheme =
OpenIdConnectDefaults.AuthenticationScheme;
})
.AddCookie()
.AddOpenIdConnect(options =>
{
options.SignInScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.Authority = "<OpenID Connect server URL>";
options.RequireHttpsMetadata = true;
options.ClientId = "<OpenID Connect client ID>";
options.ClientSecret = "<>";
options.ResponseType = "code";
options.UsePkce = true;
options.Scope.Add("profile");
options.Scope.Add("offline_access");
options.SaveTokens = true;
options.Events = new OpenIdConnectEvents
{
OnRedirectToIdentityProvider = context =>
{
context.ProtocolMessage.SetParameter("acr_values", "mfa");
return Task.FromResult(0);
}
};
});
Przykładowy serwer OpenID Connect Duende IdentityServer z ASP.NET Core Identity
Na serwerze OpenID Connect, który jest implementowany przy użyciu ASP.NET Core Identity ze stronami Razor , zostanie utworzona nowa strona o nazwie ErrorEnable2FA.cshtml . Widok:
- Wyświetla, czy Identity pochodzi z aplikacji wymagającej uwierzytelniania wieloskładnikowego, ale użytkownik nie aktywował tego w Identity.
- Informuje użytkownika i dodaje link, aby to aktywować.
@{
ViewData["Title"] = "ErrorEnable2FA";
}
<h1>The client application requires you to have MFA enabled. Enable this, try login again.</h1>
<br />
You can enable MFA to login here:
<br />
<a href="~/Identity/Account/Manage/TwoFactorAuthentication">Enable MFA</a>
W metodzie Login implementacja interfejsu IIdentityServerInteractionService_interaction służy do uzyskiwania dostępu do parametrów żądania OpenID Connect. Parametr acr_values jest uzyskiwany poprzez dostęp do właściwości AcrValues. Po tym, jak klient wysłał to z ustawieniem mfa, można to sprawdzić.
Jeśli uwierzytelnianie wieloskładnikowe jest wymagane, a użytkownik w aplikacji ASP.NET Core Identity ma włączoną uwierzytelnianie wieloskładnikowe, logowanie będzie kontynuowane. Gdy użytkownik nie ma włączonego uwierzytelniania wieloskładnikowego, jest przekierowywany do niestandardowego widoku ErrorEnable2FA.cshtml. Następnie ASP.NET Core Identity loguje użytkownika.
Magazyn Fido2Store służy do sprawdzania, czy użytkownik aktywował uwierzytelnianie wieloskładnikowe przy użyciu niestandardowego dostawcy tokenów FIDO2.
public async Task<IActionResult> OnPost()
{
// check if we are in the context of an authorization request
var context = await _interaction.GetAuthorizationContextAsync(Input.ReturnUrl);
var requires2Fa = context?.AcrValues.Count(t => t.Contains("mfa")) >= 1;
var user = await _userManager.FindByNameAsync(Input.Username);
if (user != null && !user.TwoFactorEnabled && requires2Fa)
{
return RedirectToPage("/Home/ErrorEnable2FA/Index");
}
// code omitted for brevity
if (ModelState.IsValid)
{
var result = await _signInManager.PasswordSignInAsync(Input.Username, Input.Password, Input.RememberLogin, lockoutOnFailure: true);
if (result.Succeeded)
{
// code omitted for brevity
}
if (result.RequiresTwoFactor)
{
var fido2ItemExistsForUser = await _fido2Store.GetCredentialsByUserNameAsync(user.UserName);
if (fido2ItemExistsForUser.Count > 0)
{
return RedirectToPage("/Account/LoginFido2Mfa", new { area = "Identity", Input.ReturnUrl, Input.RememberLogin });
}
return RedirectToPage("/Account/LoginWith2fa", new { area = "Identity", Input.ReturnUrl, RememberMe = Input.RememberLogin });
}
await _events.RaiseAsync(new UserLoginFailureEvent(Input.Username, "invalid credentials", clientId: context?.Client.ClientId));
ModelState.AddModelError(string.Empty, LoginOptions.InvalidCredentialsErrorMessage);
}
// something went wrong, show form with error
await BuildModelAsync(Input.ReturnUrl);
return Page();
}
Jeśli użytkownik jest już zalogowany, aplikacja kliencka:
- Nadal sprawdza poprawność
amroświadczenia. - Można skonfigurować uwierzytelnianie wieloskładnikowe za pomocą linku do widoku ASP.NET Core Identity .
Wymuszanie, aby klient ASP.NET Core OpenID Connect wymagał uwierzytelniania wieloskładnikowego.
W tym przykładzie pokazano, jak aplikacja ASP.NET Core Razor Page, która używa interfejsu OpenID Connect do logowania, może wymagać uwierzytelnienia użytkowników przy użyciu uwierzytelniania wieloskładnikowego.
Aby zweryfikować wymaganie MFA, zostanie utworzone wymaganie IAuthorizationRequirement. Zostanie to dodane do stron przy użyciu zasad wymagających uwierzytelniania wieloskładnikowego.
using Microsoft.AspNetCore.Authorization;
namespace AspNetCoreRequireMfaOidc;
public class RequireMfa : IAuthorizationRequirement{}
Zaimplementowano AuthorizationHandler element, który będzie korzystał z amr roszczenia i sprawdzał wartość mfa. Element amr jest zwracany w wyniku id_token pomyślnego uwierzytelnienia i może mieć wiele różnych wartości zdefiniowanych w specyfikacji Wartości referencyjne metod uwierzytelniania.
Zwrócona wartość zależy od sposobu uwierzytelniania tożsamości i implementacji serwera OpenID Connect.
AuthorizationHandler wykorzystuje RequireMfa wymaganie i weryfikuje amr oświadczenie. Serwer OpenID Connect można zaimplementować przy użyciu serwera Duende Identity z programem ASP.NET Core Identity. Gdy użytkownik loguje się przy użyciu TOTP, klauzula amr jest zwracana z wartością MFA. Jeśli korzystasz z innej implementacji serwera OpenID Connect lub innego typu uwierzytelniania wieloskładnikowego, wartość amr oświadczenia może być inna. Aby można było również zaakceptować ten kod, należy go rozszerzyć.
public class RequireMfaHandler : AuthorizationHandler<RequireMfa>
{
protected override Task HandleRequirementAsync(
AuthorizationHandlerContext context,
RequireMfa requirement)
{
if (context == null)
throw new ArgumentNullException(nameof(context));
if (requirement == null)
throw new ArgumentNullException(nameof(requirement));
var amrClaim =
context.User.Claims.FirstOrDefault(t => t.Type == "amr");
if (amrClaim != null && amrClaim.Value == Amr.Mfa)
{
context.Succeed(requirement);
}
return Task.CompletedTask;
}
}
W pliku AddOpenIdConnect programu metoda jest używana jako domyślny schemat wyzwania. Procedura obsługi autoryzacji używana do sprawdzania amr oświadczenia jest dodawana do kontenera Inversion of Control. Następnie zostanie utworzona zasada, która dodaje wymaganie RequireMfa.
builder.Services.ConfigureApplicationCookie(options =>
options.Cookie.SecurePolicy =
CookieSecurePolicy.Always);
builder.Services.AddSingleton<IAuthorizationHandler, RequireMfaHandler>();
builder.Services.AddAuthentication(options =>
{
options.DefaultScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.DefaultChallengeScheme =
OpenIdConnectDefaults.AuthenticationScheme;
})
.AddCookie()
.AddOpenIdConnect(options =>
{
options.SignInScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.Authority = "https://localhost:44352";
options.RequireHttpsMetadata = true;
options.ClientId = "AspNetCoreRequireMfaOidc";
options.ClientSecret = "AspNetCoreRequireMfaOidcSecret";
options.ResponseType = "code";
options.UsePkce = true;
options.Scope.Add("profile");
options.Scope.Add("offline_access");
options.SaveTokens = true;
});
builder.Services.AddAuthorization(options =>
{
options.AddPolicy("RequireMfa", policyIsAdminRequirement =>
{
policyIsAdminRequirement.Requirements.Add(new RequireMfa());
});
});
builder.Services.AddRazorPages();
Tę politykę następnie stosuje się na stronie Razor w razie potrzeby. Zasady można również dodać globalnie dla całej aplikacji.
[Authorize(Policy= "RequireMfa")]
public class IndexModel : PageModel
{
public void OnGet()
{
}
}
Jeśli użytkownik uwierzytelnia się bez MFA, amr oświadczenie prawdopodobnie będzie miało wartość pwd. Żądanie nie będzie autoryzowane w celu uzyskania dostępu do strony. Przy użyciu wartości domyślnych użytkownik zostanie przekierowany do strony Account/AccessDenied . To zachowanie można zmienić lub zaimplementować własną logikę niestandardową tutaj. W tym przykładzie zostanie dodany link, aby prawidłowy użytkownik mógł skonfigurować uwierzytelnianie wieloskładnikowe dla swojego konta.
@page
@model AspNetCoreRequireMfaOidc.AccessDeniedModel
@{
ViewData["Title"] = "AccessDenied";
Layout = "~/Pages/Shared/_Layout.cshtml";
}
<h1>AccessDenied</h1>
You require MFA to login here
<a href="https://localhost:44352/Manage/TwoFactorAuthentication">Enable MFA</a>
Teraz tylko użytkownicy uwierzytelnieni za pomocą uwierzytelniania wieloskładnikowego mogą uzyskiwać dostęp do strony lub witryny internetowej. Jeśli są używane różne typy uwierzytelniania wieloskładnikowego lub jeśli 2FA jest dopuszczalne, amr oświadczenie będzie miało różne wartości i musi zostać prawidłowo przetworzone. Różne serwery OpenID Connect zwracają również różne wartości dla tego żądania i mogą nie przestrzegać specyfikacji Wartości odwołania metody uwierzytelniania.
Podczas logowania bez uwierzytelniania wieloskładnikowego (na przykład przy użyciu tylko hasła):
Parametr
amrmapwdwartość:
Odmowa dostępu:
Alternatywnie logowanie przy użyciu OTP z Identity:
Dodatkowe zasoby
Autor: Damien Bowden
Uwierzytelnianie wieloskładnikowe (MFA) to proces, w którym użytkownik jest proszony podczas zdarzenia logowania o dodatkowe formy identyfikacji. Wskazówka może polegać na wprowadzeniu kodu z telefonu komórkowego, użyciu klucza FIDO2 lub zeskanowaniu odcisku palca. Jeśli potrzebujesz drugiej formy uwierzytelniania, zabezpieczenia są ulepszone. Dodatkowy czynnik nie jest łatwo uzyskiwany ani duplikowany przez cyberatakę.
W tym artykule opisano następujące obszary:
- Co to jest uwierzytelnianie wieloskładnikowe i jakie przepływy uwierzytelniania wieloskładnikowego są zalecane
- Konfigurowanie uwierzytelniania wieloskładnikowego dla stron administracyjnych przy użyciu platformy ASP.NET Core Identity
- Wysłanie wymogu logowania wieloskładnikowego do serwera OpenID Connect
- Wymuszanie, aby klient ASP.NET Core OpenID Connect wymagał uwierzytelniania wieloskładnikowego.
Uwierzytelnianie wieloskładnikowe, 2FA
Uwierzytelnianie wieloskładnikowe wymaga co najmniej dwóch lub więcej rodzajów dowodów potwierdzających tożsamość, takich jak coś, co wiesz, coś, co posiadasz, lub weryfikacja biometryczna, aby użytkownik mógł się uwierzytelnić.
Uwierzytelnianie dwuskładnikowe (2FA) przypomina podzbiór uwierzytelniania wieloskładnikowego, ale różnica polega na tym, że uwierzytelnianie wieloskładnikowe może wymagać co najmniej dwóch czynników w celu potwierdzenia tożsamości.
MFA TOTP (algorytm haseł jednorazowych oparty na czasie)
Uwierzytelnianie wieloskładnikowe korzystające z protokołu TOTP jest obsługiwaną implementacją przy użyciu ASP.NET Core Identity. Można go używać razem z dowolną zgodną aplikacją uwierzytelniającą, w tym:
- Aplikacja Microsoft Authenticator
- Aplikacja Google Authenticator
Aby uzyskać szczegółowe informacje o implementacji, zobacz następujący link:
Włączanie generowania kodów QR dla aplikacji uwierzytelniania TOTP na platformie ASP.NET Core
Hasła uwierzytelniania wieloskładnikowego/FIDO2 lub bez hasła
Klucz dostępu/FIDO2 jest obecnie:
- Najbezpieczniejszy sposób osiągnięcia uwierzytelniania wieloskładnikowego.
- Uwierzytelnianie wieloskładnikowe chroniące przed atakami phishingowymi. (Oprócz uwierzytelniania certyfikatów i systemu Windows dla firm)
Obecnie ASP.NET Core nie obsługuje bezpośrednio kluczy dostępu/FIDO2. W przypadku przepływów MFA lub bez hasła można używać kluczy dostępu/FIDO2.
Microsoft Entra ID zapewnia obsługę kluczy dostępu/FIDO2 oraz metod uwierzytelniania bez hasła. Aby uzyskać więcej informacji, zobacz Opcje uwierzytelniania bez hasła.
Inne formy uwierzytelniania wieloskładnikowego bez hasła mogą nie chronić przed wyłudzaniem informacji.
SMS z uwierzytelnianiem MFA
Uwierzytelnianie wieloskładnikowe za pomocą SMS znacząco zwiększa bezpieczeństwo w porównaniu z uwierzytelnianiem hasłem (pojedynczym czynnikiem). Jednak używanie wiadomości SMS jako drugiego czynnika nie jest już zalecane. Dla tego typu implementacji istnieje zbyt wiele znanych wektorów ataków.
Konfigurowanie uwierzytelniania wieloskładnikowego dla stron administracyjnych przy użyciu platformy ASP.NET Core Identity
Można wymusić uwierzytelnianie wieloskładnikowe na użytkownikach, aby uzyskać dostęp do poufnych stron w aplikacji ASP.NET Core Identity. Może to być przydatne w przypadku aplikacji, w których istnieją różne poziomy dostępu dla różnych tożsamości. Na przykład użytkownicy mogą wyświetlać dane profilu przy użyciu logowania przy użyciu hasła, ale administrator musi użyć uwierzytelniania wieloskładnikowego w celu uzyskania dostępu do stron administracyjnych.
Rozszerzenie logowania za pomocą żądania MFA
Kod demonstracyjny jest konfigurowany przy użyciu platformy ASP.NET Core z usługami Identity i Razor Pages. Metoda AddIdentity jest używana zamiast AddDefaultIdentity, więc implementacja IUserClaimsPrincipalFactory może służyć do dodawania oświadczeń do tożsamości po pomyślnym zalogowaniu.
Ostrzeżenie
W tym artykule przedstawiono użycie łańcuchów połączenia. Gdy lokalna baza danych jest używana do programowania i testowania, uwierzytelnianie użytkowników bazy danych za pośrednictwem parametry połączenia nie jest wymagane. W środowiskach produkcyjnych parametry połączenia czasami zawierają hasło do uwierzytelniania dostępu do bazy danych lub operacji bazy danych. Poświadczenie hasłem właściciela zasobu (ROPC) w ciągu połączenia stanowi zagrożenie bezpieczeństwa i należy go unikać w aplikacjach produkcyjnych. Aplikacje produkcyjne powinny korzystać z najbezpieczniejszego dostępnego przepływu uwierzytelniania. Aby uzyskać więcej informacji na temat uwierzytelniania aplikacji wdrożonych w środowiskach testowych lub produkcyjnych, zobacz tematy dotyczące zabezpieczeń ASP.NET Core.
public void ConfigureServices(IServiceCollection services)
{
services.AddDbContext<ApplicationDbContext>(options =>
options.UseSqlite(
Configuration.GetConnectionString("DefaultConnection")));
services.AddIdentity<IdentityUser, IdentityRole>(
options => options.SignIn.RequireConfirmedAccount = false)
.AddEntityFrameworkStores<ApplicationDbContext>()
.AddDefaultTokenProviders();
services.AddSingleton<IEmailSender, EmailSender>();
services.AddScoped<IUserClaimsPrincipalFactory<IdentityUser>,
AdditionalUserClaimsPrincipalFactory>();
services.AddAuthorization(options =>
options.AddPolicy("TwoFactorEnabled",
x => x.RequireClaim("amr", "mfa")));
services.AddRazorPages();
}
Klasa AdditionalUserClaimsPrincipalFactory dodaje amr roszczenie do roszczeń użytkownika tylko po pomyślnym logowaniu. Wartość oświadczenia jest odczytywana z bazy danych. Oświadczenie jest dodawane tutaj, ponieważ użytkownik powinien uzyskać dostęp tylko do bardziej chronionego widoku, jeśli tożsamość została uwierzytelniona przy użyciu uwierzytelniania wieloskładnikowego. Jeśli widok bazy danych jest odczytywany bezpośrednio z bazy danych zamiast korzystać z oświadczenia, można uzyskać dostęp do widoku bez uwierzytelniania wieloskładnikowego bezpośrednio po aktywowaniu uwierzytelniania wieloskładnikowego.
using Microsoft.AspNetCore.Identity;
using Microsoft.Extensions.Options;
using System.Collections.Generic;
using System.Security.Claims;
using System.Threading.Tasks;
namespace IdentityStandaloneMfa
{
public class AdditionalUserClaimsPrincipalFactory :
UserClaimsPrincipalFactory<IdentityUser, IdentityRole>
{
public AdditionalUserClaimsPrincipalFactory(
UserManager<IdentityUser> userManager,
RoleManager<IdentityRole> roleManager,
IOptions<IdentityOptions> optionsAccessor)
: base(userManager, roleManager, optionsAccessor)
{
}
public async override Task<ClaimsPrincipal> CreateAsync(IdentityUser user)
{
var principal = await base.CreateAsync(user);
var identity = (ClaimsIdentity)principal.Identity;
var claims = new List<Claim>();
if (user.TwoFactorEnabled)
{
claims.Add(new Claim("amr", "mfa"));
}
else
{
claims.Add(new Claim("amr", "pwd"));
}
identity.AddClaims(claims);
return principal;
}
}
}
Identity Ponieważ konfiguracja usługi zmieniła się w Startup klasie, układy Identity muszą zostać zaktualizowane. Utwórz szkielet Identity stron w aplikacji. Zdefiniuj układ w pliku Identity/Account/Manage/_Layout.cshtml.
@{
Layout = "/Pages/Shared/_Layout.cshtml";
}
Przypisz również układ dla wszystkich stron zarządzania na Identity stronach:
@{
Layout = "_Layout.cshtml";
}
Zweryfikuj wymaganie uwierzytelniania wieloskładnikowego na stronie administracyjnej
Strona administracyjna Razor sprawdza, czy użytkownik zalogował się przy użyciu uwierzytelniania wieloskładnikowego. W metodzie OnGet tożsamość jest używana do uzyskiwania dostępu do oświadczeń użytkownika. Oświadczenie amr jest sprawdzane pod kątem wartości mfa. Jeśli tożsamość nie ma tego oświadczenia lub ma wartość false, strona przekierowuje do strony Włączanie uwierzytelniania wieloskładnikowego. Jest to możliwe, ponieważ użytkownik zalogował się już, ale bez uwierzytelniania wieloskładnikowego.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
namespace IdentityStandaloneMfa
{
public class AdminModel : PageModel
{
public IActionResult OnGet()
{
var claimTwoFactorEnabled =
User.Claims.FirstOrDefault(t => t.Type == "amr");
if (claimTwoFactorEnabled != null &&
"mfa".Equals(claimTwoFactorEnabled.Value))
{
// You logged in with MFA, do the administrative stuff
}
else
{
return Redirect(
"/Identity/Account/Manage/TwoFactorAuthentication");
}
return Page();
}
}
}
Logika interfejsu użytkownika do przełączania danych logowania użytkownika
Zasady autoryzacji zostały dodane w pliku programu. Ta polityka wymaga amr oświadczenia o wartości mfa.
builder.Services.AddAuthorization(options =>
options.AddPolicy("TwoFactorEnabled",
x => x.RequireClaim("amr", "mfa")));
Te zasady można następnie użyć w _Layout widoku, aby wyświetlić lub ukryć menu Administratora z ostrzeżeniem:
@using Microsoft.AspNetCore.Authorization
@using Microsoft.AspNetCore.Identity
@inject SignInManager<IdentityUser> SignInManager
@inject UserManager<IdentityUser> UserManager
@inject IAuthorizationService AuthorizationService
Jeśli tożsamość zalogowała się przy użyciu uwierzytelniania wieloskładnikowego, menu Admin jest wyświetlane bez ostrzeżenia o podpowiedzi. Gdy użytkownik zalogował się bez uwierzytelniania wieloskładnikowego, zostanie wyświetlone menu Administrator (nie włączono) wraz z etykietkę narzędzia informującą użytkownika (wyjaśnienie ostrzeżenia).
@if (SignInManager.IsSignedIn(User))
{
@if ((AuthorizationService.AuthorizeAsync(User, "TwoFactorEnabled")).Result.Succeeded)
{
<li class="nav-item">
<a class="nav-link text-dark" asp-area="" asp-page="/Admin">Admin</a>
</li>
}
else
{
<li class="nav-item">
<a class="nav-link text-dark" asp-area="" asp-page="/Admin"
id="tooltip-demo"
data-toggle="tooltip"
data-placement="bottom"
title="MFA is NOT enabled. This is required for the Admin Page. If you have activated MFA, then logout, login again.">
Admin (Not Enabled)
</a>
</li>
}
}
Jeśli użytkownik zaloguje się bez uwierzytelniania wieloskładnikowego, zostanie wyświetlone ostrzeżenie:
Użytkownik jest przekierowywany do widoku włączania uwierzytelniania wieloskładnikowego po kliknięciu linku Administratora :
Wysłanie wymogu logowania wieloskładnikowego do serwera OpenID Connect
Parametr acr_values może służyć do przekazywania wymaganej mfa wartości z klienta do serwera w żądaniu uwierzytelniania.
Uwaga
Aby acr_values parametr zadziałał, należy go obsłużyć na serwerze OpenID Connect.
Klient OpenID Connect ASP.NET Core
Aplikacja kliencka OpenID Connect ASP.NET Core Razor Pages używa AddOpenIdConnect metody logowania do serwera OpenID Connect. Parametr acr_values jest ustawiany z wartością mfa i wysyłany z żądaniem uwierzytelniania. Element OpenIdConnectEvents jest używany do dodawania tego.
Aby uzyskać zalecane acr_values wartości parametrów, zobacz Wartości referencyjne metody uwierzytelniania.
public void ConfigureServices(IServiceCollection services)
{
services.AddAuthentication(options =>
{
options.DefaultScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.DefaultChallengeScheme =
OpenIdConnectDefaults.AuthenticationScheme;
})
.AddCookie()
.AddOpenIdConnect(options =>
{
options.SignInScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.Authority = "<OpenID Connect server URL>";
options.RequireHttpsMetadata = true;
options.ClientId = "<OpenID Connect client ID>";
options.ClientSecret = "<>";
options.ResponseType = "code";
options.UsePkce = true;
options.Scope.Add("profile");
options.Scope.Add("offline_access");
options.SaveTokens = true;
options.Events = new OpenIdConnectEvents
{
OnRedirectToIdentityProvider = context =>
{
context.ProtocolMessage.SetParameter("acr_values", "mfa");
return Task.FromResult(0);
}
};
});
Przykładowy serwer OpenID Connect IdentityServer 4 z ASP.NET Core Identity
Na serwerze OpenID Connect, który jest implementowany przy użyciu ASP.NET Core Identity z widokami MVC, zostanie utworzony nowy widok o nazwie ErrorEnable2FA.cshtml . Widok:
- Wyświetla, czy Identity pochodzi z aplikacji wymagającej uwierzytelniania wieloskładnikowego, ale użytkownik nie aktywował tego w Identity.
- Informuje użytkownika i dodaje link, aby to aktywować.
@{
ViewData["Title"] = "ErrorEnable2FA";
}
<h1>The client application requires you to have MFA enabled. Enable this, try login again.</h1>
<br />
You can enable MFA to login here:
<br />
<a asp-controller="Manage" asp-action="TwoFactorAuthentication">Enable MFA</a>
W metodzie Login implementacja interfejsu IIdentityServerInteractionService_interaction służy do uzyskiwania dostępu do parametrów żądania OpenID Connect. Parametr acr_values jest uzyskiwany poprzez dostęp do właściwości AcrValues. Po tym, jak klient wysłał to z ustawieniem mfa, można to sprawdzić.
Jeśli uwierzytelnianie wieloskładnikowe jest wymagane, a użytkownik w aplikacji ASP.NET Core Identity ma włączoną uwierzytelnianie wieloskładnikowe, logowanie będzie kontynuowane. Gdy użytkownik nie ma włączonego uwierzytelniania wieloskładnikowego, jest przekierowywany do niestandardowego widoku ErrorEnable2FA.cshtml. Następnie ASP.NET Core Identity loguje użytkownika.
//
// POST: /Account/Login
[HttpPost]
[AllowAnonymous]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Login(LoginInputModel model)
{
var returnUrl = model.ReturnUrl;
var context =
await _interaction.GetAuthorizationContextAsync(returnUrl);
var requires2Fa =
context?.AcrValues.Count(t => t.Contains("mfa")) >= 1;
var user = await _userManager.FindByNameAsync(model.Email);
if (user != null && !user.TwoFactorEnabled && requires2Fa)
{
return RedirectToAction(nameof(ErrorEnable2FA));
}
// code omitted for brevity
Metoda ExternalLoginCallback działa jak logowanie lokalne Identity. Właściwość AcrValues jest sprawdzana dla wartości mfa. Jeśli wartość mfa jest obecna, przed zakończeniem logowania wymuszane jest uwierzytelnianie wieloskładnikowe (na przykład przekierowanie do widoku ErrorEnable2FA).
//
// GET: /Account/ExternalLoginCallback
[HttpGet]
[AllowAnonymous]
public async Task<IActionResult> ExternalLoginCallback(
string returnUrl = null,
string remoteError = null)
{
var context =
await _interaction.GetAuthorizationContextAsync(returnUrl);
var requires2Fa =
context?.AcrValues.Count(t => t.Contains("mfa")) >= 1;
if (remoteError != null)
{
ModelState.AddModelError(
string.Empty,
_sharedLocalizer["EXTERNAL_PROVIDER_ERROR",
remoteError]);
return View(nameof(Login));
}
var info = await _signInManager.GetExternalLoginInfoAsync();
if (info == null)
{
return RedirectToAction(nameof(Login));
}
var email = info.Principal.FindFirstValue(ClaimTypes.Email);
if (!string.IsNullOrEmpty(email))
{
var user = await _userManager.FindByNameAsync(email);
if (user != null && !user.TwoFactorEnabled && requires2Fa)
{
return RedirectToAction(nameof(ErrorEnable2FA));
}
}
// Sign in the user with this external login provider if the user already has a login.
var result = await _signInManager
.ExternalLoginSignInAsync(
info.LoginProvider,
info.ProviderKey,
isPersistent:
false);
// code omitted for brevity
Jeśli użytkownik jest już zalogowany, aplikacja kliencka:
- Nadal sprawdza poprawność
amroświadczenia. - Można skonfigurować uwierzytelnianie wieloskładnikowe za pomocą linku do widoku ASP.NET Core Identity .
Wymuszanie, aby klient ASP.NET Core OpenID Connect wymagał uwierzytelniania wieloskładnikowego.
W tym przykładzie pokazano, jak aplikacja ASP.NET Core Razor Page, która używa interfejsu OpenID Connect do logowania, może wymagać uwierzytelnienia użytkowników przy użyciu uwierzytelniania wieloskładnikowego.
Aby zweryfikować wymaganie MFA, zostanie utworzone wymaganie IAuthorizationRequirement. Zostanie to dodane do stron przy użyciu zasad wymagających uwierzytelniania wieloskładnikowego.
using Microsoft.AspNetCore.Authorization;
namespace AspNetCoreRequireMfaOidc
{
public class RequireMfa : IAuthorizationRequirement{}
}
Zaimplementowano AuthorizationHandler element, który będzie korzystał z amr roszczenia i sprawdzał wartość mfa. Element amr jest zwracany w wyniku id_token pomyślnego uwierzytelnienia i może mieć wiele różnych wartości zdefiniowanych w specyfikacji Wartości referencyjne metod uwierzytelniania.
Zwrócona wartość zależy od sposobu uwierzytelniania tożsamości i implementacji serwera OpenID Connect.
AuthorizationHandler wykorzystuje RequireMfa wymaganie i weryfikuje amr oświadczenie. Serwer OpenID Connect można zaimplementować przy użyciu serwera IdentityServer4 z ASP.NET Core Identity. Gdy użytkownik loguje się przy użyciu TOTP, klauzula amr jest zwracana z wartością MFA. Jeśli korzystasz z innej implementacji serwera OpenID Connect lub innego typu uwierzytelniania wieloskładnikowego, wartość amr oświadczenia może być inna. Aby można było również zaakceptować ten kod, należy go rozszerzyć.
public class RequireMfaHandler : AuthorizationHandler<RequireMfa>
{
protected override Task HandleRequirementAsync(
AuthorizationHandlerContext context,
RequireMfa requirement)
{
if (context == null)
throw new ArgumentNullException(nameof(context));
if (requirement == null)
throw new ArgumentNullException(nameof(requirement));
var amrClaim =
context.User.Claims.FirstOrDefault(t => t.Type == "amr");
if (amrClaim != null && amrClaim.Value == Amr.Mfa)
{
context.Succeed(requirement);
}
return Task.CompletedTask;
}
}
W metodzie Startup.ConfigureServices metoda AddOpenIdConnect jest używana jako domyślny schemat wyzwania. Procedura obsługi autoryzacji używana do sprawdzania amr oświadczenia jest dodawana do kontenera Inversion of Control. Następnie zostanie utworzona zasada, która dodaje wymaganie RequireMfa.
public void ConfigureServices(IServiceCollection services)
{
services.ConfigureApplicationCookie(options =>
options.Cookie.SecurePolicy =
CookieSecurePolicy.Always);
services.AddSingleton<IAuthorizationHandler, RequireMfaHandler>();
services.AddAuthentication(options =>
{
options.DefaultScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.DefaultChallengeScheme =
OpenIdConnectDefaults.AuthenticationScheme;
})
.AddCookie()
.AddOpenIdConnect(options =>
{
options.SignInScheme =
CookieAuthenticationDefaults.AuthenticationScheme;
options.Authority = "https://localhost:44352";
options.RequireHttpsMetadata = true;
options.ClientId = "AspNetCoreRequireMfaOidc";
options.ClientSecret = "AspNetCoreRequireMfaOidcSecret";
options.ResponseType = "code";
options.UsePkce = true;
options.Scope.Add("profile");
options.Scope.Add("offline_access");
options.SaveTokens = true;
});
services.AddAuthorization(options =>
{
options.AddPolicy("RequireMfa", policyIsAdminRequirement =>
{
policyIsAdminRequirement.Requirements.Add(new RequireMfa());
});
});
services.AddRazorPages();
}
Tę politykę następnie stosuje się na stronie Razor w razie potrzeby. Zasady można również dodać globalnie dla całej aplikacji.
[Authorize(Policy= "RequireMfa")]
public class IndexModel : PageModel
{
public void OnGet()
{
}
}
Jeśli użytkownik uwierzytelnia się bez MFA, amr oświadczenie prawdopodobnie będzie miało wartość pwd. Żądanie nie będzie autoryzowane w celu uzyskania dostępu do strony. Przy użyciu wartości domyślnych użytkownik zostanie przekierowany do strony Account/AccessDenied . To zachowanie można zmienić lub zaimplementować własną logikę niestandardową tutaj. W tym przykładzie zostanie dodany link, aby prawidłowy użytkownik mógł skonfigurować uwierzytelnianie wieloskładnikowe dla swojego konta.
@page
@model AspNetCoreRequireMfaOidc.AccessDeniedModel
@{
ViewData["Title"] = "AccessDenied";
Layout = "~/Pages/Shared/_Layout.cshtml";
}
<h1>AccessDenied</h1>
You require MFA to login here
<a href="https://localhost:44352/Manage/TwoFactorAuthentication">Enable MFA</a>
Teraz tylko użytkownicy uwierzytelnieni za pomocą uwierzytelniania wieloskładnikowego mogą uzyskiwać dostęp do strony lub witryny internetowej. Jeśli są używane różne typy uwierzytelniania wieloskładnikowego lub jeśli 2FA jest dopuszczalne, amr oświadczenie będzie miało różne wartości i musi zostać prawidłowo przetworzone. Różne serwery OpenID Connect zwracają również różne wartości dla tego żądania i mogą nie przestrzegać specyfikacji Wartości odwołania metody uwierzytelniania.
Podczas logowania bez uwierzytelniania wieloskładnikowego (na przykład przy użyciu tylko hasła):
Parametr
amrmapwdwartość:
Odmowa dostępu:
Alternatywnie logowanie przy użyciu OTP z Identity: