Asp.Net Core Basics- Accessing Configuration Settings from Multiple Sources
In older Asp.Net Version, we typically store the configuration settings in web.config and access it using ConfigurationManager Class. This worked well in the past however it is not good enough for modern technologies like hosting in cloud or container based solutions. Moreover, storing the sensitive data in web.config poses security risk if the file is check in to source control by accident.
In Asp.Net Core , Configuration API was introduced to access the key value pair data from various sources in the order they are configured which allows you to access the configuration keys using Configuration Class regardless of where the keys are stored. If the same key value pair is stored in more than one places, the latest in order of precedence will overwrite the other values. Let’s dive into the demo to see how it works.
Order of Precedence
By default, ASP.Net Core version 2.0, the configuration providers order of precedence is hidden in Program.cs behind the method call CreateDefaultBuilder(). If you look at source code from github, you will see that it loads the data in following order.
- appsettings.json file
- appsettings.{env.EnvironmentName}.json file
- The local User Secrets File (local development environment only)
- Environment Variables
- Command Line Arguments
In Addition to that, you can also create custom providers by implementing IConfigurationSource interface and add it into the processing pipeline. Asp.net core also supports reading from xml file in addition to json file.
How it Works – Demo
In this Demo, we will see how to read and display the configuration key that are available from various sources and what value is displaying based on order of precedence. Launch the visual studio and create a new Asp.net Core Empty Web Application.
After the empty project is created, add the AppSettings.json item into the project.
Add the new key value pair item called DemoConfigKey in the AppSettings.json and set the value as “Value from AppSettings.json”
In order to access the value from configuration object we need to use Startup constructor as shown below.
After we added the Startup constructor with the parameter of type IConfiguration, we can store the injected IConfiguration object into local variable and then use it anywhere within ConfigureServices() and Configure() and also we can access it from other controller via dependency injection passing the IConfiguration object in Controller Constructor.
In order to print the config value, I have just modified the default Configure method like below. This will print the value reading from configuration sources defined in the order.
When I run the application, you will see the result below reading from AppSettings.json.
Appsettings.{env.EnvironmentName}.json File
This file is used to override the keys in appsettings.json with deployment environment specific settings. For Example a file named appsettings.production.json would contain values specific to production.
By Default, Asp.net Core Environment is Development. You can modify it in Visual Studio by changing it in Project Properties if needed.
Let’s add the environment specific AppSettings.Development.json file into the project.
Add the value for DemoConfigKey as “Value from AppSettings.Development.json”
Let’s run the application and see the result. We should get the value from AppSettings.Development.json by overwriting the value from AppSettings.json based on the order of precedence.
User Secrets
The User Secrets file is a JSON file stored on the local developer machine. This file is unencrypted and stored outside of the solution directory (under user profile directory) and, therefore, is not checked into source control by accident. The user secrets file is used only for local development overrides like connecting to a local database server or development server API key values etc. These configuration values are only relevant to the local developer and any other developer / machine cannot access those values.
To add the UserSecrects.json file, right click on the project file and select Manage User Secrets.
Add the Same key and set the different value as below.
Lets run the application and it should override all the other key values and put the value from Secrets.json
Environment Variables
Environment variables used mostly in container-based solutions like Docker Compose and Kubernetes. Docker allows environment variables to be configured in a Docker file using the ENV instruction. For example:
ENV DemoConfigKey: Value from Docker Environment Variable
See the Docker reference documentation for more details.
Command Line Variables
Command line arguments allow you to modify the configuration keys when running your application without modifying any files using the command line syntax of key=value.
In this demo, we run the application in command line window as below.
When running the application, you will see the result as below
Conclusion
Asp.net Core allows you to have same configuration key value pair in multiple places and allowing us to write the same code to access those values with the order of precedence regardless of it’s source. It also allows you to have multiple config file with different set of keys and load them all in one configuration object. It is very useful when you want to split the configuration settings into different file by module (Eg: All Database Related Key Value Pairs in one file) or any other category that suitable for your application. For the Cloud based solution, you should also consider using Azure Key vault for storing your sensitive secrets data.
As mentioned above, the default order of precedence was hidden behind the method CreateDefaultBuilder(args) . If you want to create a custom configuration provider, you can do that by implementing IConfigurationSource Interface. I hope this article helps you to understand how configuration data is getting accessed at runtime from various sources.
Happy Coding!