oprogramowanie pośredniczące ASP.NET Core

Uwaga

Nie jest to najnowsza wersja tego artykułu. Aby zapoznać się z bieżącą wersją, zobacz wersję .NET 11 tego artykułu.

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.

Oprogramowanie pośredniczące to oprogramowanie, które jest wmontowane w potok aplikacji w celu obsługi żądań i odpowiedzi. Każde oprogramowanie pośredniczące:

  • Wybiera, czy należy przekazać żądanie do następnego middleware w strumieniu przetwarzania.
  • Może wykonać pracę zarówno przed następnym oprogramowaniem pośredniczącym, jak i po nim w potoku.

Delegaci żądań są używani do kompilowania potoku żądania. Delegaci żądań obsługują każde żądanie HTTP.

Skonfiguruj delegaty żądań przy użyciu metod rozszerzających Run, Map i Use. Można zdefiniować pojedynczy delegat żądania bezpośrednio jako metodę anonimową (nazywaną middlewarem wbudowanym) lub zdefiniować go w klasie wielokrotnego użytku. Te wbudowane metody anonimowe lub klasy wielokrotnego użytku są nazywane oprogramowaniem pośredniczącym lub składnikami oprogramowania pośredniczącego. Każde oprogramowanie pośredniczące w przepływie żądań jest odpowiedzialne za wywoływanie kolejnego oprogramowania pośredniczącego w przepływie lub przerywanie przepływu. Gdy oprogramowanie pośredniczące zatrzymuje się, jest ono nazywane końcowym oprogramowaniem pośredniczącym, ponieważ zapobiega dalszemu przetwarzaniu żądania przez oprogramowanie pośredniczące.

Aby uzyskać więcej informacji na temat różnic między potokami żądań w ASP.NET Core i ASP.NET 4.x z dodatkowymi przykładami oprogramowania pośredniczącego, zobacz Migrowanie modułów HTTP do oprogramowania pośredniczącego ASP.NET Core.

Rola oprogramowania pośredniczącego według typu aplikacji

Na serwerze żądania przeglądarki są przetwarzane przez strony Blazor, Razor i proces MVC z wykorzystaniem oprogramowania pośredniczącego. Wskazówki zawarte w tym artykule dotyczą tych typów aplikacji.

Autonomiczne aplikacje Blazor WebAssembly są uruchamiane w całości na kliencie i nie przetwarzają żądań przy użyciu kanału oprogramowania pośredniczącego. Wskazówki zawarte w tym artykule nie dotyczą autonomicznych aplikacji Blazor WebAssembly.

Analiza kodu oprogramowania pośredniczącego

Aby uzyskać więcej informacji o analizatorach platformy kompilatora ASP.NET Core, które analizują kod aplikacji pod kątem jakości, zobacz Diagnostyczna analiza kodu w aplikacjach ASP.NET Core.

Utwórz potok oprogramowania pośredniczącego za pomocą WebApplication

Potok przetwarzania żądań w ASP.NET Core składa się z sekwencji delegatów żądań, wywoływanych jeden po drugim. Na poniższym diagramie przedstawiono tę koncepcję. Przebieg wykonywania przebiega zgodnie z czarnymi strzałkami.

Wzorzec przetwarzania żądań przedstawiający żądanie przychodzące do aplikacji, przetwarzanie przez trzy warstwy middleware oraz odpowiedź opuszczającą aplikację. Każda warstwa middleware wykonuje swoją logikę i przekazuje żądanie do następnej warstwy middleware w instrukcji next(). Po przetworzeniu żądania przez trzecią warstwę middleware żądanie przechodzi z powrotem przez dwie poprzednie warstwy middleware w odwrotnej kolejności w celu wykonania dodatkowego przetwarzania po ich instrukcjach next(), zanim opuści aplikację jako odpowiedź do klienta.

Każdy delegat może wykonywać operacje przed następnym delegatem i po nim. Delegaci obsługujący wyjątki powinni być wywoływani na wczesnym etapie w potoku, aby mogli przechwytywać wyjątki występujące w późniejszych etapach potoku.

Uwaga

Aby eksperymentować lokalnie z przykładami kodu w tej sekcji, utwórz aplikację ASP.NET Core przy użyciu szablonu projektu ASP.NET Core Empty . W przypadku korzystania z interfejsu wiersza polecenia platformy .NET krótka nazwa szablonu to web (dotnet new web).

Najprostsza aplikacja ASP.NET Core wykorzystuje Run do skonfigurowania pojedynczego middleware terminala jako anonimową funkcję delegata żądania, aby obsługiwać żądania bez potoku żądania.

W poniższym przykładzie:

  • Wywołanie do RunExtensions.Run jest uruchamiane przy każdym żądaniu i zapisuje "Hello world!" w odpowiedzi.
  • Wywołanie WebApplication.Run na końcu bloku kodu uruchamia aplikację i blokuje wątek wywołujący aż do zamknięcia hosta.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Run(async context =>
{
    await context.Response.WriteAsync("Hello world!");
});

app.Run();

Odpowiedź podczas uzyskiwania dostępu do aplikacji w przeglądarce pod adresem URL uruchamiania:

Hello world!

Połącz wiele delegatów żądań razem za pomocą funkcji Use. Parametr next reprezentuje następnego delegata w potoku. Zazwyczaj można wykonywać akcje zarówno przed, jak i po delegacie next .

W poniższym przykładzie pokazano:

  • Dwa Use wywołania, każde z nich zapisuje w konsoli:
    • Gdzie można wykonać pracę, która może zapisywać do odpowiedzi (context.Response, HttpResponse).
    • Tam, gdzie można wykonać pracę, która nie zapisuje danych w odpowiedzi po wywołaniu parametru next.
  • Delegat terminalu żądania z wywołaniem RunExtensions.Run piszącym "Hello world!" do odpowiedzi.
  • Ostateczne Use wywołanie, które nigdy nie jest wykonywane, ponieważ jest zgodne z pełnomocnikiem żądania terminalu Run .
  • Wywołanie na końcu WebApplication.Run bloku kodu, w celu uruchomienia aplikacji i zablokowania wątku wywołującego do czasu zamknięcia hosta.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Use(async (context, next) =>
{
    Console.WriteLine("Work that can write to the response. (1)");
    await next.Invoke(context);
    Console.WriteLine("Work that doesn't write to the response. (1)");
});

app.Use(async (context, next) =>
{
    Console.WriteLine("Work that can write to the response. (2)");
    await next.Invoke(context);
    Console.WriteLine("Work that doesn't write to the response. (2)");
});

app.Run(async context =>
{
    await context.Response.WriteAsync("Hello world!");
});

app.Use(async (context, next) =>
{
    Console.WriteLine("This statement isn't reached. (3)");
    await next.Invoke(context);
    Console.WriteLine("This statement isn't reached. (3)");
});

app.Run();

W oknie konsoli aplikacji po uruchomieniu aplikacji:

Praca, która może zapisywać informacje do odpowiedzi. (1) Praca, która może zapisywać informacje do odpowiedzi. (2) Praca, która nie zapisuje w odpowiedzi. (2) Praca, która nie zapisuje w odpowiedzi. (1)

Przerywanie potoku żądań jest często pożądane, ponieważ pozwala uniknąć niepotrzebnej pracy. Na przykład oprogramowanie pośredniczące obsługujące pliki statyczne może działać jako terminalowe oprogramowanie pośredniczące, przetwarzając żądanie dotyczące pliku statycznego i pomijając pozostałą część potoku. Middleware dodane do potoku przed middleware końcowym nadal przetwarza kod po ich next.Invoke instrukcjach. Jeśli nie planujesz wywoływać next.Invoke, ponieważ twoim celem jest zakończenie przetwarzania, użyj Run delegata zamiast wywoływania Use metody rozszerzenia.

Nie wywołujej wywołań next.Invoke podczas lub po wysłaniu odpowiedzi do klienta. Po uruchomieniu HttpResponse każda zmiana powoduje wyjątek. Na przykład ustawienie nagłówków lub kodu stanu odpowiedzi zgłasza wyjątek po rozpoczęciu odpowiedzi. Zapisywanie w treści odpowiedzi po wywołaniu next może:

  • Naruszenie protokołu, takie jak zapisanie większej liczby bajtów do odpowiedzi niż podana długość zawartości odpowiedzi (wartość nagłówka Content-Length).
  • Uszkodzony format treści, taki jak zapisywanie stopki HTML w pliku CSS.

Aby określić, czy odpowiedź została uruchomiona, sprawdź wartość HasStarted.

Aby uzyskać więcej informacji, zobacz oprogramowanie pośredniczące krótkiego sprzężenia po routingu.

Run delegate

Delegat Run nie otrzymuje parametru next . Pierwszy Run delegat zawsze kończy potok. Run jest również konwencją, a niektóre oprogramowanie pośredniczące może uwidaczniać Run metody wykonywane na końcu potoku.

Żaden Use albo Run delegat po pierwszym Run delegacie nie jest wywoływany.

Rozgałęzianie kanału oprogramowania pośredniego

Map rozszerzenia są używane jako konwencja do rozgałęzinia potoku przetwarzania żądań. Map rozgałęzia potok żądań na podstawie dopasowań podanej ścieżki żądania. Jeśli ścieżka żądania rozpoczyna się od podanej ścieżki, gałąź zostanie wykonana.

