.NET Core: Unraveling Middleware Decoding

.NET Core

What is Middleware?

Middleware is integrated into an application pipeline to oversee the handling of requests and responses. Each component in the pipeline decides whether to pass the request to the next one. It has the capability to function both before and after the subsequent pipeline component. The request pipeline is assembled using request delegates, and each HTTP request is managed by these delegates.

In configuring request delegates, the Run, Map, and Use extension methods play a key role. A request delegate, which serves as an individual processing step, can be set up either in-line as an anonymous method (referred to as in-line middleware) or within a reusable class. These classes and in-line methods collectively form middleware components. Each middleware component within the request pipeline has the responsibility of either invoking the next component in the sequence or, in certain cases, halting the pipeline. When a middleware component halts the process, it earns the term "terminal middleware" as it effectively prevents subsequent middleware from further handling the request.


Understanding Middleware: Middleware, in the context of .NET Core, refers to software components that are assembled into the request processing pipeline to handle requests and responses. These components execute in a sequential order, providing a flexible mechanism to perform tasks such as authentication, authorization, logging, error handling, and more. Each middleware component has a specific responsibility and can modify the request or response as it passes through the pipeline.

Key Components and Functionality

  1. Authentication Middleware: One of the primary functions of middleware is handling authentication. .NET Core middleware allows developers to integrate authentication mechanisms seamlessly into the pipeline. This is crucial for ensuring that only authorized users can access protected resources.
  2. Authorization Middleware: Authorization middleware complements authentication by determining whether an authenticated user has the necessary permissions to perform a specific action or access certain resources. This layer adds an additional level of security to the application.
  3. Logging Middleware: Middleware can be employed for logging purposes, capturing valuable information about each request and response. This aids in diagnosing issues, monitoring application performance, and analyzing user behavior.
  4. Exception Handling Middleware: Errors and exceptions are inevitable in any application. Middleware facilitates the centralized handling of exceptions, ensuring that developers can implement custom error pages, log detailed error information, and maintain a consistent user experience.
  5. CORS Middleware: Cross-Origin Resource Sharing (CORS) is a security feature implemented by middleware to control which domains can access resources on a server. This is crucial for securing web applications and preventing unauthorized access.
  6. Compression Middleware: To enhance performance, middleware can be used to compress responses before they are sent to clients. This reduces the amount of data transferred over the network, resulting in faster load times for users.

Advantages of .NET Core Middleware

  1. Modularity and Reusability: Middleware promotes modularity by allowing developers to encapsulate specific functionality into reusable components. This modular approach simplifies code maintenance and promotes the reuse of middleware across different projects.
  2. Pipeline Customization: Developers have the flexibility to customize the request-response pipeline based on the specific requirements of their application. This adaptability is crucial for tailoring the application's behavior to meet unique business needs.
  3. Improved Testability: Middleware components can be unit-tested in isolation, promoting better testability and facilitating the adoption of test-driven development (TDD) practices. This ensures that each middleware component functions correctly and adheres to its intended behavior.
  4. Centralized Configuration: .NET Core middleware allows for centralized configuration, making it easier to manage and modify the behavior of various components. This simplifies the task of adjusting application settings without the need to modify code.

Is Middleware Ordering Important?

Yes, in ASP.NET Core, the order in which middleware components are added to the pipeline is significant. Middleware components are executed in the order they are added to the pipeline. This means that the order of middleware registration affects the order of their execution during the request processing pipeline.

The order is important because each middleware component might modify the request or response, and the order in which they are executed can impact the final outcome. For example, if you have authentication middleware, it should be executed before other middleware that relies on authenticated user information.

Keep in mind that some middleware components are order-sensitive, while others may not be. Always check the documentation for specific middleware to understand any ordering requirements or recommendations.

Middleware Ordering

Referred in this article.

Actual Process of Middleware

In the given scenario, a client-initiated a request from the 'https://d.domain.com' origin to access an endpoint within a service. However, before processing the request, the middleware responsible for validating Cross-Origin Resource Sharing (CORS) policies intervened. After inspecting the request, the CORS middleware determined that it did not comply with the defined policies and, as a result, rejected the request. 

"Access to XMLHttpRequest at 'https://a-push.domain.com/notifyhub/negotiate' from origin 'https://d.domain.com' has been blocked by CORS policy: Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource."

Middleware Processing

Middleware Short-Circuiting

Short-circuiting is the process of stopping the execution of the middleware components in the pipeline and skipping the rest of them based on a specific condition. This is often done to improve performance or handle a particular situation without going through the middleware pipeline completely. For example, you might have a middleware component that checks for a specific condition and, if the condition is met, immediately returns a response. In this example, the middleware handles a request and generates a response without calling the other middleware components.

Middleware Short-Circuiting


Short-circuitry should be applied with caution as it may interfere with the execution sequence and the intended behavior of the application. It is essential to always take into account the particular requirements and potential adverse effects when making a decision to interrupt a middleware pipeline.

Middleware Configuration: Understanding the Map, Use, and Run Methods

ASP.NET Core middleware provides a flexible way to handle requests and responses in the application pipeline. Three key methods, Map, Use and Run, play a crucial role in configuring middleware components. Let's explore each of these methods and understand how they contribute to the request processing pipeline.

1. Map Method

The Map method is used to conditionally branch the middleware pipeline based on the request's path. It allows you to specify a branch of middleware to handle requests that match a certain path prefix.

app.Map("/path", builder =>
    // Additional middleware for the specified path

In this example, if the request path starts with "/path," the middleware specified inside the Map block will be executed.

2. Use Method

The Use method is a fundamental building block for adding middleware components to the pipeline. It is used to add middleware that executes for all requests or for a specific path.

app.Use(async (context, next) =>
    // Code to be executed before calling the next middleware
    await next();
    // Code to be executed after the next middleware has completed

Middleware added using the Use method is executed in the order it is registered in the pipeline. It's crucial for tasks such as logging, authentication, or any other processing that needs to occur for each request.

3. Run Method

The Run method is used to create terminal middleware that terminates the request pipeline. It does not call the next middleware in the pipeline, making it the last piece of middleware to run.

app.Run(async context =>
    // Handle the request and generate a response

The Run method is often used for tasks that should be the final action in the pipeline, such as returning a response directly without invoking additional middleware.

In ASP.NET Core, the Map, Use, and Run methods provide a powerful mechanism for configuring middleware and controlling the request processing pipeline. By understanding how these methods work, we can create a well-structured and efficient pipeline to handle various aspects of request and response processing in their applications.

We will see more details about the middleware in the next article.

Similar Articles