서버 쪽 ASP.NET Core Blazor 추가 보안 시나리오

이 문서에서는 앱에 토큰을 전달하는 방법을 포함하여 추가 보안 시나리오에 대해 서버 쪽 Blazor 을 구성하는 방법을 설명합니다 Blazor .

참고 항목

이 문서의 코드 예제에서는 NRT(nullable 참조 형식) 및 .NET 컴파일러 null 상태 정적 분석을 채택합니다. 이 분석은 .NET 6 이상의 ASP.NET Core에서 지원됩니다. ASP.NET Core 5.0 이하를 대상으로 하는 경우 아티클 예제의 , TodoItem[]?및 WeatherForecast[]?IEnumerable<GitHubBranch>? 형식에서 string?null 형식 지정(?)을 제거합니다.

서버 쪽 Blazor 앱에 토큰 전달

s에 대해 Blazor Web App이 섹션을 업데이트하는 것은 s(dotnet/AspNetCore.Docs#31691)의 Blazor Web App토큰 전달에 대한 업데이트 섹션을 보류 중입니다. 자세한 내용은 대화형 서버 모드에서 HttpClient에 액세스 토큰을 제공하는 문제(dotnet/aspnetcore#52390)를 참조하세요.

의 경우 Blazor Server이 문서 섹션의 7.0 버전을 확인합니다.

인증 체계 설정

둘 이상의 인증 미들웨어를 사용하므로 둘 이상의 인증 체계를 사용하는 앱의 경우 파일의 Program 엔드포인트 구성에서 사용하는 체계 Blazor 를 명시적으로 설정할 수 있습니다. 다음 예에서는 OIDC(OpenID Connect) 체계를 설정합니다.

using Microsoft.AspNetCore.Authentication.OpenIdConnect;

...

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

사용자 지정 서비스에 대한 사용자를 캡처하는 회로 처리기

A를 CircuitHandler 사용하여 서비스에서 사용자를 AuthenticationStateProvider 캡처하고 사용자를 설정합니다. 사용자를 업데이트하려면 콜백을 등록하고 큐에 AuthenticationStateChanged 추가하여 Task 새 사용자를 가져오고 서비스를 업데이트합니다. 다음 예제에서는 이 접근 방식을 보여 줍니다.

다음 예제에서

• OnConnectionUpAsync 는 회로가 다시 연결될 때마다 호출되며 연결 수명 동안 사용자를 설정합니다. 다음 예제에서는 OnConnectionUpAsync 인증 변경AuthenticationChanged 에 대한 처리기를 통해 업데이트를 구현하지 않는 한 메서드만 필요합니다.
• OnCircuitOpenedAsync 는 인증 변경된 처리기를 AuthenticationChanged연결하고 사용자를 업데이트하기 위해 호출됩니다.
• 코드 실행의 UpdateAuthentication 이 시점에서 예외를 보고할 방법이 없기 때문에 태스크 블록은 catch 예외에 대해 아무 작업도 수행하지 않습니다. 작업에서 예외가 throw되면 예외가 앱의 다른 위치에서 보고됩니다.

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() => currentUser;

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

internal sealed class UserCircuitHandler(
        AuthenticationStateProvider authenticationStateProvider,
        UserService userService) 
        : CircuitHandler, IDisposable
{
    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 파일에서:

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

...

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

구성 요소의 서비스를 사용하여 사용자를 가져옵니다.

@inject UserService UserService

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

MVC, Razor Pages 및 기타 ASP.NET Core 시나리오의 미들웨어에서 사용자를 설정하려면 인증 미들웨어가 실행된 후 사용자 지정 미들웨어에서 호출 SetUser UserService 하거나 구현을 사용하여 IClaimsTransformation 사용자를 설정합니다. 다음 예제에서는 미들웨어 접근 방식을 채택합니다.

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);
    }
}

파일에서 Program 호출하기 app.MapRazorComponents<App>() 직전에 미들웨어를 호출합니다.

app.UseMiddleware<UserServiceMiddleware>();

나가는 요청 미들웨어의 액세스 AuthenticationStateProvider

AuthenticationStateProvider DelegatingHandler 회로 작업 처리기를 사용하여 나가는 요청 미들웨어에서 만든 IHttpClientFactory for HttpClient 에 액세스할 수 있습니다.

참고 항목

ASP.NET Core 앱에서 사용하여 IHttpClientFactory 만든 인스턴스에서 HttpClient HTTP 요청에 대한 위임 처리기를 정의하는 일반적인 지침은 ASP.NET Core에서 IHttpClientFactory를 사용하여 HTTP 요청 만들기의 다음 섹션을 참조하세요.

• 나가는 요청 미들웨어
• 나가는 요청 미들웨어에서 DI 사용

다음 예제에서는 인증된 사용자의 사용자 지정 사용자 이름 헤더를 나가는 요청에 연결하는 데 사용합니다 AuthenticationStateProvider .

먼저 DI(종속성 주입) 문서의 다음 섹션에서 Blazor 클래스를 구현 CircuitServicesAccessor 합니다.

다른 DI 범위에서 서버 쪽 Blazor 서비스에 액세스

구현에서 CircuitServicesAccessor DelegatingHandler 액세스 AuthenticationStateProvider 하려면 사용합니다.

AuthenticationStateHandler.cs:

public class AuthenticationStateHandler(
    CircuitServicesAccessor circuitServicesAccessor) 
    : DelegatingHandler
{
    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 AuthenticationStateHandler 만드는 HttpClient 처리기를 IHttpClientFactory 등록하고 추가합니다.

builder.Services.AddTransient<AuthenticationStateHandler>();

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