W poniższym przykładzie HandleMap1 jest wywoływane dla żądań do /map1, a HandleMap2 jest wywoływane dla żądań do /map2.

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Map("/map1", HandleMap1);
app.Map("/map2", HandleMap2);

app.Run(async context =>
{
    await context.Response.WriteAsync("Hello from the non-Map delegate!");
});

app.Run();

private static void HandleMap1(IApplicationBuilder app)
{
    app.Run(async context =>
    {
        await context.Response.WriteAsync("Map 1");
    });
}

private static void HandleMap2(IApplicationBuilder app)
{
    app.Run(async context =>
    {
        await context.Response.WriteAsync("Map 2");
    });
}

W poniższej tabeli przedstawiono żądania i odpowiedzi przy użyciu poprzedniego kodu.

Zażądaj Odpowiedź
/ Hello from the non-Map delegate.
/map1 Map 1
/map2 Map 2
/map3 Hello from the non-Map delegate.

Gdy jest używany składnik Map, dopasowane segmenty ścieżki są usuwane ze składnika HttpRequest.Path i dołączane do składnika HttpRequest.PathBase dla każdego żądania.

Map może pasować do wielu segmentów jednocześnie:

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Map("/map1/segment1", HandleMultipleSegments);

app.Run(async context =>
{
    await context.Response.WriteAsync("Hello from the non-Map delegate.");
});

app.Run();

private static void HandleMultipleSegments(IApplicationBuilder app)
{
    app.Run(async context =>
    {
        await context.Response.WriteAsync("Processing '/map1/segment1'");
    });
}

W poniższej tabeli przedstawiono żądania i odpowiedzi przy użyciu poprzedniego kodu.

Zażądaj Odpowiedź
/ Hello from the non-Map delegate.
/map1/segment1 Processing '/map1/segment1'

Map obsługuje zagnieżdżanie:

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Map("/level1", level1App => {
    level1App.Map("/level2a", level2AApp => {
        level2AApp.Run(async context =>
        {
            await context.Response.WriteAsync("Processing '/level1/level2a'");
        });
    });
    level1App.Map("/level2b", level2BApp => {
        level2BApp.Run(async context =>
        {
            await context.Response.WriteAsync("Processing '/level1/level2b'");
        });
    });
});

app.Run(async context =>
{
    await context.Response.WriteAsync("Hello from the non-Map delegate!");
});

app.Run();

W poniższej tabeli przedstawiono żądania i odpowiedzi przy użyciu poprzedniego kodu.

Zażądaj Odpowiedź
/ Hello from the non-Map delegate.
/level1/level2a Processing '/level1/level2a'
/level1/level2b Processing '/level1/level2b'

MapWhen rozgałęzia potok żądań na podstawie wyniku danego predykatu. Dowolny predykat typu Func<HttpContext, bool> może zostać użyty do mapowania żądań na nową gałąź potoku. W poniższym przykładzie predykat służy do wykrywania obecności zmiennej ciągu zapytania o nazwie "branch":

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapWhen(context => context.Request.Query.ContainsKey("branch"), HandleBranch);

app.Run(async context =>
{
    await context.Response.WriteAsync("Hello from the non-Map delegate.");
});

app.Run();

private static void HandleBranch(IApplicationBuilder app)
{
    app.Run(async context =>
    {
        var branchVer = context.Request.Query["branch"];
        await context.Response.WriteAsync($"Branch used = '{branchVer}'");
    });
}

W poniższej tabeli przedstawiono żądania i odpowiedzi przy użyciu poprzedniego kodu.

Zażądaj Odpowiedź
/ Hello from the non-Map delegate.
/?branch=main Branch used = 'main'

UseWhen może rozgałęzić potok żądania na podstawie wyniku danego predykatu. W przeciwieństwie do MapWhen, gałąź jest ponownie dołączona do głównego pipeline'u, jeśli nie zawiera terminalnego middleware.

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.UseWhen(context => context.Request.Query.ContainsKey("branch"),
    appBuilder => HandleBranchAndRejoin(appBuilder));

app.Run(async context =>
{
    await context.Response.WriteAsync("Hello from the non-Map delegate.");
});

app.Run();

void HandleBranchAndRejoin(IApplicationBuilder app)
{
    var logger = app.ApplicationServices.GetRequiredService<ILogger<Program>>();

    app.Use(async (context, next) =>
    {
        var branchVer = context.Request.Query["branch"];
        logger.LogInformation("Branch used = {branchVer}", branchVer.ToString());

        Console.WriteLine("Work that can write to the response.");
        await next.Invoke(context);
        Console.WriteLine("Work that doesn't write to the response.");
    });
}

W poprzednim przykładzie odpowiedź "Hello from the non-Map delegate." jest zapisywana dla wszystkich żądań. Jeśli żądanie zawiera zmienną ciągu zapytania o nazwie "branch", jej wartość jest zapisywana przed ponownym wejściem do głównego potoku.

Utwórz potok oprogramowania pośredniczącego za pomocą IApplicationBuilder

Potok przetwarzania żądań w ASP.NET Core składa się z sekwencji delegatów żądań, wywoływanych jeden po drugim. Na poniższym diagramie przedstawiono tę koncepcję. Przebieg wykonywania przebiega zgodnie z czarnymi strzałkami.

Wzorzec przetwarzania żądań przedstawiający nadejście żądania, jego przetwarzanie przez trzy komponenty pośredniczące oraz odpowiedź opuszczającą aplikację. Każdy komponent pośredniczący wykonuje swoją logikę i przekazuje żądanie do następnego komponentu pośredniczącego w instrukcji next(). Po przetworzeniu żądania przez trzeci komponent pośredniczący żądanie przechodzi z powrotem przez dwa poprzednie komponenty pośredniczące w odwrotnej kolejności w celu dodatkowego przetwarzania po ich instrukcjach next(), zanim opuści aplikację jako odpowiedź dla klienta.

Każdy delegat może wykonywać operacje przed następnym delegatem i po nim. Delegaci obsługujący wyjątki powinni być wywoływani na wczesnym etapie w potoku, aby mogli przechwytywać wyjątki występujące w późniejszych etapach potoku.

Najprostsza możliwa aplikacja platformy ASP.NET Core konfiguruje jednego delegata żądania, który obsługuje wszystkie żądania. Ta sytuacja nie obejmuje rzeczywistego potoku przetwarzania żądania. Zamiast tego w odpowiedzi na każde żądanie HTTP jest wywoływana jedna funkcja anonimowa.

public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
            await context.Response.WriteAsync("Hello, World!");
        });
    }
}

Połącz wiele delegatów żądań razem za pomocą funkcji Use. Parametr next reprezentuje następnego delegata w potoku. Można przerwać przepływ danych, nie wywołując parametru next. Zazwyczaj można wykonywać akcje zarówno przed następnym delegatem, jak i po nim, jak pokazano w poniższym przykładzie:

app.Use(async (context, next) =>
{
    // Do work that doesn't write to the Response.
    await next.Invoke();
    // Do logging or other work that doesn't write to the Response.
});

Gdy delegat nie przekazuje żądania do następnego delegata, jest to nazywane przerywaniem potoku żądania. Krótkie zwarcie jest często pożądane, ponieważ pozwala uniknąć niepotrzebnej pracy. Na przykład oprogramowanie pośredniczące obsługujące pliki statyczne może działać jako terminalowe oprogramowanie pośredniczące, przetwarzając żądanie dotyczące pliku statycznego i pomijając pozostałą część potoku. Oprogramowanie pośredniczące dodane do potoku przed oprogramowaniem pośredniczącym, które przerywa dalsze przetwarzanie, nadal przetwarza kod po instrukcjach next.Invoke. Niemniej jednak, zapoznaj się z następującym ostrzeżeniem dotyczącym próby zapisania w odpowiedzi, która została już wysłana.

Ostrzeżenie

Nie wywołuj elementu next.Invoke po tym, jak odpowiedź została wysłana do klienta. Zmiany wprowadzone w składniku HttpResponse po rozpoczęciu odpowiedzi zgłaszają wyjątek. Na przykład ustawienie nagłówków i kodu stanu powoduje zgłoszenie wyjątku. Zapisywanie w treści odpowiedzi po wywołaniu komponentu next:

  • Może spowodować naruszenie protokołu. Na przykład zapisanie dłuższej treści niż określona wartość Content-Length.
  • Może uszkodzić format ciała. Na przykład zapisanie stopki HTML do pliku CSS.

HasStarted jest przydatną wskazówką wskazującą, czy nagłówki zostały wysłane, czy zapisano dane w treści.

Run delegaci nie otrzymują parametru next . Pierwszy delegat Run jest zawsze końcowy i kończy potok. Run jest konwencją. Niektóre składniki oprogramowania pośredniczącego mogą uwidaczniać metody Run[Middleware] uruchamiane na końcu potoku:

app.Run(async context =>
{
    await context.Response.WriteAsync("Hello from 2nd delegate.");
});

W poprzednim przykładzie delegat Run zapisuje "Hello from 2nd delegate." w odpowiedzi, a następnie przerywa potok. Jeśli inny delegat Use lub Run zostanie dodany po delegacie Run, nie będzie on wywoływany.

Rozgałęzianie kanału oprogramowania pośredniego

Map rozszerzenia są używane jako konwencja rozgałęziania potoku. Map rozgałęzia potok przetwarzania żądania na podstawie dopasowania do podanej ścieżki żądania. Jeśli ścieżka żądania rozpoczyna się od podanej ścieżki, gałąź zostanie wykonana.

