Click here to Skip to main content
15,307,017 members
Articles / Web Development / ASP.NET
Posted 27 Apr 2006


54 bookmarked

Managing Connection Strings for Web Farms in ASP.NET 2.0

Rate me:
Please Sign up or sign in to vote.
4.79/5 (18 votes)
27 Apr 20069 min read
How to manage database connection strings and connection string encryption for a web farm, in ASP.NET 2.0.


What do I do with my connection strings? How do I encrypt them to protect my logins? Where should I store them? How can I share them across servers? These are questions that have plagued developers for ages. With .NET 1.0/1.1, a consensus has formed on storing this information in the web.config file. Encryption is fairly simple using the framework encryption libraries and letting Windows internally manage the encryption key.

But Web Farms are more problematic. The encryption algorithm is often shared with other encryption needs (e.g., user passwords), so all machines must share a common encryption key. Key management then becomes a problem, because if someone finds your key, there are only a handful of algorithms to test before your data is compromised. Microsoft recommended storing the key or the connection string in a protected registry key, but in practice I found this to be cumbersome because it required execution of your ASP.NET application as a specially privileged user. Storing the key in the web.config file is easier, but then you had the encrypted data and the decryption key living in the same file - bad idea. Machine config is a better choice, but occasionally causes problems with other applications on the same box, like SharePoint. So there are solutions but no perfect answers.

Simple Example: Unencrypted Connection Strings in Web.Config

We'll start with some simple test code to check our connection. It is the computer classic, Hello World, using the database to say hello.

Create a new website using IIS to host:

  1. File > New > Website >
  2. In dialog, choose the following settings:
    • Template = ASP.NET Web Site
    • Location dropdown = HTTP
    • URL = http://localhost/connectionTest

Next, add the code listed below. The connection string assumes SQL Server 2005 to be installed as a named instance on myserver. For SQLExpress, the server will look like "localhost\SQLExpress".

Test Code Listings

Here is some simple code written as it would be for .NET 1.1. We'll use this as a starting point.


Here, we define our connection string. You can see I added a SQL user for AdventureWorks named test with the password test.

        <add key="myconnection" 
           value="server=myserver\sql2005;initial cata
                  log=AdventureWorks;user id=test;pwd=test;"/>


This is the snippet of code that opens a connection and has the database say hello. There is an ASP Label control named "Label1" and an ASP Button control named "Button1" on the page.

using System.Data.SqlClient;

protected void Button1_Click(object sender, EventArgs e)
    string constr = ConfigurationSettings.AppSettings["myconnection"];
    SqlConnection sqlConn = new SqlConnection(constr);
    SqlCommand cmd = sqlConn.CreateCommand();
    cmd.CommandText = "SELECT 'Hello World'";
        SqlDataReader reader = cmd.ExecuteReader();
        if (reader.Read())
            this.Label1.Text = reader.GetString(0);
            this.Label1.Text = "No Result";
    catch (Exception ex)
        this.Label1.Text = "Error: " + ex.Message;
        if(sqlConn.State != ConnectionState.Closed)

Test Code Updated to ASP.NET 2.0


What happened to my <appSettings> config section? It's still there and still usable, but Microsoft has decided to promote connection strings to their own section. The updated code looks like this:

        <add name="myconnection" 
                            user id=test;pwd=test;"/>


The way configuration settings are accessed has changed slightly as well. The old System.Configuration.AppSettings object has been deprecated in favor of the new System.Configuration.ConfigurationManager. In the case of connection strings, we access the ConnectionStrings collection to obtain a ConnectionStringSettings object.

protected void Button1_Click(object sender, EventArgs e)
    ConnectionStringSettings conn = 
    string constr = conn.ConnectionString;

So that's the simple, unencrypted way to do connection strings. It would run just fine for web farms as is, but you have exposed SQL credentials which is not particularly safe. What about encrypting for web farms?

Help! My code isn't working!

If you get the following error:

System.Data.SqlClient.SqlException: An error has occurred while establishing a connection to the server. When connecting to SQL Server 2005, this failure may be caused by the fact that under the default settings, SQL Server does not allow remote connections. (provider: SQL Network Interfaces, error: 26 - Error Locating Server/Instance Specified)

you may have to modify your SQL Server (2005) to allow external connections via the SQL Server Surface Area Configuration tool (under Start > Programs > Microsoft SQL Server 2005 > Configuration Tools). Either that or your connection string is incorrect.

Encrypting Connection Strings

Encryption of the connectionStrings section of the web.config is easy and fun! Just follow the few easy steps outlined in MSDN (click on the "Configuration" link). You utilize the aspnet_regiis utility to encrypt a section in the application's web.config (hence we use IIS to host our development site instead of the VS2005 built-in web server).

  1. Open a command prompt in the .NET 2.0 framework directory. On most computers, this will be:
  2. Per MSDN instructions, type the following command:
    aspnet_regiis.exe -pe "connectionStrings" -app "/connectionTest"

