Sunucu tarafı ASP.NET Core Blazor ek güvenlik senaryoları

Bu makalede, bir uygulamaya belirteç Blazor geçirme de dahil olmak üzere ek güvenlik senaryoları için sunucu tarafı Blazor yapılandırması açıklanmaktadır.

Not

Bu makaledeki kod örnekleri, .NET 6 veya sonraki sürümlerindeki ASP.NET Core'da desteklenen null atanabilir başvuru türlerini (NTS) ve .NET derleyici null durum statik analizini benimser. Core 5.0 veya önceki ASP.NET hedeflerken, makalenin örneklerindeki , , ve türlerinden string?null tür atamasını (?) kaldırın.IEnumerable<GitHubBranch>?WeatherForecast[]?TodoItem[]?

Belirteçleri sunucu tarafı Blazor uygulamasına geçirme

Web Apps için Blazor bu bölümün güncelleştirilmesi, Web Apps'te Blazor belirteç geçirmeyle ilgili Güncelleştirme bölümünü bekliyor (dotnet/AspNetCore.Docs #31691). Daha fazla bilgi için bkz . Etkileşimli Sunucu modunda HttpClient'a Erişim Belirteci sağlama sorunu (dotnet/aspnetcore #52390).

içinBlazor Server, bu makale bölümünün 7.0 sürümünü görüntüleyin.

Kimlik doğrulama düzenini ayarlama

Birden fazla Kimlik Doğrulama Ara Yazılımı kullanan ve dolayısıyla birden fazla kimlik doğrulama şemasına sahip olan bir uygulama için, kullanan Blazor düzen açıkça dosyanın uç nokta yapılandırmasında Program ayarlanabilir. Aşağıdaki örnek OpenID Bağlan (OIDC) düzenini ayarlar:

using Microsoft.AspNetCore.Authentication.OpenIdConnect;

...

app.MapRazorComponents<App>().RequireAuthorization(
    new AuthorizeAttribute
    {
        AuthenticationSchemes = OpenIdConnectDefaults.AuthenticationScheme
    })
    .AddInteractiveServerRenderMode();

Özel hizmetler için kullanıcıları yakalamak için devre işleyicisi

CircuitHandler'den AuthenticationStateProvider bir kullanıcı yakalamak ve kullanıcıyı bir hizmette ayarlamak için kullanın. Kullanıcıyı güncelleştirmek istiyorsanız, yeni kullanıcıyı almak ve hizmeti güncelleştirmek için öğesine Task bir geri AuthenticationStateChanged çağırma kaydedin ve kuyruğa alın. Aşağıdaki örnekte yaklaşımı gösterilmektedir.

Aşağıdaki örnekte:

• OnConnectionUpAsync , bağlantı hattı her yeniden bağlandığında çağrılır ve kullanıcı bağlantının ömrü boyunca ayarlanır. OnConnectionUpAsync Kimlik doğrulama değişiklikleri için bir işleyici aracılığıyla güncelleştirmeler uygulamadığınız sürece (AuthenticationChangedaşağıdaki örnekte) yalnızca yöntemi gereklidir.
• OnCircuitOpenedAsync , kullanıcıyı güncelleştirmek için kimlik doğrulaması değiştirilmiş işleyicisini AuthenticationChangedeklemek için çağrılır.
• Görev catch bloğu UpdateAuthentication , özel durumlarda hiçbir eylem gerçekleştirmez çünkü bu noktada bunları kod yürütmede bildirmenin bir yolu yoktur. Görevden bir özel durum oluşturulursa, özel durum uygulamanın başka bir yerinde bildirilir.

UserService.cs:

using System.Security.Claims;
using Microsoft.AspNetCore.Components.Authorization;
using Microsoft.AspNetCore.Components.Server.Circuits;

public class UserService
{
    private ClaimsPrincipal currentUser = new(new ClaimsIdentity());

    public ClaimsPrincipal GetUser()
    {
        return currentUser;
    }

    internal void SetUser(ClaimsPrincipal user)
    {
        if (currentUser != user)
        {
            currentUser = user;
        }
    }
}

internal sealed class UserCircuitHandler : CircuitHandler, IDisposable
{
    private readonly AuthenticationStateProvider authenticationStateProvider;
    private readonly UserService userService;

    public UserCircuitHandler(
        AuthenticationStateProvider authenticationStateProvider,
        UserService userService)
    {
        this.authenticationStateProvider = authenticationStateProvider;
        this.userService = userService;
    }

    public override Task OnCircuitOpenedAsync(Circuit circuit, 
        CancellationToken cancellationToken)
    {
        authenticationStateProvider.AuthenticationStateChanged += 
            AuthenticationChanged;

        return base.OnCircuitOpenedAsync(circuit, cancellationToken);
    }

    private void AuthenticationChanged(Task<AuthenticationState> task)
    {
        _ = UpdateAuthentication(task);

        async Task UpdateAuthentication(Task<AuthenticationState> task)
        {
            try
            {
                var state = await task;
                userService.SetUser(state.User);
            }
            catch
            {
            }
        }
    }

    public override async Task OnConnectionUpAsync(Circuit circuit, 
        CancellationToken cancellationToken)
    {
        var state = await authenticationStateProvider.GetAuthenticationStateAsync();
        userService.SetUser(state.User);
    }

    public void Dispose()
    {
        authenticationStateProvider.AuthenticationStateChanged -= 
            AuthenticationChanged;
    }
}

Program dosyasında:

using Microsoft.AspNetCore.Components.Server.Circuits;
using Microsoft.Extensions.DependencyInjection.Extensions;

...

builder.Services.AddScoped<UserService>();
builder.Services.TryAddEnumerable(
    ServiceDescriptor.Scoped<CircuitHandler, UserCircuitHandler>());

Kullanıcıyı edinmek için bir bileşendeki hizmeti kullanın:

@inject UserService UserService

<h1>Hello, @(UserService.GetUser().Identity?.Name ?? "world")!</h1>

Kullanıcıyı MVC, Razor Sayfalar ve diğer ASP.NET Core senaryolarında ara yazılımda ayarlamak için, Kimlik Doğrulama Ara Yazılımı çalıştırıldıktan sonra özel ara yazılımda öğesini çağırın SetUserUserService veya kullanıcıyı bir IClaimsTransformation uygulamayla ayarlayın. Aşağıdaki örnek ara yazılım yaklaşımını benimser.

UserServiceMiddleware.cs:

public class UserServiceMiddleware
{
    private readonly RequestDelegate next;

    public UserServiceMiddleware(RequestDelegate next)
    {
        this.next = next ?? throw new ArgumentNullException(nameof(next));
    }

    public async Task InvokeAsync(HttpContext context, UserService service)
    {
        service.SetUser(context.User);
        await next(context);
    }
}

dosyasında çağrısından app.MapRazorComponents<App>()Program hemen önce ara yazılımı çağırın:

app.UseMiddleware<UserServiceMiddleware>();

Giden istek ara yazılımında erişim AuthenticationStateProvider

AuthenticationStateProvider ile IHttpClientFactory oluşturulan için DelegatingHandlerHttpClient öğesine giden istek ara yazılımında bağlantı hattı etkinlik işleyicisi kullanılarak erişilebilir.

Not

ASP.NET Core uygulamalarında kullanılarak IHttpClientFactory oluşturulan örneklere göre HttpClient HTTP istekleri için temsilci işleyicileri tanımlama hakkında genel yönergeler için, ASP.NET Core'da IHttpClientFactory kullanarak HTTP istekleri oluşturma'nın aşağıdaki bölümlerine bakın:

• Giden istek ara yazılımı
• Giden istek ara yazılımında DI kullanma

Aşağıdaki örnek, giden isteklere kimliği doğrulanmış kullanıcılar için özel bir kullanıcı adı üst bilgisi eklemek için kullanır AuthenticationStateProvider .

İlk olarak, bağımlılık ekleme (DI) makalesinin Blazor aşağıdaki bölümünde sınıfını uygulayınCircuitServicesAccessor:

Farklı bir DI kapsamından sunucu tarafı Blazor hizmetlerine erişme

CircuitServicesAccessor uygulamasında öğesine erişmek AuthenticationStateProviderDelegatingHandler için öğesini kullanın.

AuthenticationStateHandler.cs:

public class AuthenticationStateHandler : DelegatingHandler
{
    readonly CircuitServicesAccessor circuitServicesAccessor;

    public AuthenticationStateHandler(
        CircuitServicesAccessor circuitServicesAccessor)
    {
        this.circuitServicesAccessor = circuitServicesAccessor;
    }

    protected override async Task<HttpResponseMessage> SendAsync(
        HttpRequestMessage request, CancellationToken cancellationToken)
    {
        var authStateProvider = circuitServicesAccessor.Services
            .GetRequiredService<AuthenticationStateProvider>();
        var authState = await authStateProvider.GetAuthenticationStateAsync();
        var user = authState.User;

        if (user.Identity is not null && user.Identity.IsAuthenticated)
        {
            request.Headers.Add("X-USER-IDENTITY-NAME", user.Identity.Name);
        }

        return await base.SendAsync(request, cancellationToken);
    }
}

Program dosyasında öğesini kaydedin AuthenticationStateHandler ve işleyicisini örnek oluşturan HttpClient öğesine IHttpClientFactory ekleyin:

builder.Services.AddTransient<AuthenticationStateHandler>();

builder.Services.AddHttpClient("HttpMessageHandler")
    .AddHttpMessageHandler<AuthenticationStateHandler>();