public class Startup
{
    private static void HandleMapTest1(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
            await context.Response.WriteAsync("Map Test 1");
        });
    }

    private static void HandleMapTest2(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
            await context.Response.WriteAsync("Map Test 2");
        });
    }

    public void Configure(IApplicationBuilder app)
    {
        app.Map("/map1", HandleMapTest1);

        app.Map("/map2", HandleMapTest2);

        app.Run(async context =>
        {
            await context.Response.WriteAsync("Hello from non-Map delegate.");
        });
    }
}

W poniższej tabeli przedstawiono żądania i odpowiedzi z adresu http://localhost:1234 przy użyciu poprzedniego kodu.

Zażądaj Odpowiedź
localhost:1234 Witaj od delegata nie-Mapy.
localhost:1234/map1 Test mapy 1
localhost:1234/map2 Test mapy 2
localhost:1234/map3 Witaj od delegata nie-Mapy.

Gdy jest używany składnik Map, dopasowane segmenty ścieżki są usuwane ze składnika HttpRequest.Path i dołączane do składnika HttpRequest.PathBase dla każdego żądania.

Map obsługuje zagnieżdżanie, na przykład:

app.Map("/level1", level1App => {
    level1App.Map("/level2a", level2AApp => {
        // "/level1/level2a" processing
    });
    level1App.Map("/level2b", level2BApp => {
        // "/level1/level2b" processing
    });
});

Map może również pasować do wielu segmentów jednocześnie:

public class Startup
{
    private static void HandleMultiSeg(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
            await context.Response.WriteAsync("Map multiple segments.");
        });
    }

    public void Configure(IApplicationBuilder app)
    {
        app.Map("/map1/seg1", HandleMultiSeg);

        app.Run(async context =>
        {
            await context.Response.WriteAsync("Hello from non-Map delegate.");
        });
    }
}

MapWhen rozgałęzia potok żądań na podstawie wyniku podanego predykatu. Możesz użyć dowolnego predykatu typu Func<HttpContext, bool>, aby kierować żądania do nowej gałęzi potoku. W poniższym przykładzie predykat wykrywa obecność zmiennej branchciągu zapytania:

public class Startup
{
    private static void HandleBranch(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
            var branchVer = context.Request.Query["branch"];
            await context.Response.WriteAsync($"Branch used = {branchVer}");
        });
    }

    public void Configure(IApplicationBuilder app)
    {
        app.MapWhen(context => context.Request.Query.ContainsKey("branch"),
                               HandleBranch);

        app.Run(async context =>
        {
            await context.Response.WriteAsync("Hello from non-Map delegate.");
        });
    }
}

W poniższej tabeli przedstawiono żądania i odpowiedzi z adresu http://localhost:1234 przy użyciu poprzedniego kodu.

Zażądaj Odpowiedź
localhost:1234 Witaj od delegata nie-Mapy.
localhost:1234/?branch=main Używana gałąź = main

UseWhen ponadto rozgałęzia potok żądania na podstawie wyniku danego predykatu. W przeciwieństwie do MapWhen, ta gałąź jest ponownie dołączana do głównego potoku, jeśli nie przerywa działania ani nie zawiera końcowego oprogramowania pośredniczącego.

public class Startup
{
    private void HandleBranchAndRejoin(IApplicationBuilder app, ILogger<Startup> logger)
    {
        app.Use(async (context, next) =>
        {
            var branchVer = context.Request.Query["branch"];
            logger.LogInformation("Branch used = {branchVer}", branchVer.ToString());

            // Do work that doesn't write to the Response.
            await next();
            // Do other work that doesn't write to the Response.
        });
    }

    public void Configure(IApplicationBuilder app, ILogger<Startup> logger)
    {
        app.UseWhen(context => context.Request.Query.ContainsKey("branch"),
                               appBuilder => HandleBranchAndRejoin(appBuilder, logger));

        app.Run(async context =>
        {
            await context.Response.WriteAsync("Hello from main pipeline.");
        });
    }
}

W poprzednim przykładzie dla wszystkich żądań jest pisana odpowiedź „Hello from main pipeline” (Pozdrowienia od głównego potoku). Jeśli żądanie zawiera zmienną parametru zapytania branch, jego wartość jest rejestrowana przed ponownym dołączeniem do potoku głównego.

Oprogramowanie pośredniczące dodane automatycznie przez WebApplication

WebApplicationprogram automatycznie dodaje następujące oprogramowanie pośredniczące w aplikacjach ASP.NET Core w zależności od określonych warunków:

  • UseDeveloperExceptionPage element jest dodawany jako pierwszy, gdy parametr ma wartość HostingEnvironment"Development".
  • Dodawany jest jako drugi, jeśli kod użytkownika jeszcze nie wywołał UseRouting i jeśli skonfigurowane są punkty końcowe, na przykład UseRouting.
  • UseEndpoints Jest dodawany na końcu potoku oprogramowania pośredniczącego, jeśli są skonfigurowane jakiekolwiek punkty końcowe.
  • UseAuthentication jest dodawany natychmiast po UseRouting, jeśli kod użytkownika nie wywołał jeszcze UseAuthentication, a IAuthenticationSchemeProvider można wykryć u dostawcy usług. IAuthenticationSchemeProvider jest domyślnie dodawany podczas korzystania z AddAuthentication, a usługi są wykrywane przy użyciu IServiceProviderIsService.
  • UseAuthorization jest dodawany później, jeśli kod użytkownika nie wywołał jeszcze UseAuthorization i jeśli IAuthorizationHandlerProvider można wykryć u dostawcy usług. IAuthorizationHandlerProvider jest domyślnie dodawany podczas korzystania z AddAuthorization, a usługi są wykrywane przy użyciu IServiceProviderIsService.
  • Oprogramowanie pośredniczące skonfigurowane przez użytkownika i punkty końcowe są dodawane między elementami UseRouting i UseEndpoints.

Poniższy kod jest w rzeczywistości tym, co tworzy automatyczne oprogramowanie pośredniczące dodawane do aplikacji:

if (isDevelopment)
{
    app.UseDeveloperExceptionPage();
}

app.UseRouting();

if (isAuthenticationConfigured)
{
    app.UseAuthentication();
}

if (isAuthorizationConfigured)
{
    app.UseAuthorization();
}

// user middleware/endpoints
app.CustomMiddleware(...);
app.MapGet("/", () => "hello world");
// end user middleware/endpoints

app.UseEndpoints(e => {});

W niektórych przypadkach domyślna konfiguracja oprogramowania pośredniczącego nie jest poprawna dla aplikacji i wymaga modyfikacji. Na przykład UseCors należy wywołać przed UseAuthentication i UseAuthorization. Aplikacja musi wywołać UseAuthentication i UseAuthorization, jeśli zostanie wywołane UseCors:

app.UseCors();
app.UseAuthentication();
app.UseAuthorization();

Jeśli oprogramowanie pośredniczące ma być uruchamiane przed rozpoczęciem dopasowywania tras, należy wywołać UseRouting, a oprogramowanie pośredniczące umieścić przed wywołaniem UseRouting. UseEndpoints nie jest wymagany w tym przypadku, ponieważ jest automatycznie dodawany zgodnie z wcześniejszym opisem:

app.Use((context, next) =>
{
    return next(context);
});

app.UseRouting();

// other middleware and endpoints

Podczas dodawania dodatkowego oprogramowania warstwy pośredniej dla terminalu:

  • Oprogramowanie pośredniczące musi zostać dodane po UseEndpoints.
  • Aplikacja musi wywołać UseRouting i UseEndpoints, aby middleware terminala można było umieścić we właściwym miejscu.
app.UseRouting();

app.MapGet("/", () => "hello world");

app.UseEndpoints(e => {});

app.Run(context =>
{
    context.Response.StatusCode = 404;
    return Task.CompletedTask;
});

Oprogramowanie pośredniczące terminala to oprogramowanie pośredniczące uruchamiane, jeśli żaden punkt końcowy nie obsługuje żądania.

Aplikacja internetowa automatycznie dodaje następujące oprogramowanie pośredniczące w aplikacjach ASP.NET Core w zależności od określonych warunków:

  • UseDeveloperExceptionPage jest dodawany jako pierwszy, gdy HostingEnvironment to "Development".

  • UseRouting jest dodawany jako drugi, jeśli kod użytkownika jeszcze nie wywołał UseRouting, a punkty końcowe zostały skonfigurowane, na przykład app.MapGet.

  • UseEndpoints jest dodawane na końcu potoku middleware, jeśli endpointy są skonfigurowane.

  • Funkcja UseAuthentication jest dodawana natychmiast po UseRouting wywołaniu, jeśli kod użytkownika nie wywołał jeszcze funkcji UseAuthentication i jeśli IAuthenticationSchemeProvider można wykryć w dostawcy usług. IAuthenticationSchemeProvider Jest dodawany domyślnie podczas korzystania z funkcji AddAuthentication, a usługi są wykrywane przy użyciu interfejsu IServiceProviderIsService.

  • Funkcja UseAuthorization zostanie dodana w następnej kolejności, jeśli kod użytkownika nie został jeszcze wywołany UseAuthorization i jeśli element IAuthorizationHandlerProvider może zostać wykryty u dostawcy usług. IAuthorizationHandlerProvider Jest dodawany domyślnie podczas korzystania z funkcji AddAuthorization, a usługi są wykrywane przy użyciu polecenia IServiceProviderIsService.

  • Oprogramowanie pośredniczące skonfigurowane przez użytkownika i punkty końcowe są dodawane między elementami UseRouting i UseEndpoints.