This uses the default RSAProtectedConfigurationProvider to encrypt the data. This is also the recommended provider to use when setting up a web farm. After this task has been performed, the <connectionStrings> section in your web.config will be rewritten to look something like this:

 <EncryptedData Type=""
    Algorithm="" />
  <KeyInfo xmlns="">
   <EncryptedKey xmlns="">
       Algorithm="" />
    <KeyInfo xmlns="">
     <KeyName>Rsa Key</KeyName>

Now, everything is encrypted and protected and safe. Try to execute your page to prove it.

  • Parser Error Message: Failed to decrypt using provider 'RsaProtectedConfigurationProvider'. Error message from the provider: The RSA key container could not be opened.

Whoops! Seems the MSDN article left out an important step. The application user needs to have access granted to the key container. What access? What key container? Well, let's find out.

Decrypting the Web.Config

First, let's get back to the point where we started. While it is a good idea to maintain backups of your web.config file before doing this encryption, it is reversible. Open your command prompt and go to the .NET Framework installation as before. Issue the following command to decrypt and restore your web.config to its previous state:

aspnet_regiis.exe -pd "connectionStrings" -app "/connectionTest"

The -pd is the decryption flag for the utility. Your config file should be back to its previous state.

Re-Encrypting your Web.Config Correctly for Web Farms

For encryption to work, the key must be accessible both during encryption and during decryption. Our prior example failed because it was not available during decryption. As it turns out, the simple examples out there of how to encrypt your connectionStrings are misleading at best. It is a three step process.

  1. Add a <configProtectedData> section to your web.config to identify the encryption provider and your key container.
  2. Create your own key container on the server.
  3. Grant access to this key container to all interested accounts.
  4. Encrypt the <connectionStrings> section of web.config.
  5. Export the key container for use on other servers in the farm.

So let's do it, step by step.

Step 1: Modify web.config to identify the key container

Edit your web.config file to contain a provider definition that identifies which key container to use for encryption/decryption. Under the <configuration> section, add the following:

<configProtectedData >
        <add name="ConnectionTestProvider"
                System.Configuration, Version=,
                Culture=neutral, processorArchitecture=MSIL"


You may also wish to modify the configuration tag to identify the proper XML namespace, to avoid XML validation errors. It's not necessary for compilation and execution, but it is annoying to have the dev environment tell you the attributes required are not valid. Modify the <configuration> tag to add the xmlns attribute as below.

<configuration xmlns="">

Step 2: Create the key container on the server

Use aspnet_regiis at the command prompt to generate a new RSA cryptographic key container called connectionTestKey.

> aspnet_regiis -pc "connectionTestKey" -exp

This will create a new machine level key container in the following location:

C:\Documents and Settings\All Users\Application Data\Microsoft\Crypto\RSA\MachineKeys

You are highly advised to not manually manipulate these files (delete, change permissions, rename, etc.). I hosed my IIS installation doing this, and had to do a ground-up reinstall of IIS and both the 1.1 and 2.0 .NET Frameworks. My VS2005 installation is still not quite right as a result of this.

Step 3: Grant access to the key container

> aspnet_regiis -pa "connectionTestKey" "ASPNET"

This grants read access on the crypto key file to the indicated user; in this case, the ASPNET built-in account is granted access. Be warned: you may also have to grant read access on the directory C:\Documents and Settings\All Users\Application Data\Microsoft\Crypto\RSA\MachineKeys to the ASPNET account. I had endless problems with this and it is an undocumented "feature" of the security model.

Step 4: Encrypt the <connectionStrings> section of your web.config file

> aspnet_regiis -pe "connectionStrings" -app "/connectionTest"

This will encrypt and rewrite your web.config file. You are now good to go (on this server). If you execute the code, your "Hello World" app should work fine.

Step 5: Export the key container for later use on farm servers

> aspnet_regiis -px "connectionTestKey" \temp\mykeyfile.xml

This writes the key to an XML file for use on other machines in your farm. The contents of the key file will look something like this:


Step 6: Import the key container on farm servers

> aspnet_regiis -pi "connectionTestKey" mykeyfile.xml

When you deploy your application, you will need to import the key as part of the installation process. Place the key file in an accessible location on the server and run the command above to import the key. You are now good to go!

Pitfalls to avoid

Most problems, predictably, revolve around proper configuration of access privileges to the key container. Make sure you add access rights for the account your application is running under, to both the key container and the folder holding it.

If problems occur, do not delete your key containers willy-nilly; use the aspnet_regiis utility. I did this (manually deleted the container) to remove a key container I had mugged up by removing everyone's privilege to. In the process, I deleted some other key containers that were important. Upon restarting IIS, I discovered I could not restart IIS. Instead, I got the following error for the IISADMIN service:

System error 8 - Not enough storage is available to process this command

This required me to uninstall and reinstall IIS to fix the problem. And both the .NET frameworks too. And it's still not fixed. I continue to have the following error:

Safe handle has been closed

when I try to do anything other than create keys. Comments/clues are appreciated. I just hope it doesn't require a full OS install to fix. I'm guessing that the IIS metabase also gets touched when doing things with crypto keys, but I'm still investigating the matter.


