👁 Image
CasCap.Common.Configuration 4.12.1

CasCap.Common.Configuration

Configuration bootstrapping helpers for .NET applications — standard IConfiguration pipeline setup, Azure Key Vault integration, and validated IOptions<T> binding for IAppConfig records.

Installation

dotnet add package CasCap.Common.Configuration

Purpose

Provides a standardised way to build the configuration pipeline (appsettings.json, environment overrides, environment variables, user secrets, Azure Key Vault) and to bind configuration sections to IAppConfig record types with DataAnnotations validation on startup.

Target frameworks: netstandard2.0, net8.0, net9.0, net10.0

Extensions

Usage

var configuration = new ConfigurationBuilder()
 .AddStandardConfiguration(environmentName, Assembly.GetExecutingAssembly())
 .AddKeyVaultConfigurationFrom(cfg =>
 {
 var appConfig = cfg.GetSection(AppConfig.ConfigurationSectionName).Get<AppConfig>();
 return (appConfig?.KeyVaultUri, appConfig?.TokenCredential);
 })
 .Build();

Configuration Hierarchy

Configuration bootstrapping flow with layered sources:

flowchart TD
 START["ConfigurationBuilder"]

 subgraph StandardConfig["AddStandardConfiguration()"]
 BASE["SetBasePath(contentRoot)"]
 APPSETTINGS["appsettings.json"]
 ENV_FILE["appsettings.{Environment}.json"]
 ENV_VARS["Environment Variables"]
 SECRETS["User Secrets<br/>(Development only)"]
 end

 subgraph KeyVaultConfig["AddKeyVaultConfiguration()"]
 PARTIAL["Partial Build Config"]
 EXTRACT["Extract Key Vault URI<br/>+ TokenCredential"]
 KV["Azure Key Vault<br/>(secrets override)"]
 end

 subgraph Binding["IOptions Binding"]
 VALIDATE["AddCasCapConfiguration<TConfig>()<br/>ValidateDataAnnotations<br/>ValidateOnStart"]
 OPTIONS["IOptions<TConfig><br/>(DI injectable)"]
 end

 START --> BASE
 BASE --> APPSETTINGS
 APPSETTINGS --> ENV_FILE
 ENV_FILE --> ENV_VARS
 ENV_VARS --> SECRETS

 SECRETS --> PARTIAL
 PARTIAL --> EXTRACT
 EXTRACT -."if URI present".-> KV

 KV --> VALIDATE
 SECRETS -."if no Key Vault".-> VALIDATE
 VALIDATE --> OPTIONS

Layering Priority (later sources override earlier ones):

1. appsettings.json
2. appsettings.{Environment}.json
3. Environment Variables
4. User Secrets (Development only)
5. Azure Key Vault (if configured)

Dependencies

NuGet Packages

Project References