Poniższy kod jest w rzeczywistości tym, co tworzy automatyczne oprogramowanie pośredniczące dodawane do aplikacji:

if (isDevelopment)
{
    app.UseDeveloperExceptionPage();
}

app.UseRouting();

if (isAuthenticationConfigured)
{
    app.UseAuthentication();
}

if (isAuthorizationConfigured)
{
    app.UseAuthorization();
}

// User middleware/endpoints
app.CustomMiddleware(...);
app.MapGet("/", () => "hello world");
// End user middleware/endpoints

app.UseEndpoints(e => {});

W niektórych przypadkach domyślna konfiguracja oprogramowania pośredniczącego nie jest poprawna dla aplikacji i wymaga modyfikacji. Na przykład UseCors należy wywołać przed UseAuthentication i UseAuthorization. Aplikacja musi wywołać UseAuthentication i UseAuthorization, jeśli zostanie wywołane UseCors:

app.UseCors();
app.UseAuthentication();
app.UseAuthorization();

Jeśli oprogramowanie pośredniczące ma zostać uruchomione przed dopasowaniem tras, należy wywołać UseRouting i umieścić oprogramowanie pośredniczące przed wywołaniem UseRouting. UseEndpoints w tym przypadku nie jest wymagane, ponieważ jest on automatycznie dodawany zgodnie z wcześniejszym opisem:

app.Use((context, next) =>
{
    return next(context);
});

app.UseRouting();

// Other middleware and endpoints

Podczas dodawania dodatkowego oprogramowania warstwy pośredniej dla terminalu:

  • Oprogramowanie pośredniczące musi zostać dodane po UseEndpoints.

  • Aplikacja musi wywołać metody UseRouting i UseEndpoints, aby middleware terminalu mógł być umieszczony w odpowiedniej lokalizacji.

app.UseRouting();

app.MapGet("/", () => "hello world");

app.UseEndpoints(e => {});

app.Run(context =>
{
    context.Response.StatusCode = 404;
    return Task.CompletedTask;
});

Oprogramowanie pośredniczące terminala to oprogramowanie pośredniczące uruchamiane, jeśli żaden punkt końcowy nie obsługuje żądania.

Aby uzyskać informacje na temat oprogramowania pośredniczącego chroniącego przed fałszerstwem w minimalnych interfejsach API, zobacz Zapobiegaj atakom fałszerstw żądań między witrynami (XSRF/CSRF) w ASP.NET Core.

Kolejność oprogramowania pośredniczącego

Kolejność, w jakiej oprogramowanie pośredniczące pojawia się w pliku aplikacji Program, definiuje kolejność, w jakiej oprogramowanie pośredniczące jest wywoływane przy żądaniu, w odwrotnej kolejności dla odpowiedzi.

Masz pełną kontrolę nad kolejnością oprogramowania pośredniczącego i możliwością dodawania niestandardowego oprogramowania pośredniczącego w scenariuszach przetwarzania żądań, mając na uwadze, że kolejność oprogramowania pośredniczącego może mieć kluczowe znaczenie dla bezpieczeństwa, wydajności i funkcjonalności.

W poniższych przykładach pokazano kolejność oprogramowania pośredniczącego dla typowych scenariuszy aplikacji. Każda metoda rozszerzająca middleware WebApplicationBuilder jest dostępna w ramach przestrzeni nazw Microsoft.AspNetCore.Builder.

  1. Obsługa wyjątków i błędów
    • Gdy aplikacja działa w Development środowisku:
      • Oprogramowanie pośredniczące strony wyjątków dla deweloperów (UseDeveloperExceptionPage) raportuje błędy środowiska uruchomieniowego aplikacji.
      • Middleware strony błędu bazy danych (UseDatabaseErrorPage) raportuje błędy środowiska uruchomieniowego bazy danych.
    • Gdy aplikacja działa w Production środowisku:
      • Oprogramowanie pośredniczące programu obsługi wyjątków (UseExceptionHandler) przechwytuje wyjątki zgłaszane w następujących programach pośredniczącech.
      • Oprogramowanie pośrednie protokołu HTTP Strict Transport Security (HSTS) (UseHsts) dodaje nagłówek Strict-Transport-Security.
  2. Oprogramowanie pośredniczące przekierowania HTTPS (UseHttpsRedirection) przekierowuje żądania HTTP do protokołu HTTPS.
  3. Oprogramowanie pośredniczące obsługujące pliki statyczne (jeśli jest wymagane, UseStaticFiles) zwraca pliki statyczne i przerywa dalsze przetwarzanie żądania.
  4. Cookie middleware zasad (UseCookiePolicy) dostosowuje aplikację do unijnego ogólnego rozporządzenia o ochronie danych (RODO).
  5. Routing oprogramowania pośredniczącego (UseRouting) do kierowania żądań.
  6. Oprogramowanie pośredniczące uwierzytelniania (UseAuthentication) próbuje uwierzytelnić użytkownika przed zezwoleniem na dostęp do bezpiecznych zasobów.
  7. Oprogramowanie pośredniczące autoryzacji (UseAuthorization) autoryzuje użytkownika do uzyskiwania dostępu do bezpiecznych zasobów.
  8. Oprogramowanie pośredniczące zapobiegające fałszerstwom (UseAntiforgery) dodaje oprogramowanie pośredniczące zapobiegające fałszerstwom do potoku przetwarzania. Element UseAntiforgery musi zostać umieszczony po wywołaniach metod UseAuthentication i UseAuthorization.
  9. Oprogramowanie pośredniczące sesji (Razor tylko UseSessionstrony i MVC) ustanawia i utrzymuje stan sesji. Jeśli aplikacja używa stanu sesji, wywołaj oprogramowanie pośredniczące sesji po cookie oprogramowanie pośredniczące zasad i przed Razor oprogramowaniem pośredniczącym Pages/MVC.
  10. Oprogramowanie pośrednie trasowania punktów końcowych
  • MapRazorComponents aby dodać Razor punkty końcowe składników do potoku przetwarzania żądań.
  • MapRazorPages w celu dodania Razor punktów końcowych stron do potoku żądania.
  • MapControllerRoute aby dodać punkty końcowe kontrolera do potoku żądania.

Typowy Blazor Web App potok oprogramowania pośredniczącego:

app.UseWebAssemblyDebugging(); // Development environment with client-side rendering
app.UseMigrationsEndPoint(); // Development environment with ASP.NET Core Identity

app.UseExceptionHandler("/Error", createScopeForErrors: true); // Non-Development environment
app.UseHsts(); // Non-Development environment with HTTPS protocol

app.UseStatusCodePagesWithReExecute("/not-found", createScopeForStatusCodePages: true);

app.UseHttpsRedirection(); // With HTTPS protocol

app.UseAntiforgery();

app.MapStaticAssets();

app.MapRazorComponents<App>(); // With additional extension methods for render modes

app.MapAdditionalIdentityEndpoints(); // With ASP.NET Core Identity

app.Run();

Typowy Razor potok pośredniej warstwy oprogramowania Pages/MVC:

app.UseMigrationsEndPoint(); // Development environment with ASP.NET Core Identity

app.UseExceptionHandler("/Error"); // Non-Development environment
app.UseHsts(); // Non-Development environment with HTTPS protocol

app.UseHttpsRedirection(); // With HTTPS protocol

// app.UseCookiePolicy();
app.UseRouting(); // If not called, runs at the beginning of the pipeline by default
// app.UseRateLimiter();
// app.UseRequestLocalization();
// app.UseCors();

// app.UseAuthentication(); // Called internally for ASP.NET Core Identity
app.UseAuthorization();
// app.UseSession();
// app.UseResponseCompression();
// app.UseResponseCaching();

app.MapStaticAssets();

app.MapControllerRoute(...); // For MVC controllers

app.MapRazorPages(); // For Razor Pages pages

app.MapControllers(); // With authentication in a Razor Pages app

app.Run();