To summarize, utilize the new <connectionStrings> section in the web.config along with the new System.Configuration.ConfigurationManager.ConnectionStrings collection to obtain your connection string from the configuration file. Create a key container using the aspnet_regiis utility, and identify the proper container in you web.config by adding a <configProtectedData> section. Encrypt with the aspnet_regiis utility, and export your key for use on other servers in the web farm.

I'm sorry, why is this so complex again? While I laud Microsoft's recognition of the need for security and consistency when handling connection strings, this multi-step, thinly documented process makes me wonder a little about their sanity. In some ways, I appreciate the justification for people like me to continue to make the big bucks. In other ways, I wonder why a simple add-in or installer option wasn't written for VS2005 to handle web farm connection strings. It's almost like they hired some UNIX geek or a Java developer to make this crypto utility stuff work. I smell an opportunity for some intrepid developer.

Also, why was aspnet_regiis appropriated for so many non-ASP.NET-framework-registration-with-IIS functions? Instead of making a security key configuration utility, aspnet_regiis became a dumping ground for this functionality. A poorly thought out utility decision in an otherwise impressively designed framework and SDK (IMnsHO).

Resources Used in Writing this Article


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Chris Cole
Architect Milliman
United States United States
I have been involved in professional software development for over 15 years, focusing on distributed applications on both Microsoft and Java platforms.

I also like long walks on the beach and a sense of humor and don't like mean people Wink | ;-)

Comments and Discussions

QuestionSafe handle has been closed error Pin
CarmelFrank4-May-16 9:20
MemberCarmelFrank4-May-16 9:20 
QuestionEncryption C# web config fails Pin Pin
Recmach10-Sep-15 0:51
MemberRecmach10-Sep-15 0:51 
QuestionRSA Key Container Can not be opened Problem Pin
Member 302373824-May-11 12:25
MemberMember 302373824-May-11 12:25 
AnswerRe: RSA Key Container Can not be opened Problem Pin
Misha196412-Jul-11 7:22
MemberMisha196412-Jul-11 7:22 
QuestionRSA Encryption - can this be used for user created sections of the web.config Pin
destinationjon15-May-09 3:06
Memberdestinationjon15-May-09 3:06 
GeneralCommand prompt hangs when i run aspnet_regiis -pc "connectionTestKey" -exp Pin
bhavpreet singh5-Feb-09 18:59
Memberbhavpreet singh5-Feb-09 18:59 
GeneralCould not find System.Configuration Assembly Pin
Boogster12-Jun-08 0:24
MemberBoogster12-Jun-08 0:24 
GeneralRe: Could not find System.Configuration Assembly Pin
zkc66625-Jun-08 3:40
Memberzkc66625-Jun-08 3:40 
GeneralRe: Could not find System.Configuration Assembly Pin
Jammer16-Jan-09 5:44
MemberJammer16-Jan-09 5:44 
AnswerRe: Could not find System.Configuration Assembly Pin
MarcusLeBlanc21-Apr-09 4:32
MemberMarcusLeBlanc21-Apr-09 4:32 
GeneralStep 5; Step6 Pin
imperialx14-Nov-07 1:13
Memberimperialx14-Nov-07 1:13 
GeneralStep 3 Error: Pin
supermeerkat6-Sep-07 11:57
Membersupermeerkat6-Sep-07 11:57 
GeneralRe: Step 3 Error: Pin
joch_p4-Apr-08 3:04
Memberjoch_p4-Apr-08 3:04 
GeneralBut, what about in a hosting environment Pin
eevmq197427-Jun-07 9:58
Membereevmq197427-Jun-07 9:58 
GeneralRe: But, what about in a hosting environment Pin
Alex Shapovalov25-Mar-08 5:27
professionalAlex Shapovalov25-Mar-08 5:27 
GeneralSafe Handle Pin
ts5450323-Apr-07 11:40
Memberts5450323-Apr-07 11:40 
GeneralRe: Safe Handle Pin
sersoft11-Feb-08 4:51
Membersersoft11-Feb-08 4:51 
GeneralRe: Safe Handle Pin
RSmith108-Aug-08 6:12
MemberRSmith108-Aug-08 6:12 
QuestionSafe handle has been closed Pin
itobob12-Apr-07 5:50
Memberitobob12-Apr-07 5:50 
GeneralNeed to include -prov when encrypting Pin
BillFlynn23-Mar-07 11:25
MemberBillFlynn23-Mar-07 11:25 
GeneralEXporting the Key Pin
TonyCsr27-Oct-06 19:53
MemberTonyCsr27-Oct-06 19:53 
GeneralExporting the RSA Key Pin
dthomas7725-Sep-06 23:48
Memberdthomas7725-Sep-06 23:48 
GeneralRe: Exporting the RSA Key Pin
wipro_viv12-Jun-07 10:15
Memberwipro_viv12-Jun-07 10:15 
GeneralRe: Exporting the RSA Key Pin
d2bishop7-Aug-07 6:01
Memberd2bishop7-Aug-07 6:01 
Generalpp Pin
HallaluChristy2-Sep-06 7:28
MemberHallaluChristy2-Sep-06 7:28 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.