ASP.NET Core is a cross-platform, high-performance, open-source framework for building modern, cloud-enabled, internet-connected apps.
The easiest and safest fix is to validate configuration values before Azure services are registered. This prevents accidental fallback authentication and gives clear feedback if something is missing.
Here’s a clean version of the solution:
public static IServiceCollection AddAzureResourceGraphClient(
this IServiceCollection services,
IConfiguration config)
{
var connectionString = config["Authentication:AzureServiceAuthConnectionString"];
if (string.IsNullOrWhiteSpace(connectionString))
throw new InvalidOperationException(
"Missing 'Authentication:AzureServiceAuthConnectionString' configuration."
);
services.AddSingleton(_ => new AzureServiceTokenProvider(connectionString));
return services;
}
This small addition gives you:
✔ Clear error messages
✔ Consistent behavior between environments
✔ No more unexpected Azure calls during tests
✔ Easier debugging for teammates
For larger apps, you can also use strongly typed configuration + validation (IOptions<T>), which helps keep settings organized and ensures nothing slips through the cracks.
With this guard in place, your integration tests stay clean, predictable, and Azure-free unless you want them to involve Azure.
Most Azure SDK components rely on configuration values to know how to authenticate. For example:
new AzureServiceTokenProvider(
config["Authentication:AzureServiceAuthConnectionString"]
);
If this key is missing, the Azure SDK does not stop. Instead, it thinks:
“I’ll figure this out myself!”
And then it tries fallback authentication options, such as:
These attempts fail instantly inside a local test environment, leading to confusing “AccessDenied” messages.
The surprising part?
Your project may work fine during normal execution—but your API project or test project may simply be missing the same setting.
This tiny configuration mismatch means:
Once you understand this, the solution becomes much clearer.
Running integration tests in ASP.NET Core feels simple—until your tests start calling Azure without permission. This usually happens when you use WebApplicationFactory<T> to spin up a real application host. The test doesn’t run only your code; it runs your entire application startup pipeline.
That includes:
If your app registers Azure services during startup, they will also start up during your tests. And if the environment lacks proper credentials (which test environments usually do), Azure returns errors like:
This can be confusing because unit tests work fine. But integration tests behave differently because they load real startup logic.
The issue isn’t Azure being difficult—it's your tests running more than you expect.
Understanding this is the first step to diagnosing configuration problems before Azure becomes part of your test run unintentionally.
Have you ever run an ASP.NET Core integration test and suddenly been greeted by an unexpected Azure “Access Denied” error? Even though your application runs perfectly fine everywhere else? This is a common but often confusing situation in multi-project .NET solutions. The short version: your tests might be accidentally triggering Azure authentication without you realizing it.
This Parent Snipp introduces the full problem and provides a quick overview of the three child Snipps that break down the issue step by step:
Snipp 1 – The Issue:
Integration tests using WebApplicationFactory<T> don’t just test your code—they spin up your entire application. That means all Azure clients and authentication logic also start running. If your test environment lacks proper credentials, Azure responds with errors that seem unrelated to your actual test.
Snipp 2 – The Cause:
The root cause is often a missing configuration value, such as an Azure authentication connection string. When this value is missing, Azure SDK components fall back to default authentication behavior. This fallback usually fails during tests, leading to confusing error messages that hide the real problem.
Snipp 3 – The Resolution:
The recommended fix is to add safe configuration validation during service registration. By checking that required settings exist before creating Azure clients, you prevent fallback authentication and surface clear, friendly error messages. This leads to predictable tests and easier debugging.
Together, these Snipps give you a practical roadmap for diagnosing and fixing Azure authentication problems in ASP.NET Core integration tests. If you’re building APIs, background workers, or shared libraries, these tips will help you keep your testing environment clean and Azure-free—unless you want it to talk to Azure.
When you run an ASP.NET Core API from the command line, it will not use the port defined in launchSettings.json. This often surprises developers, but it is normal behavior.
The reason is simple: launchSettings.json is only used by Visual Studio or other IDEs during debugging.
To make your app listen on a specific port when running with dotnet run or dotnet MyApi.dll, you must configure the port using runtime options such as command-line arguments, environment variables, or appsettings.json.
Key Points
launchSettings.json does not apply when starting the app from the console.dotnet run --urls "http://localhost:5050" to force a port.ASPNETCORE_URLS=http://localhost:5050appsettings.json to define Kestrel endpoints.http://0.0.0.0:5050 if running inside Docker or WSL.When creating API endpoints in ASP.NET Core, you often need to ensure only authenticated users can access certain actions.
The [Authorize] attribute makes this easy — it automatically blocks unauthenticated requests.
Sometimes, you also load the current user from a database or a user service. In this case, it’s a good practice to add a null check as an extra safety step, even if [Authorize] is already applied.
Example
[Authorize]
[HttpPost("DoSomething")]
public async Task<IActionResult> DoSomething(RequestModel request)
{
var user = await userService.GetContextUserAsync();
if (user == null)
{
// Safety check in case the user is authenticated but not found in the database
return Unauthorized("User not found.");
}
// Continue with the action
return Ok("Action completed successfully.");
}
Key Ideas
[Authorize] ensures only authenticated users reach your action.if (user == null) check.This pattern keeps your API safe, clean, and reliable.
To make your ASP.NET Core services easy to test and maintain, follow this proven pattern. The example below demonstrates how to register a service and configure an HttpClient with custom handlers, while keeping the design flexible for unit testing.
Register your service interface and implementation as a singleton (or other lifetime as needed). This keeps the service replaceable in tests:
services.AddSingleton<IMyService, MyService>();
Tip: Use TryAdd for safe registration in reusable code
If your registration code is part of a shared library or package, use TryAdd to avoid overriding existing registrations accidentally:
services.TryAddSingleton<IMyService, MyService>();
Use a named HttpClient to add retry and logging handlers. These handlers improve reliability and diagnostics:
services.AddHttpClient(nameof(MyService))
.AddHttpMessageHandler(s => new RetryHandler(s))
.AddHttpMessageHandler(s => new LoggingHandler(s));
You can call AddMemoryCache() without worry — it internally prevents duplicates:
services.AddMemoryCache();
public static class ServiceCollectionExtensions
{
public static IServiceCollection AddMyClientServices(this IServiceCollection services)
{
ArgumentNullException.ThrowIfNull(services);
services.AddMemoryCache();
services.TryAddSingleton<IMyService, MyService>();
services.AddHttpClient(nameof(MyService))
.AddHttpMessageHandler(s => new RetryHandler(s))
.AddHttpMessageHandler(s => new LoggingHandler(s));
return services;
}
}
Why This Matters
Using this approach ensures your ASP.NET Core apps are easier to maintain, test, and extend.
It’s best practice to tailor logging levels per environment (Development, Staging, Production) by using environment-specific configuration files like appsettings.Development.json or appsettings.Production.json.
Example for Development (verbose logging):
{
"Logging": {
"LogLevel": {
"Default": "Debug",
"Microsoft": "Information",
"System": "Warning",
"YourAppNamespace": "Trace"
}
}
}
Example for Production (concise logging):
{
"Logging": {
"LogLevel": {
"Default": "Warning",
"Microsoft": "Warning",
"System": "Warning",
"YourAppNamespace": "Information"
}
}
}
By adjusting log levels per environment, you can capture detailed diagnostics during development while reducing noise and performance impact in production.
ASP.NET Core allows you to customize logging behavior per provider, such as Console or Application Insights. This is useful when you want different verbosity or volume controls depending on the sink.
Example:
{
"Logging": {
"LogLevel": {
"Default": "Warning",
"Microsoft": "Warning",
"System": "Warning",
"YourAppNamespace": "Trace"
},
"Console": {
"LogLevel": {
"Default": "Information",
"YourAppNamespace": "Debug"
}
},
"ApplicationInsights": {
"LogLevel": {
"Default": "Error"
}
}
}
}
Information and Debug).Use per-provider overrides when you want finer control over logging destinations.
In ASP.NET Core, you can configure logging levels to control the verbosity of logs across your application and third-party frameworks.
A common pattern is to set a default minimum log level (e.g., Warning) and enable verbose logging (Trace) only for your own application namespace.
Example configuration in appsettings.json or an environment-specific file:
{
"Logging": {
"LogLevel": {
"Default": "Warning",
"Microsoft": "Warning",
"System": "Warning",
"YourAppNamespace": "Trace"
}
}
}
"Default": "Warning" sets a baseline for all logs."Microsoft" and "System" are explicitly set to Warning to reduce noise from framework logs."YourAppNamespace": "Trace" enables detailed logging for your application code.This ensures your app logs detailed information while keeping system logs concise and manageable.
Logging is a critical aspect of application monitoring and diagnostics. ASP.NET Core provides flexible logging configuration options to help you balance verbosity and noise across different environments and providers.
This series covers best practices for configuring logging levels, including:
Explore the related Snipps below to implement a robust, maintainable logging strategy in your ASP.NET Core applications.
DelegatingHandlers can be tested in isolation:
Mock the Inner Handler:
Inject into DelegatingHandler:
Create HttpClient:
This approach allows for unit testing the DelegatingHandler's logic without making actual HTTP calls.
Multiple DelegatingHandlers can be chained to create a pipeline:
services.AddTransient<LoggingHandler>();
services.AddTransient<AuthenticationHandler>();
services.AddHttpClient("ChainedClient")
.AddHttpMessageHandler<LoggingHandler>()
.AddHttpMessageHandler<AuthenticationHandler>();
In this setup, LoggingHandler processes the request first, followed by AuthenticationHandler. The order of registration determines the sequence of execution.
To create a custom DelegatingHandler:
Inherit from DelegatingHandler:
Register the Handler:
In ASP.NET Core, register the handler using IHttpClientFactory:
Summary:
This video demonstrates how to generate a TreeView structure using data directly from a SQL Server database in an MVC 4 application. The example uses recursive methods to fetch hierarchical data from a parent-child table (such as a category structure). The TreeView is rendered using a combination of Razor and recursive HTML helpers.
Key Steps:
Best For:
Developers working with older ASP.NET MVC versions who need to generate TreeViews from database-driven content, particularly with dynamic data structures.
Summary:
This tutorial walks through building a TreeView in ASP.NET Core using ViewModel binding and JSON serialization. The TreeView is rendered on the client side using a simple recursive HTML structure. The backend constructs the hierarchy from a static or database source and passes it to the view. The data is structured using parent-child relationships, and the final JSON is passed to the view for rendering. No third-party libraries are used, making it a lightweight and transparent solution.
Key Steps:
Best For:
Developers using ASP.NET Core who want a lightweight, client-side rendered TreeView without relying on jQuery plugins or third-party UI components.
TreeView is a popular UI component used for displaying hierarchical data in a nested, expandable structure. In ASP.NET MVC and ASP.NET Core, creating a TreeView can enhance navigation, represent parent-child relationships (such as categories or folders), and improve user interaction with complex data structures.
This overview introduces how TreeViews are implemented in both ASP.NET MVC 4 and ASP.NET Core, using Razor views and model binding, and how data from a database can be dynamically rendered in a hierarchical format.
DelegatingHandler is a powerful mechanism in ASP.NET that enables developers to intercept and manipulate HTTP requests and responses. Functioning similarly to middleware, it allows for the implementation of cross-cutting concerns such as logging, authentication, and error handling in a modular and reusable manner.
DelegatingHandler is versatile and can be employed for various purposes:
While both DelegatingHandler and middleware can process HTTP requests and responses, they serve different purposes:
Use middleware for server-side concerns and DelegatingHandler for client-side HTTP request processing.
ASP.NET Core provides robust support for making outbound HTTP requests using HttpClient, often via the IHttpClientFactory. This section covers advanced features for managing these requests, including the use of DelegatingHandler for building custom request/response pipelines. These handlers enable cross-cutting concerns like logging, authentication, and retries in a modular and testable way.
This section includes:
DelegatingHandlerDelegatingHandler and middlewareKubernetes ist in der Cloud-Welt allgegenwärtig; nahezu alle Public-Cloud-Anbieter offerieren Kubernetes als Managed Service oder nutzen es intern für ihre PaaS- und Serverless-Dienste. Auch in lokalen Rechenzentren wird Kubernetes häufig eingesetzt und entfaltet dort seine Stärken als Plattform. Obwohl sich die verschiedenen Kubernetes-Distributionen und Managed Services in technischen Details wie Installation und Integration von Netzwerk- und Speicherressourcen unterscheiden, bleibt die Plattform für Anwendungen weitgehend einheitlich. Mit minimalen Konfigurationsanpassungen können Applikationen sowohl in der Cloud als auch in On-Premises-Umgebungen nahtlos betrieben werden.
ASP.NET Core provides a rich set of tools for handling HTTP communication—both inbound and outbound. This root Snipp focuses on outbound HTTP requests using HttpClient, IHttpClientFactory, DelegatingHandler, and related patterns. These features are critical for building resilient services that interact with external APIs and microservices.
Topics covered under this root:
HttpClient with IHttpClientFactoryDelegatingHandlersThis section is essential for developers building cloud-native apps, microservices, or any service that consumes external APIs.
To inject configuration settings in your ASP.NET Core application, use Microsoft.Extensions.Configuration and inject IConfiguration into your page or component. Access configuration values using Configuration["KeyName"].
@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration
<!-- Access configuration value -->
@Configuration["ApplicationInsights:InstrumentationKey"]
For more structured configuration management, use the options pattern with Microsoft.Extensions.Options. Inject IOptionsMonitor<TOptions> with @inject and access configuration values through OptionsAccessor.Value.PropertyName.
@using Microsoft.Extensions.Options
@inject IOptionsMonitor<ApplicationInsightsOptions> ApplicationInsightsOptionsAccessor
<!-- Access configuration value -->
var instrumentationKey = ApplicationInsightsOptionsAccessor.Value.InstrumentationKey;
For detailed information, refer to the ASP.NET Core documentation on configuration options.
Razor is a concise markup language that integrates server-side code (C# or VB) into ASP.NET web pages seamlessly. It simplifies web development by blending code and HTML, enhancing productivity and maintainability.
@page
@model IndexModel
@{
ViewData["Title"] = "Home page";
}
<h1>@ViewData["Title"]</h1>
<p>Welcome to my ASP.NET Core Razor Pages!</p>
In this code snippet, the @page directive specifies the page, @model defines the page's model, and @ViewData displays dynamic data within the Razor Page markup.
Resources
Razor Syntax allows you to embed code (C#) into page views through the use of a few keywords, and then have the C# code be processed and converted at runtime to HTML.
Here are six different ways to run your ASP.NET Core web application:
For more detailed information, check out the guide on 6 different ways to run an asp.net core web application (secretGeek.net)
Before jumping to the solution, let's talk about use cases. Using both tokens and cookies is not a common use case, but it typically comes up when you have a SPA or pure API applications that also need to secure some non-SPA pure Web Browser end points that the server sends directly to the browser. If that content needs to be protected behind authentication you might need Cookie authentication, because you can't do Bearer Token authentication with plain HTML interfaces in the browser.
services.AddAuthentication(options =>
{
// custom scheme defined in .AddPolicyScheme() below
options.DefaultScheme = "JWT_OR_COOKIE";
options.DefaultChallengeScheme = "JWT_OR_COOKIE";
})
.AddCookie("Cookies", options =>
{
options.LoginPath = "/login";
options.ExpireTimeSpan = TimeSpan.FromDays(1);
})
.AddJwtBearer("Bearer", options =>
{
options.TokenValidationParameters = new TokenValidationParameters
{
ValidateIssuer = true,
ValidIssuer = config.JwtToken.Issuer,
ValidateAudience = true,
ValidAudience = config.JwtToken.Audience,
ValidateIssuerSigningKey = true,
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(config.JwtToken.SigningKey))
};
})
Source: Combining Bearer Token and Cookie Authentication in ASP.NET - Rick Strahl's Web Log (west-wind.com)