W poprzednim kodzie:

  • Oprogramowanie pośredniczące CORS (UseCors), oprogramowanie pośredniczące uwierzytelniania (UseAuthentication) i oprogramowanie pośredniczące autoryzacji (UseAuthorization) musi być wyświetlane w podanej kolejności.
  • Oprogramowanie pośredniczące CORS (UseCors) musi znajdować się przed oprogramowaniem pośredniczącym buforującym odpowiedzi (UseResponseCaching), aby dodawać nagłówki CORS do każdego żądania, w tym do odpowiedzi buforowanych. Aby uzyskać więcej informacji, zobacz Nie jest jasne, czy UseCORS musi pojawić się przed UseResponseCaching (dotnet/aspnetcore #23218.
  • Składnik pośredniczący lokalizacji żądania (UseRequestLocalization) musi występować przed każdym składnikiem pośredniczącym, który może sprawdzać ustawienia kultury żądania, na przykład składnikiem pośredniczącym plików statycznych (UseStaticFiles).
  • Oprogramowanie pośredniczące ograniczające szybkość (UseRateLimiter) musi być wywoływane po routingu oprogramowania pośredniczącego (UseRouting), gdy są używane interfejsy API specyficzne dla punktu końcowego. Jeśli na przykład [EnableRateLimiting] jest używany atrybut, oprogramowanie pośredniczące ograniczające szybkość musi być wywoływane po routingu oprogramowania pośredniczącego. Jeśli wywoływane są tylko globalne ograniczniki, oprogramowanie pośredniczące do ograniczania szybkości może zostać wywołane przed oprogramowaniem pośredniczącym routingu.

W niektórych scenariuszach oprogramowanie pośredniczące ma inne określanie kolejności. Na przykład buforowanie i porządkowanie kompresji zależy od specyfikacji aplikacji. W następującej kolejności użycie procesora CPU może zostać zmniejszone przez buforowanie skompresowanej odpowiedzi, ale aplikacja może w końcu buforować wiele reprezentacji zasobu przy użyciu różnych algorytmów kompresji, takich jak Gzip lub Brotli:

app.UseResponseCaching();
app.UseResponseCompression();

Zasoby statyczne są zwykle dostarczane na wczesnym etapie przepływu, dzięki czemu aplikacja może skrócić przetwarzanie żądań w celu poprawy wydajności.

Uwierzytelnianie nie przerywa żądań nieuwierzytelnionych. Chociaż middleware uwierzytelniania uwierzytelnia żądania, autoryzacja następuje po wybraniu komponentu Razor w aplikacji Blazor Web App, strony w aplikacji Razor Pages lub kontrolera i akcji w aplikacji MVC.

Na poniższym diagramie przedstawiono kompletny potok przetwarzania żądania dla aplikacji MVC i Razor Pages na platformie ASP.NET Core. Można zobaczyć, jak w typowej aplikacji uporządkowane są istniejące middleware oraz gdzie dodaje się niestandardowe middleware. Masz pełną kontrolę nad tym, jak zmienić kolejność istniejących oprogramowań pośredniczących lub wstrzyknąć nowe niestandardowe oprogramowania pośredniczące odpowiednio do potrzeb w scenariuszach.

potok oprogramowania pośredniczącego ASP.NET Core

Oprogramowanie middlewarowe punktu końcowego na wcześniejszym diagramie wykonuje przepływ filtracyjny dla odpowiedniego typu aplikacji — MVC lub Razor Strony.

Powyższy diagram pokazuje oprogramowanie pośredniczące Routing po Static Files. Ta kolejność odzwierciedla sposób działania szablonów projektów dzięki jawnemu wywołaniu app.UseRouting. Jeśli nie wywołasz app.UseRouting, oprogramowanie pośredniczące Routing będzie domyślnie uruchamiane na początku procesu. Aby uzyskać więcej informacji, zobacz Routing.

Kolejność dodawania składników oprogramowania pośredniczącego Program.cs w pliku definiuje kolejność wywoływanych składników oprogramowania pośredniczącego na żądaniach i odwrotną kolejność odpowiedzi. Kolejność ma kluczowe znaczenie dla bezpieczeństwa, wydajności i funkcjonalności.

Poniższy wyróżniony kod w programie Program.cs dodaje składniki oprogramowania pośredniczącego związane z zabezpieczeniami w typowej zalecanej kolejności:

using Microsoft.AspNetCore.Identity;
using Microsoft.EntityFrameworkCore;
using WebMiddleware.Data;

var builder = WebApplication.CreateBuilder(args);

var connectionString = builder.Configuration.GetConnectionString("DefaultConnection")
    ?? throw new InvalidOperationException("Connection string 'DefaultConnection' not found.");
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(connectionString));
builder.Services.AddDatabaseDeveloperPageExceptionFilter();

builder.Services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<ApplicationDbContext>();
builder.Services.AddRazorPages();
builder.Services.AddControllersWithViews();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseMigrationsEndPoint();
}
else
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
// app.UseCookiePolicy();

app.UseRouting();
// app.UseRateLimiter();
// app.UseRequestLocalization();
// app.UseCors();

app.UseAuthentication();
app.UseAuthorization();
// app.UseSession();
// app.UseResponseCompression();
// app.UseResponseCaching();

app.MapRazorPages();
app.MapDefaultControllerRoute();

app.Run();

W poprzednim kodzie:

  • Zakomentowane oprogramowanie pośredniczące nie jest dodawane podczas tworzenia nowej aplikacji internetowej z indywidualnymi kontami użytkowników.
  • Nie każde oprogramowanie pośredniczące pojawia się w tej dokładnej kolejności, ale wiele tak. Na przykład:
    • UseCors, UseAuthentication i UseAuthorization muszą pojawić się w podanej kolejności.
    • UseCors obecnie musi pojawić się przed UseResponseCaching. To wymaganie zostało wyjaśnione w temacie Problem #23218 dotyczący dotnet/aspnetcore w serwisie GitHub.
    • UseRequestLocalization musi pojawić się przed wszelkim oprogramowaniem pośredniczącym, które może sprawdzać kulturę żądania, na przykład app.UseStaticFiles().
    • UseRateLimiter należy wywołać po UseRouting, gdy są używane interfejsy API specyficzne dla punktów końcowych z ograniczaniem szybkości. Na przykład, jeśli używany jest atrybut [EnableRateLimiting], UseRateLimiter musi być wywołany po UseRouting. Podczas wywoływania tylko globalnych ograniczników, UseRateLimiter można wywołać przed UseRouting.

W niektórych scenariuszach oprogramowanie pośredniczące ma inne określanie kolejności. Na przykład określanie kolejności buforowania i kompresji jest specyficzne dla scenariusza i istnieje wiele prawidłowych określeń kolejności. Na przykład:

app.UseResponseCaching();
app.UseResponseCompression();

Dzięki powyższemu kodowi można zmniejszyć użycie procesora dzięki buforowaniu skompresowanej odpowiedzi, ale może to prowadzić do buforowania wielu reprezentacji zasobu z użyciem różnych algorytmów kompresji, takich jak Gzip lub Brotli.

Poniższe określanie kolejności łączy pliki statyczne w celu umożliwienia buforowania skompresowanych plików statycznych:

app.UseResponseCaching();
app.UseResponseCompression();
app.UseStaticFiles();

Poniższy kod Program.cs dodaje składniki oprogramowania pośredniczącego dla typowych scenariuszy aplikacji:

  1. Obsługa wyjątków i błędów
    • Gdy aplikacja działa w Development środowisku:
      • Oprogramowanie pośredniczące strony wyjątków dla deweloperów (UseDeveloperExceptionPage) raportuje błędy środowiska uruchomieniowego aplikacji.
      • Middleware strony błędu bazy danych (UseDatabaseErrorPage) raportuje błędy środowiska uruchomieniowego bazy danych.
    • Gdy aplikacja działa w Production środowisku:
      • Oprogramowanie pośredniczące programu obsługi wyjątków (UseExceptionHandler) przechwytuje wyjątki zgłaszane w następujących programach pośredniczącech.
      • Oprogramowanie pośrednie protokołu HTTP Strict Transport Security (HSTS) (UseHsts) dodaje nagłówek Strict-Transport-Security.
  2. Oprogramowanie pośredniczące przekierowania HTTPS (UseHttpsRedirection) przekierowuje żądania HTTP do protokołu HTTPS.
  3. Oprogramowanie pośredniczące obsługujące pliki statyczne (UseStaticFiles) udostępnia pliki statyczne i przerywa dalsze przetwarzanie żądań.
  4. Cookie middleware zasad (UseCookiePolicy) zapewnia zgodność aplikacji z przepisami unijnego ogólnego rozporządzenia o ochronie danych (RODO).
  5. Routing oprogramowania pośredniczącego (UseRouting) do kierowania żądań.
  6. Oprogramowanie pośredniczące uwierzytelniania (UseAuthentication) próbuje uwierzytelnić użytkownika przed zezwoleniem na dostęp do bezpiecznych zasobów.
  7. Oprogramowanie pośredniczące autoryzacji (UseAuthorization) autoryzuje użytkownika do uzyskiwania dostępu do bezpiecznych zasobów.
  8. Oprogramowanie pośredniczące sesji (UseSession) ustanawia i utrzymuje stan sesji. Jeśli aplikacja używa stanu sesji, wywołaj oprogramowanie pośredniczące sesji po cookie oprogramowanie pośredniczące zasad i przed oprogramowaniem pośredniczącym MVC.
  9. Oprogramowanie pośredniczące routingu punktów końcowych (UseEndpoints z MapRazorPages) służące do dodawania punktów końcowych stron Razor do potoku przetwarzania żądań.
if (env.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
    app.UseDatabaseErrorPage();
}
else
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseCookiePolicy();
app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();
app.UseSession();
app.MapRazorPages();

W poprzednim kodzie przykładowym każda metoda rozszerzenia oprogramowania pośredniczącego jest uwidoczniona w składniku WebApplicationBuilder za pośrednictwem przestrzeni nazw Microsoft.AspNetCore.Builder.

UseExceptionHandler jest pierwszym składnikiem oprogramowania pośredniczącego dodanym do potoku. W związku z tym pośrednik obsługi wyjątków przechwytuje wszelkie wyjątki pojawiające się podczas kolejnych wywołań.

Middleware plików statycznych jest wywoływane na początku potoku przetwarzania, dzięki czemu może obsługiwać żądania i zakończyć przetwarzanie bez przechodzenia przez pozostałe komponenty. Oprogramowanie pośredniczące obsługujące pliki statyczne nie zapewnia kontroli autoryzacji. Wszystkie pliki udostępniane przez oprogramowanie pośredniczące do obsługi plików statycznych, w tym pliki w katalogu wwwroot, są publicznie dostępne. Aby uzyskać podejście do zabezpieczania plików statycznych, zobacz Obsługa plików statycznych w aplikacjach ASP.NET Core.

Jeśli żądanie nie zostanie obsłużone przez middleware plików statycznych, zostanie przekazane do middleware uwierzytelniania (UseAuthentication), które przeprowadza uwierzytelnianie. Uwierzytelnianie nie przerywa żądań nieuwierzytelnionych. Mimo że middleware uwierzytelniania uwierzytelnia żądania, autoryzacja (i odmowa dostępu) następuje dopiero po wybraniu konkretnej strony Razor lub kontrolera MVC oraz akcji.

W poniższym przykładzie pokazano kolejność oprogramowania pośredniczącego, w której żądania dotyczące plików statycznych są obsługiwane przez oprogramowanie pośredniczące plików statycznych przed oprogramowaniem pośredniczącym kompresji odpowiedzi. Pliki statyczne nie są kompresowane w ramach tej kolejności oprogramowania pośredniczącego. Odpowiedzi Razor Pages można skompresować.

// Static files aren't compressed by static file middleware.
app.UseStaticFiles();

app.UseRouting();

app.UseResponseCompression();

app.MapRazorPages();

Na poniższym diagramie przedstawiono kompletny potok przetwarzania żądania dla aplikacji MVC i Razor Pages na platformie ASP.NET Core. Można zobaczyć, jak w typowej aplikacji uporządkowane są istniejące middleware oraz gdzie dodaje się niestandardowe middleware. Masz pełną kontrolę nad tym, jak zmienić kolejność istniejących oprogramowań pośredniczących lub wstrzyknąć nowe niestandardowe oprogramowania pośredniczące odpowiednio do potrzeb w scenariuszach.

potok middleware ASP.NET Core

Oprogramowanie middlewarowe punktu końcowego na wcześniejszym diagramie wykonuje przepływ filtracyjny dla odpowiedniego typu aplikacji — MVC lub Razor Strony.

Powyższy diagram pokazuje oprogramowanie pośredniczące Routing po Static Files. Ta kolejność odzwierciedla sposób działania szablonów projektów dzięki jawnemu wywołaniu app.UseRouting. Jeśli nie wywołasz app.UseRouting, oprogramowanie pośredniczące Routing będzie domyślnie uruchamiane na początku procesu. Aby uzyskać więcej informacji, zobacz Routing.

Kolejność dodawania składników oprogramowania pośredniczącego Program.cs w pliku definiuje kolejność wywoływanych składników oprogramowania pośredniczącego na żądaniach i odwrotną kolejność odpowiedzi. Kolejność ma kluczowe znaczenie dla bezpieczeństwa, wydajności i funkcjonalności.

Poniższy wyróżniony kod w programie Program.cs dodaje składniki oprogramowania pośredniczącego związane z zabezpieczeniami w typowej zalecanej kolejności:

using IndividualAccountsExample.Data;
using Microsoft.AspNetCore.Identity;
using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(connectionString));
builder.Services.AddDatabaseDeveloperPageExceptionFilter();

builder.Services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<ApplicationDbContext>();
builder.Services.AddRazorPages();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseMigrationsEndPoint();
}
else
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
// app.UseCookiePolicy();

app.UseRouting();
// app.UseRequestLocalization();
// app.UseCors();

app.UseAuthentication();
app.UseAuthorization();
// app.UseSession();
// app.UseResponseCompression();
// app.UseResponseCaching();

app.MapRazorPages();
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

W poprzednim kodzie:

  • Zakomentowane oprogramowanie pośredniczące nie jest dodawane podczas tworzenia nowej aplikacji internetowej z indywidualnymi kontami użytkowników.
  • Nie każde oprogramowanie pośredniczące pojawia się w tej dokładnej kolejności, ale wiele tak. Na przykład:
    • UseCors, UseAuthentication i UseAuthorization muszą pojawić się w podanej kolejności.
    • UseCors obecnie musi pojawić się przed UseResponseCaching. To wymaganie zostało wyjaśnione w temacie Problem #23218 dotyczący dotnet/aspnetcore w serwisie GitHub.
    • UseRequestLocalization musi pojawić się przed wszelkim oprogramowaniem pośredniczącym, które może sprawdzić kulturę żądania (na przykład app.UseMvcWithDefaultRoute()).

W niektórych scenariuszach oprogramowanie pośredniczące ma inne określanie kolejności. Na przykład określanie kolejności buforowania i kompresji jest specyficzne dla scenariusza i istnieje wiele prawidłowych określeń kolejności. Na przykład:

app.UseResponseCaching();
app.UseResponseCompression();

Dzięki powyższemu kodowi można zmniejszyć użycie procesora dzięki buforowaniu skompresowanej odpowiedzi, ale może to prowadzić do buforowania wielu reprezentacji zasobu z użyciem różnych algorytmów kompresji, takich jak Gzip lub Brotli.

Poniższe określanie kolejności łączy pliki statyczne w celu umożliwienia buforowania skompresowanych plików statycznych:

app.UseResponseCaching();
app.UseResponseCompression();
app.UseStaticFiles();

Poniższy kod Program.cs dodaje składniki oprogramowania pośredniczącego dla typowych scenariuszy aplikacji:

  1. Obsługa wyjątków i błędów
    • Gdy aplikacja działa w Development środowisku:
      • Oprogramowanie pośredniczące strony wyjątków dla deweloperów (UseDeveloperExceptionPage) raportuje błędy środowiska uruchomieniowego aplikacji.
      • Middleware strony błędu bazy danych (UseDatabaseErrorPage) raportuje błędy środowiska uruchomieniowego bazy danych.
    • Gdy aplikacja działa w Production środowisku:
      • Oprogramowanie pośredniczące programu obsługi wyjątków (UseExceptionHandler) przechwytuje wyjątki zgłaszane w następujących programach pośredniczącech.
      • Oprogramowanie pośrednie protokołu HTTP Strict Transport Security (HSTS) (UseHsts) dodaje nagłówek Strict-Transport-Security.
  2. Oprogramowanie pośredniczące przekierowania HTTPS (UseHttpsRedirection) przekierowuje żądania HTTP do protokołu HTTPS.
  3. Oprogramowanie pośredniczące obsługujące pliki statyczne (UseStaticFiles) udostępnia pliki statyczne i przerywa dalsze przetwarzanie żądań.
  4. Cookie oprogramowanie pośredniczące zasad dotyczących plików cookie (UseCookiePolicy) zapewnia zgodność aplikacji z przepisami ogólnego rozporządzenia o ochronie danych (RODO).
  5. Routing oprogramowania pośredniczącego (UseRouting) do kierowania żądań.
  6. Oprogramowanie pośredniczące uwierzytelniania (UseAuthentication) próbuje uwierzytelnić użytkownika przed zezwoleniem na dostęp do bezpiecznych zasobów.
  7. Oprogramowanie pośredniczące autoryzacji (UseAuthorization) autoryzuje użytkownika do uzyskiwania dostępu do bezpiecznych zasobów.
  8. Oprogramowanie pośredniczące sesji (UseSession) ustanawia i utrzymuje stan sesji. Jeśli aplikacja używa stanu sesji, wywołaj oprogramowanie pośredniczące sesji po cookie oprogramowanie pośredniczące zasad i przed oprogramowaniem pośredniczącym MVC.
  9. Oprogramowanie pośredniczące routingu punktów końcowych (UseEndpoints z MapRazorPages) służące do dodawania punktów końcowych stron Razor do potoku przetwarzania żądań.
if (env.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
    app.UseDatabaseErrorPage();
}
else
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseCookiePolicy();
app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();
app.UseSession();
app.MapRazorPages();

W poprzednim kodzie przykładowym każda metoda rozszerzenia oprogramowania pośredniczącego jest uwidoczniona w składniku WebApplicationBuilder za pośrednictwem przestrzeni nazw Microsoft.AspNetCore.Builder.

UseExceptionHandler jest pierwszym składnikiem oprogramowania pośredniczącego dodanym do potoku. W związku z tym pośrednik obsługi wyjątków przechwytuje wszelkie wyjątki pojawiające się podczas kolejnych wywołań.

Middleware plików statycznych jest wywoływane na początku potoku przetwarzania, dzięki czemu może obsługiwać żądania i zakończyć przetwarzanie bez przechodzenia przez pozostałe komponenty. Oprogramowanie pośredniczące obsługujące pliki statyczne nie zapewnia kontroli autoryzacji. Wszystkie pliki udostępniane przez oprogramowanie pośredniczące do obsługi plików statycznych, w tym pliki w katalogu wwwroot, są publicznie dostępne. Aby uzyskać podejście do zabezpieczania plików statycznych, zobacz Obsługa plików statycznych w aplikacjach ASP.NET Core.

Jeśli żądanie nie zostanie obsłużone przez middleware plików statycznych, zostanie przekazane do middleware uwierzytelniania (UseAuthentication), które przeprowadza uwierzytelnianie. Uwierzytelnianie nie przerywa żądań nieuwierzytelnionych. Mimo że middleware uwierzytelniania uwierzytelnia żądania, autoryzacja (i odmowa dostępu) następuje dopiero po wybraniu konkretnej strony Razor lub kontrolera MVC oraz akcji.

W poniższym przykładzie pokazano kolejność oprogramowania pośredniczącego, w której żądania dotyczące plików statycznych są obsługiwane przez oprogramowanie pośredniczące plików statycznych przed oprogramowaniem pośredniczącym kompresji odpowiedzi. Pliki statyczne nie są kompresowane w ramach tej kolejności oprogramowania pośredniczącego. Odpowiedzi Razor Pages można skompresować.

// Static files aren't compressed by static file middleware.
app.UseStaticFiles();

app.UseRouting();

app.UseResponseCompression();

app.MapRazorPages();

Na poniższym diagramie przedstawiono kompletny potok przetwarzania żądania dla aplikacji MVC i Razor Pages na platformie ASP.NET Core. Można zobaczyć, jak w typowej aplikacji uporządkowane są istniejące middleware oraz gdzie dodaje się niestandardowe middleware. Masz pełną kontrolę nad tym, jak zmienić kolejność istniejących oprogramowań pośredniczących lub wstrzyknąć nowe niestandardowe oprogramowania pośredniczące odpowiednio do potrzeb w scenariuszach.

potok middleware ASP.NET Core

Oprogramowanie middlewarowe punktu końcowego na wcześniejszym diagramie wykonuje przepływ filtracyjny dla odpowiedniego typu aplikacji — MVC lub Razor Strony.

Kolejność dodawania składników oprogramowania pośredniczącego w metodzie Startup.Configure definiuje kolejność wywoływania składników oprogramowania pośredniczącego w żądaniach oraz odwrotną kolejność dla odpowiedzi. Kolejność ma kluczowe znaczenie dla bezpieczeństwa, wydajności i funkcjonalności.

Poniższa metoda Startup.Configure dodaje składniki oprogramowania pośredniczącego związane z zabezpieczeniami w typowej zalecanej kolejności:

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseDatabaseErrorPage();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();
    // app.UseCookiePolicy();

    app.UseRouting();
    // app.UseRequestLocalization();
    // app.UseCors();

    app.UseAuthentication();
    app.UseAuthorization();
    // app.UseSession();
    // app.UseResponseCompression();
    // app.UseResponseCaching();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapRazorPages();
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
}

W poprzednim kodzie:

  • Zakomentowane oprogramowanie pośredniczące nie jest dodawane podczas tworzenia nowej aplikacji internetowej z indywidualnymi kontami użytkowników.
  • Nie każde oprogramowanie pośredniczące pojawia się w tej dokładnej kolejności, ale wiele tak. Na przykład:
    • UseCors, UseAuthentication i UseAuthorization muszą pojawić się w podanej kolejności.
    • UseCors obecnie musi pojawić się przed UseResponseCaching z powodu tej usterki.
    • UseRequestLocalization musi pojawić się przed wszelkim oprogramowaniem pośredniczącym, które może sprawdzić kulturę żądania (na przykład app.UseMvcWithDefaultRoute()).

W niektórych scenariuszach oprogramowanie pośredniczące ma inne określanie kolejności. Na przykład określanie kolejności buforowania i kompresji jest specyficzne dla scenariusza i istnieje wiele prawidłowych określeń kolejności. Na przykład:

app.UseResponseCaching();
app.UseResponseCompression();

W poprzednim kodzie można oszczędzać zasoby procesora CPU przez buforowanie skompresowanej odpowiedzi, ale może to doprowadzić do buforowania wielu reprezentacji zasobu przy użyciu różnych algorytmów kompresji, takich jak Gzip lub Brotli.

Poniższe określanie kolejności łączy pliki statyczne w celu umożliwienia buforowania skompresowanych plików statycznych:

app.UseResponseCaching();
app.UseResponseCompression();
app.UseStaticFiles();

Poniższa metoda Startup.Configure dodaje składniki oprogramowania pośredniczącego dla typowych scenariuszy aplikacji:

  1. Obsługa wyjątków i błędów
    • Gdy aplikacja działa w Development środowisku:
      • Oprogramowanie pośredniczące strony wyjątków dla deweloperów (UseDeveloperExceptionPage) raportuje błędy środowiska uruchomieniowego aplikacji.
      • Oprogramowanie pośredniczące strony błędu bazy danych zgłasza błędy środowiska uruchomieniowego bazy danych.
    • Gdy aplikacja działa w Production środowisku:
      • Oprogramowanie pośredniczące programu obsługi wyjątków (UseExceptionHandler) przechwytuje wyjątki zgłaszane w następujących programach pośredniczącech.
      • Oprogramowanie pośrednie protokołu HTTP Strict Transport Security (HSTS) (UseHsts) dodaje nagłówek Strict-Transport-Security.
  2. Oprogramowanie pośredniczące przekierowania HTTPS (UseHttpsRedirection) przekierowuje żądania HTTP do protokołu HTTPS.
  3. Oprogramowanie pośredniczące obsługujące pliki statyczne (UseStaticFiles) udostępnia pliki statyczne i przerywa dalsze przetwarzanie żądań.
  4. Cookie oprogramowanie pośredniczące zasad (UseCookiePolicy) dostosowuje aplikację do przepisów ogólnego rozporządzenia o ochronie danych (RODO).
  5. Routing oprogramowania pośredniczącego (UseRouting) do kierowania żądań.
  6. Oprogramowanie pośredniczące uwierzytelniania (UseAuthentication) próbuje uwierzytelnić użytkownika przed zezwoleniem na dostęp do bezpiecznych zasobów.
  7. Oprogramowanie pośredniczące autoryzacji (UseAuthorization) autoryzuje użytkownika do uzyskiwania dostępu do bezpiecznych zasobów.
  8. Oprogramowanie pośredniczące sesji (UseSession) ustanawia i utrzymuje stan sesji. Jeśli aplikacja używa stanu sesji, wywołaj oprogramowanie pośredniczące sesji po cookie oprogramowanie pośredniczące zasad i przed oprogramowaniem pośredniczącym MVC.
  9. Oprogramowanie pośredniczące routingu punktów końcowych (UseEndpoints z MapRazorPages) służące do dodawania punktów końcowych stron Razor do potoku przetwarzania żądań.
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseDatabaseErrorPage();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();
    app.UseCookiePolicy();
    app.UseRouting();
    app.UseAuthentication();
    app.UseAuthorization();
    app.UseSession();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapRazorPages();
    });
}

W poprzednim kodzie przykładowym każda metoda rozszerzenia oprogramowania pośredniczącego jest uwidoczniona w składniku IApplicationBuilder za pośrednictwem przestrzeni nazw Microsoft.AspNetCore.Builder.

UseExceptionHandler jest pierwszym składnikiem oprogramowania pośredniczącego dodanym do potoku. W związku z tym pośrednik obsługi wyjątków przechwytuje wszelkie wyjątki pojawiające się podczas kolejnych wywołań.

Middleware plików statycznych jest wywoływane na początku potoku przetwarzania, dzięki czemu może obsługiwać żądania i zakończyć przetwarzanie bez przechodzenia przez pozostałe komponenty. Oprogramowanie pośredniczące obsługujące pliki statyczne nie zapewnia kontroli autoryzacji. Wszystkie pliki udostępniane przez oprogramowanie pośredniczące do obsługi plików statycznych, w tym pliki w katalogu wwwroot, są publicznie dostępne. Aby uzyskać podejście do zabezpieczania plików statycznych, zobacz Obsługa plików statycznych w aplikacjach ASP.NET Core.

Jeśli żądanie nie zostanie obsłużone przez middleware plików statycznych, zostanie przekazane do middleware uwierzytelniania (UseAuthentication), które przeprowadza uwierzytelnianie. Uwierzytelnianie nie przerywa żądań nieuwierzytelnionych. Mimo że middleware uwierzytelniania uwierzytelnia żądania, autoryzacja (i odmowa dostępu) następuje dopiero po wybraniu konkretnej strony Razor lub kontrolera MVC oraz akcji.

W poniższym przykładzie pokazano kolejność oprogramowania pośredniczącego, w której żądania dotyczące plików statycznych są obsługiwane przez oprogramowanie pośredniczące plików statycznych przed oprogramowaniem pośredniczącym kompresji odpowiedzi. Pliki statyczne nie są kompresowane w ramach tej kolejności oprogramowania pośredniczącego. Odpowiedzi Razor Pages można skompresować.

public void Configure(IApplicationBuilder app)
{
    // Static files aren't compressed by static file middleware.
    app.UseStaticFiles();

    app.UseRouting();

    app.UseResponseCompression();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapRazorPages();
    });
}

W przypadku aplikacji jednostronicowych (SPA) oprogramowanie pośredniczące aplikacji SPA UseSpaStaticFiles zwykle jest ostatnie w potoku oprogramowania pośredniczącego. Oprogramowanie pośredniczące aplikacji SPA pojawia się na końcu.

  • Aby umożliwić całemu innemu oprogramowaniu pośredniczącemu najpierw odpowiadać na pasujące żądania.
  • Aby umożliwić aplikacjom SPA z routingiem po stronie klienta działanie dla wszystkich tras, których aplikacja serwera nie rozpoznaje.

Aby uzyskać więcej szczegółowych informacji dotyczących aplikacji SPA, zobacz przewodniki dotyczące szablonów projektów React i Angular.

Aby uzyskać informacje o aplikacjach jednostronicowych, zobacz przewodniki dotyczące szablonów projektów React i Angular.

kolejność UseCors i UseStaticFiles

Aby uzyskać więcej informacji na temat zamawiania UseCors i UseStaticFiles, zobacz Włączanie międzyźródłowych żądań CORS w ASP.NET Core.

Kolejność oprogramowania pośredniczącego obsługującego przekazywane nagłówki

Uruchom oprogramowanie pośredniczące obsługujące przekazywane nagłówki przed innym oprogramowaniem pośredniczącym, aby mieć pewność, że oprogramowanie pośredniczące korzystające z informacji z przekazywanych nagłówków może używać wartości tych nagłówków przy przetwarzaniu. Aby uruchomić oprogramowanie pośredniczące przekazywanych nagłówków po oprogramowaniu pośredniczącym do diagnostyki i obsługi błędów, zobacz kolejność oprogramowania pośredniczącego przekazywanych nagłówków.

Wbudowane oprogramowanie pośredniczące

Najnowsza wersja ASP.NET Core zawiera następujące oprogramowanie pośredniczące. Kolumna stosu interfejsu użytkownika pokazuje typowy stos interfejsu użytkownika, w którym używane jest oprogramowanie pośredniczące: [Wszystkie, Blazor Web App (BWA), Razor Pages i MVC (RP/MVC)]. Kolumna Order (Zamówienie ) zawiera uwagi dotyczące umieszczania oprogramowania pośredniczącego w potoku przetwarzania żądań i w jakich warunkach oprogramowanie pośredniczące może zatrzymać przetwarzanie żądań. Gdy oprogramowanie pośredniczące przerywa potok przetwarzania żądania i uniemożliwia innemu oprogramowaniu pośredniczącemu dalsze przetwarzanie żądania, nazywane jest końcowym oprogramowaniem pośredniczącym. Aby uzyskać więcej informacji na temat zwarć, zobacz sekcję Tworzenie potoku oprogramowania pośredniczącego z sekcją WebApplication .

Oprogramowanie pośredniczące opis Stos interfejsu użytkownika Zamówienie
Antiforgery Zapewnia obsługę ochrony przed fałszowaniem żądań. Wszystko Po uwierzytelnieniu i autoryzacji przed punktami końcowymi.
Authentication Zapewnia obsługę uwierzytelniania. Wszystko Przed HttpContext.User wykonaniem tej operacji. Terminal dla wywołań zwrotnych OAuth.
Authorization Zapewnia obsługę autoryzacji. Wszystko Natychmiast po uwierzytelnieniu oprogramowania pośredniczącego.
Cookie Zasady Śledzi zgodę użytkowników na przechowywanie danych osobowych i wymusza minimalne standardy dla pól cookie, takie jak secure i SameSite. Wszystko Przed oprogramowaniem pośredniczącym, które wydaje pliki cookie. Przykłady: uwierzytelnianie, sesja, MVC (TempData).
CORS Konfiguruje współużytkowanie zasobów między źródłami. Wszystko Przed oprogramowaniem pośredniczącym korzystającym z mechanizmu CORS. UseCors musi występować przed UseResponseCaching. Aby uzyskać więcej informacji, zobacz Nie jest jasne, czy UseCORS musi pojawić się przed UseResponseCaching (dotnet/aspnetcore #23218.
Strona wyjątków dla deweloperów Generuje stronę z informacjami o błędzie przeznaczonymi tylko do użytku w Development środowisku. Wszystko Przed oprogramowaniem pośredniczącym, które generuje błędy. Szablony projektów automatycznie rejestrują to oprogramowanie pośredniczące jako pierwsze w potoku, gdy środowisko wynosi Development.
Diagnostyka Kilka oddzielnych oprogramowań pośredniczących, które udostępniają stronę wyjątków dla deweloperów, obsługę wyjątków, strony kodu stanu i domyślną stronę internetową dla nowych aplikacji. Wszystko Przed oprogramowaniem pośredniczącym, które generuje błędy. Terminal obsługujący wyjątki lub domyślną stronę internetową dla nowych aplikacji.
Przekazywane nagłówki Przekazuje nagłówki przesłane przez serwer proxy do bieżącego żądania. Wszystko Przed oprogramowaniem pośredniczącym, które pobiera zaktualizowane pola. Przykłady: schemat, host, adres IP klienta, metoda.
Kontrola kondycji Sprawdza kondycję aplikacji platformy ASP.NET Core i jej zależności, takie jak sprawdzanie dostępności bazy danych. Wszystko Zakończ, jeśli żądanie pasuje do punktu końcowego kontroli stanu zdrowia.
Propagacja nagłówków Propaguje nagłówki HTTP z żądania przychodzącego do wychodzących żądań klienta HTTP.
Wszystko
Rejestrowanie HTTP Rejestruje żądania i odpowiedzi HTTP. Wszystko Na początku łańcucha oprogramowania pośredniczącego.
Zastępowanie metody HTTP Zezwala przychodzącemu żądaniu POST na zastępowanie metody. Wszystko Przed użyciem oprogramowania pośredniczącego, które korzysta z zaktualizowanej metody.
Przekierowywanie HTTPS Przekierowuje wszystkie żądania HTTP do protokołu HTTPS. Wszystko Przed oprogramowaniem pośredniczącym korzystającym z adresu URL.
Http Strict Transport Security (HSTS) Oprogramowanie pośredniczące do zwiększania zabezpieczeń, które dodaje specjalny nagłówek odpowiedzi. Wszystko Przed wysłaniem odpowiedzi i po tym, jak oprogramowanie pośredniczące modyfikuje żądania. Przykłady: przekazane nagłówki, ponowne zapisywanie adresu URL.
MVC Przetwarza żądania przy użyciu MVC i stron Razor. RP/MVC Końcowy, jeśli żądanie jest zgodne z trasą.
OWIN Współdziałanie z aplikacjami, serwerami i oprogramowaniem pośredniczącym opartymi na OWIN. RP/MVC Terminal, jeśli oprogramowanie pośredniczące OWIN w pełni przetwarza żądanie.
Buforowanie danych wyjściowych Zapewnia obsługę buforowania odpowiedzi na podstawie konfiguracji. RP/MVC Przed użyciem oprogramowania pośredniczącego, które wymaga buforowania. UseRouting, UseCors, UseAuthentication i UseAuthorization muszą pojawić się przed UseOutputCache.
Buforowanie odpowiedzi Zapewnia obsługę buforowania odpowiedzi. To oprogramowanie pośredniczące wymaga udziału klienta w pracy. Użyj buforowania danych wyjściowych do pełnej kontroli serwera. RP/MVC Przed użyciem oprogramowania pośredniczącego, które wymaga buforowania. UseCors musi znajdować się przed UseResponseCaching. Buforowanie odpowiedzi nie jest zwykle korzystne dla aplikacji interfejsu użytkownika, takich jak Razor Strony, ponieważ przeglądarki zazwyczaj ustawiają nagłówki żądań, które uniemożliwiają buforowanie. Buforowanie odpowiedzi jest korzystne dla aplikacji interfejsu użytkownika.
Dekompresja żądań Zapewnia obsługę dekompresowania żądań. Wszystko Przed oprogramowaniem pośredniczącym, które odczytuje treść żądania.
Kompresja odpowiedzi Zapewnia obsługę kompresowania odpowiedzi. Wszystko Przed middleware, które wymaga kompresji.
Lokalizacja żądań Zapewnia obsługę lokalizacji. Wszystko Przed lokalizowaniem oprogramowanie pośredniczące o dużej czułości. Musi pojawić się po wysłaniu oprogramowania pośredniczącego w przypadku korzystania z programu RouteDataRequestCultureProvider.
Limity czasu żądania Zapewnia obsługę konfigurowania limitów czasu żądania, globalnych i poszczególnych punktów końcowych. Wszystko UseRequestTimeouts musi znajdować się po UseExceptionHandler, UseDeveloperExceptionPagei UseRouting.
Routing punktów końcowych. Definiuje i ogranicza trasy żądań. Wszystko Terminal do dopasowywania tras.
SPA Obsługuje wszystkie żądania z tego punktu w łańcuchu oprogramowania pośredniczącego, zwracając domyślną stronę aplikacji jednostronicowej (SPA). Wszystko Pojawia się późno w łańcuchu, więc inne middleware do serwowania plików statycznych, takich jak akcje MVC, ma pierwszeństwo.
Session Zapewnia obsługę zarządzania sesjami użytkowników. RP/MVC Przed oprogramowaniem pośredniczącym, które wymaga sesji.
Plik statyczny Zapewnia obsługę plików statycznych i przeglądania katalogów. Wszystko Zakończ, jeśli żądanie pasuje do pliku.
URL Rewrite Zapewnia obsługę ponownego zapisywania adresów URL i przekierowywania żądań. Wszystko Przed oprogramowaniem pośredniczącym korzystającym z adresu URL.
Rejestrowanie W3C Generuje dzienniki dostępu serwera w formacie rozszerzonego pliku dziennika W3C. Wszystko Na początku łańcucha oprogramowania pośredniczącego.
Blazor WebAssembly Debugowanie Debuguje Blazor Web App, które korzystają z renderowania po stronie klienta (CSR), w narzędziach deweloperskich Chromium. BWA Na początku łańcucha oprogramowania pośredniczącego.
WebSockets Włącza protokoły WebSocket. Wszystko Przed oprogramowaniem pośredniczącym wymaganym do akceptowania żądań protokołu WebSocket.