Managing the Password of the Application’s User

How can you ensure that passwords conform to a policy, even if they are used for connecting applications to databases? Absolving them from the policy is a security risk and you don't want to trouble the users with password changes. Dennes Torres shows how to manage application users’ passwords in Entity Framework; so that no one, not even the database and IT administrators, knows the current password.

When we use Windows Authentication, Active Directory enforces password policy for the users, including expiration policy. This was an unwelcome difference between window and SQL Logins until SQL Server 2012, when SQL Server started to enforce windows password policies to SQL Server logins by default.

Policy settings for SQL Server Login

However, most people will ask why this is necessary. Only a user that is connecting directly to SQL Server in SSMS is able to change his password when it expires and the majority of SQL Server users will connect through some application which, in turn, connects to SQL Server using a single login created for it.

The application login is stored by the application in some kind of configuration file. In .NET, they are stored in the .config files with their passwords. In this case, why would you want to enforce domain password policy, if the application won’t be able to change the password anyway?

The answer is, of course, that you wouldn’t but what if the application could, in fact, change the password? Then an expiration policy makes sense. I will show in this article how we can achieve a security regimen where the application can conform to the password policy requirements automatically and no one, not even the developers, database or IT administrators, will know the password used by the application, thereby enhancing the security of our application environment.

Development Environment for this article

I’m using SQL Server 2017 CTP 2.1 and Visual Studio 2017 to develop this solution, but I will use a library from SQL Server 2014, as I will explain later in the article.

You can use different Visual Studio versions, but the solution as it stands will only work with Entity Framework 6.0 and later.

You will also need IIS (Internet Information Server) configured on the machine so you can simulate the deployment process.

I will use the ‘Northwnd’ sample database, which you can download from here. I will restore the ‘Northwnd.bak’ file twice, creating two databases: ‘Northwnd’ and ‘NorthProduction’.

We will start with an existing small solution with two projects. You can download the starting solution from this link: https://github.com/DennesTorres/ChangePassword/tree/master/slCustomersStarting . One of the projects is an MVC Web Application with a single controller and view. The controller accesses customers’ information in the ‘Northwnd’ database and exposes this information to the view. The database access is executed by the second project, a class library with the Entity Framework context.

The use of the password in the development process

How can we manage our development and deployment process without knowing the password for the database server?

Let’s suppose we have three environments: Development, QA/Test and Production. Developers need access to the development environment, so we can’t hide the password in this environment. QA/Test and Production, however, can have a stricter access control.

When the application is published from development to QA/Test, and thence to Production, the connection string is changed. Some people still do it manually, however, we have web.config transformations to do it for us during the publishing process.

The secret here is in the database layer: Each time a new deployment is completed, the DBA needs to reset the password for the database login to a starting password known by the deployment process and configured in the web.config.

The login needs to be configured with ‘User must change password at next login’ configuration, so the application will change the password during the first login after the deployment and no one but the application will know the new password.

However, after the password change, the password will be inside the web.config, won’t it? Yes, it will, but the IT team can encrypt the web.config during the deployment process. It’s already difficult to have access to the web.config, only some members of the IT team have this kind of access, with the automatic encryption the access will be even more restrict and we will achieve the objective: No one but the application will know the password.

In this article, I will build the application and test it as it was in the QA/Test environment and do some steps of the deployment process to the Production environment.

The Solution

Our solution needs to change the login password every time it expires, or when the login is marked with the ‘User must change password at next logon’ option. We will need to break the solution in parts to achieve a better code organization. These will be the parts of our solution:

  • Part I: A class to change SQL Server login password.

    This class will receive a connection string and change the password in the server and in the connection string

  • Part II: A class to change the connection string in the .config file

    Our solution can be used from a web application or a desktop application. This class will need to identify it and open the correct .config file (app.config or web.config).

  • Part III: Intercept and identify connection errors

    In this article, I will focus on Entity Framework and I will demonstrate how to use the retry strategy to intercept errors and identify whether the reason was the password.

Preparing the Logins

Before starting the development, we need to configure the SQL Server logins for QA/Test and Production environments. These will be our first steps:

  1. Open SSMS (SQL Server Management Studio)
  2. Inside Object Explorer window, below your server, open folders ‘Security’ -> ‘Logins’
  3. Right-click the ‘Logins’ folder and click ‘New Login’ item in the context menu

  4. In the ‘Login – New’ window, type ‘usrQuality’ in the ‘Login Name’ textbox
  5. Select ‘SQL Server Authentication’ radio button
  6. Type ‘Pa$$w0rd’ in the ‘Password’ textbox
  7. Type ‘Pa$$w0rd’ in the ‘Confirm Password’ textbox
  8. Click in the checkbox ‘User must change password at next login’ and keep it checked

  9. In the left side of ‘Login – New’ window, below ‘Select a page’, click ‘User Mappings’
  10. Inside the ‘Users mapped to this login’ box, click the checkbox besides the ‘Northwnd’ database, keep it checked
  11. Inside the ‘Database role membership for: Northwnd’ box, click the checkbox besides ‘db_datareader’ role, keep it checked.
  12. Inside the ‘Database role membership for: Northwnd’ box, click the checkbox besides ‘db_datawriter’ role, keep it checked.
  13. Click the ‘Ok’ button

  14. Repeat steps 2 to 13 for the login ‘usrProduction’

    Part I: Changing SQL Server login password

    We can’t use a regular ADO.NET or Entity Framework connection to change the login password, especially because the password will be expired and we can’t connect.

    SQL Server has a different set of objects, SMO (SQL Server Management Objects), which we can use to execute management tasks in the server, including a change of the password.

    SMO can be installed with the SQL Server installation, choosing Client Tools SDK during the installation. There are some other installation options, you can see details here

    We need only a single assembly: Microsoft.SqlServer.ConnectionInfo.dll. This assembly exists for each SQL Server version, however, after some tests, I was able to change the password of a login in SQL Server 2017 using the assembly from SQL Server 2014. Due to that, I saw no need to use some design pattern, such as provider model, to turn flexible the use of this library.

    According the SQL Server version, this assembly can be in ‘C:\Program Files\Microsoft SQL Server\<version number>\SDK\Assemblies’ or ‘C:\Program Files (x86)\Microsoft SQL Server\<version number>\SDK\Assemblies’. Until version 120 (SQL Server 2014), the assembly uses the first path, after that uses the second.

    Let’s do a step-by-step walk-through to start the creation of our solution and implement this first class:

  15. Open the starting solution in Visual Studio
  16. Create the project ‘libPassword’
    1. In the ‘Solution Explorer’ window, right-click the ‘slHints’ solution and click ‘Add’->’New Project’ in the context menu
    2. In the right side of the ‘New Project’ window, select ‘Installed’->’Templates’->’Visual C#’->Windows in the tree
    3. In the middle of the ‘New Project’ window, select ‘Class Library’ project template
    4. In the ‘Name’ textbox, type ‘libPassword’ and click ‘Ok’ button

    5. In the ‘Solution Explorer’ window, right-click the ‘Class1.cs’ file, below the ‘libDados’ project, and click ‘Delete’ in the context menu
  17. Add reference to Microsoft.SqlServer.ConnectionInfo.dll
    1. In the ‘Solution Explorer’ window, right-click the ‘libPassword’ project and click ‘Add’->’Reference’ in the context menu
    2. In the ‘Reference Manager’ window, click ‘Browse’ button
    3. Navigate to the correct folder and select the file Microsoft.SqlServer.ConnectionInfo.dll

    4. Click ‘Ok’ button
  18. Create a new class called ‘SQLChangePassword’
    1. In the ‘Solution Explorer’ window, right-click the ‘libPassword’ project and click ‘Add’->’Class’ in the context menu
    2. Type ‘SQLChangePassword.cs’ in the ‘Name’ textbox and click the ‘Ok’ button
  19. Add the following lines to the top of the file ‘SQLChangePassword.cs’, just below the ‘Using’s:

  20. Create the method ‘ChangePwd’ in the ‘SQLChangePassword’ class using the following code:

    This method uses two classes:

    • SqlConnectionStringBuilder: This class is responsible to break the connection string in several pieces, so we can use each connection information.
    • ServerConnection: This is the SMO class responsible for the SQL Server connection and with a method to change the password.

    Part II: Saving the new password in the .config file

    The main library of our solution is ‘libPassword’, all other projects are there only for the example. If our library is running as a desktop application, we need to save the password in the app.config file. However, if the library is running in a web application, we need to save the password in the web.config.

    In both cases, we need to retrieve an instance of the ‘Config’ class, change the value and use the save method. However, for the desktop application we will use ‘ConfigurationManager’ to retrieve the ‘Config’ instance, while for the web application we will use ‘WebConfigurationManager’ for this task.

    We can use the value of HttpRuntime.AppDomainAppId to identify whether our library is running in a web application or desktop application.

    Let’s continue our walk-through:

  21. Create the class ‘SetConnectionConfig’
    1. In the ‘Solution Explorer’ window, right-click the ‘libPassword’ project and click ‘Add’->’Class’ in the context menu
    2. Type ‘SetConnectionConfig.cs’ in the ‘Name’ textbox and click the ‘Ok’ button
  22. Add a reference to ‘System.Web’ in the ‘libPassword’ project
    1. In the ‘Solution Explorer’ window, right-click the ‘libPassword’ project and click ‘Add’->’Reference’ in the context menu
    2. In the left side of the ‘Reference Manager’ window, select ‘Assemblies’->’Framework’
    3. In the ‘Reference Manager’ window, click ‘System.Web’ checkbox
    4. Click ‘Ok’ button
  23. Add the following lines in the top of ‘SetConnectionConfig.cs’ file, just below the ‘Using’s:

  24. Create the method ‘SetConnection’ using the following code:

    Part III: Intercepting and Identifying connection errors

    From version 6 and beyond, Entity Framework can use an Execution Strategy to control some aspects of the execution of statements in the database server, such as the retry policy.

    When an error happens because of a password expiration, we can change the password and retry the query with the new password, making the retry policy a good centralized way to implement this solution, avoiding the need of error handling to deal with password problems all around the application.

    This is the biggest part of our solution, we will need several steps to complete this third part:

    • Create the class for the Execution Strategy
    • Create the methods to deal with the connection string.
    • Create the main method to control the retry policy
    • Apply the Execution Strategy

    Creating the class for the Execution Strategy

    Let’s continue our walk-through creating a new class for the Execution Strategy:

  25. Create the class ‘PasswordStrategy’
    1. In the ‘Solution Explorer’ window, right-click the ‘libPassword’ project and click ‘Add’->’Class’ in the context menu
    2. Type ‘PasswordStrategy.cs’ in the ‘Name’ textbox and click the ‘Ok’ button
  26. Add the following lines in the top of ‘PasswordStrategy.cs’ file, just below the ‘Using’s:

  27. Change the inheritance of ‘PasswordStrategy’ class using the following code:

  28. Add the following constants, using the code below. These codes are the error number returned by SQL Server if the password have expired or if the administrator configured the login to change the password on the next logon.

  29. We need to create static properties in the ‘PasswordStrategy’ class for the connection string name and the context. ‘PasswordStrategy’ needs the connection string name to retrieve and save the connection to the config file and needs the context to refresh the connection string in the context, otherwise the context wouldn’t notice the change.

    This is the code for these properties:

  30. Create a property called ‘ConStr’ to simplify the access to the connectionstring.

    The information and context lifecycle

    The ‘PasswordStrategy’ class needs the information from the entity context and the connection string. The lifecycle of these information, context and connection string, in this class and the lifecycle of the entity context in the application needs to be similar, otherwise the information will be wrong and nothing will work.

    The Static definition for the properties specify the lifecycle as a single value for the entire application execution, however, the ThreadStatic attribute changes this lifecycle for a thread, so each thread can have different values for these properties.

    The entity context can be used in several different ways. Some of them will be compatible with this lifecycle we are developing, whereas some of them will not and will require a different ‘PasswordStrategy’ class.

    These are the uses of the entity context that are supported by this implementation:

    • The same context instantiated in each thread: This is the main way of using the entity context that this solution is built for.
    • Multiple contexts with different connection strings, in different threads: It doesn’t matter if the application has different contexts with different connection strings. As long as they are used in different threads, everything will be ok.
    • Singleton context in a desktop application: As long as the context and the instance of ‘PasswordStrategy’ are in the same thread, there is no problem.

    There are some other possible ways of using the context that will not be supported by this class:

    • Singleton context in a web application: Because the ThreadStatic attribute the values of the properties will be lost.
    • Multiple contexts using different connection string in the same thread: This class can’t store information about multiple contexts
    • Multiple singleton contexts: Same problem, this class can’t store information about multiple contexts

    Pay heed to the following details in the code:

    • For reading purposes, ConfigurationManager class can be used for both web applications and desktop applications.
    • I’m using the new null operator created in C# 6.0 to check whether the connection string really exists.
  31. I will create a static attribute, ‘ChangingPassword’, to control the execution of the password-changing process. This process needs to be executed only once: If the process is already executing, then we won’t start the execution a second time.

    Dealing with Entity Framework string

    This sample application is using database first, so we have an Entity Framework connection string with the information about the EDMX and the SQL Server connection string is inside it.

    We need to extract the SQL Server connection string from the Entity Framework string, change the password and create a new Entity Framework string with the new password. We’ll do this by creating two methods for these tasks: ‘ExtractString’ and ‘BuildString’.

  32. Create the method ‘ExtractString’:

    This method receives an Entity Framework connection string and uses the EntityConnectionStringBuilder class to extract the provider connection string, in our case, a SQL Server connection string.

  33. Create the method ‘BuildString’:

    This method receives the provider string, reads the Entity Framework string from the config file using the ‘ConStr’ property, then uses the EntityConnectionStringBuilder to change the provider string and finally returns the complete Entity Framework string.

    Retry policy: The main method

    Let’s continue our walk-through and build the main method of our ‘PasswordStrategy’ class:

  34. Override the method ‘ShouldRetryOn’:

  35. Create the initial checks about the exception. We need to check three possibilities:
    1. If the exception isn’t a SQLException, we return false and no retry will be attempted.
    2. If the error number isn’t about the password, either that it is expired or required to change, no retry will be tried.
    3. If the variable ‘ChangingPassword’ is true, and the changing is already happening, return false so the context will be refreshed.

  36. Change the password using the following code:

    This code is implementing the following steps:

    1. Check if the connection string name is valid
    2. Extracts the provider string from Entity Framework connection string
    3. Create the new password. It will be a GUID.
    4. Change the password in SQL Server, creating a new provider string with the new password.
    5. Save the new connection string, taking care to build a new Entity Framework connection string with the new password.
    6. Refresh the context connection string
    7. Change the field ‘ChangingPassword’ to false again
    8. Return true. The context will retry the execution, this time with the new password.

    Applying the PasswordStrategy

    Strategy classes, such as our ‘PasswordStrategy’ class, aren’t applied directly to the entity context. We need to create a new class inheriting from ‘DbConfiguration’ class inside the same project than our entity context. It’s like magic: The context will find the new ‘DbConfiguration’ class in the project and will use it.

    In our solution, we also need to add some lines to the entity context constructor. Since we are using ‘database first’, this is a bit trickier, because the entire context code is re-created every time the T4 files are processed, deleting any customization we create.

    The solution to this problem is create the customization inside the T4 files, so every time the T4 are processed the re-created code will already include our customization.

  37. Create a new class called ‘PasswordConfiguration’ inside ‘libData’ project.
    1. In the ‘Solution Explorer’ window, right-click the ‘libPassword’ project and click ‘Add’->’Class’ in the context menu
    2. Type ‘PasswordConfiguration.cs’ in the ‘Name’ textbox and click the ‘Ok’ button
  38. Add the following lines to the top of ‘PasswordConfiguration.cs’ file, just below the ‘Using’s:

  39. Implement the ‘PasswordConfiguration’ class using the following code:

  40. Inside ‘North.context.tt’ file, add the following ‘Using’:

  41. Inside ‘North.context.tt’ file, add the following lines inside the context constructor:

    You can recognize the constructor by the call for the ‘Base’ class with the connection string name as a parameter.

    First test of the solution

    The first test is very simple: Just execute the web application. You will see the list of customers as a result, meaning everything worked fine, the application was able to change the password.

    You can check the web.config file and you will notice that the password has changed in the connection string, proving that everything went fine.

    If anything went wrong, if you need to review the previous steps, you will probably need to correct the SQL Server login and ensure the ‘User must change the password at next login’ attribute is set.

    Publishing to Production

    Our last step is the deployment to Production. There are several tools you can use to deploy the solution to Production. I will use web deployment in Visual Studio to illustrate how we can change the web.config file and encrypt the connection string during the deployment.

    It’s important to keep in mind that this is only an example illustrating the potential of a process that hides the password from everyone. There are a many deployment solutions, and I’m sure that I will not need to detail too much of the other possibilities in this article.

    There are some caveats in the publishing to Production:

    • Our application needs the right to change the file with the new password. We will need to set ACL rights in the destination folders
    • It’s not safe to open write permissions in the root of our web application. The best solution will be to split our web config, storing our connection strings in a different folder and set the ACL only for this different folder
    • Web Config Transformations, which are needed to change the connection string between environments, do not work with split web.config files. It’s certainly possible to make it work, but it’s too awkward, so the best solution will be a work-around.

    These are the deployment steps:

    • Split the web.config, creating a different file for the connection string
    • Configure Web.Config Transformations
    • Create a publishing profile and configure encryption
    • Configure the ACL in the publishing profile
    • Publish the application

    Web.Config Encryption and NLBS

    Network Load Balancing Service, or NLBS, is a windows service used to create a pool of web servers with the same content, balancing the web request.

    It’s important to notice the solution I’m presenting here will require further configuration if your application is running in an NLBS environment, because all web.config files will need to use the same encryption key. You can read more about this here, but this is beyond the planned scope for this article.

    In fact, even besides the encryption, this solution will only work in a NLBS environment if you have some way to synchronize the web.config files across multiple servers. This is beyond this article.

    Splitting the Web.Config

    It’s very simple: we create a new file in a different folder, move the connection strings to the new file and connect both. Let’s do it:

  42. Create a new folder called ‘Config’
    1. In the ‘Solution Explorer’ window, right-click ‘webCustomer’ project and click ‘Add’ -> ‘New Folder’ context menu item
    2. Type ‘Config’ as the name of the new folder
  43. Create a new file called ‘conn.config’ inside the ‘Config’ folder
    1. Right-Click the ‘Config’ folder, click ‘Add’ -> ‘New Item’
    2. In the ‘Add new item’ window, select ‘Visual C#’ -> ‘Web’ in the left side
    3. In the ‘Add new item’ window, select ‘Web Configuration File’ in the right side of the window
    4. Type ‘conn.config’ in the ‘Name’ textbox and click ‘Add’ button
  44. Copy the ‘connectionString’ element from the ‘web.config’ to the ‘conn.config’
  45. Change the ‘connectionString’ element in the ‘web.config’ file to be as the following:

Configure Web.Config Transformations

‘Web.Config transformations’ is a feature that allows us to replace pieces of the web.config file, such as connection string, during the build and deployment process.

Besides the web.config file in your project, you also have an additional web.config file for each solution configuration and you can see these files in Solution Explorer window, by expanding web.config file. The file names are web.debug.config and web.realease.config.

Usually we could do some changes to Web.Release.Config file to transform our connection string from Development to Production. However, web.config transformations don’t work by default with split web.config files. We could configure a custom build task to transform the ‘conn.config’ file, but it will be much easier to just configure a transformation for the ‘configSource’ attribute, making the main web.config point to a different file in Production.

These are the steps we need to do:

  1. In the ‘Solution Explorer’ window, below the ‘Config’ folder, right-click the ‘conn.config’ file and click ‘Copy’ in the context menu
  2. Right-Click the ‘Config’ folder and click ‘Paste’ in the context menu
  3. Rename the new file ‘conn – Copy.config’ to ‘conn.Release.config’
  4. Copy the entire ‘connectionString’ element from the ‘conn.config’ file to the ‘conn.Release.config’

  5. Double-click the ‘conn.Release.config’ file to open it
  6. Change the ‘User Id’ in the connection string from ‘usrQuality’ to ‘usrProduction’
  7. Open the Web.Release.Config file in the root of the project
  8. Add the following tag just above the system.web element:

Pay heed to the attributes xdt:Transform. It’s responsible for the transformation, indicating how the tag will be transformed. In our example, the tags will be transformed by setting attributes, ‘configSource’ attribute in our example.

Create a publishing profile and configure encryption

The publishing profile is created when we publish our web application. However, we need to do a small change to the publishing profile and we can’t do this change through the publish wizard.

We will solve this ‘chicken and egg’ puzzle by executing the publishing wizard, cancelling the wizard before finishing, changing the publishing profile and executing the publishing wizard again, this time deploying the application.

Let’s do a walk-through to complete these steps:

  1. In Solution Explorer window, right-click ‘webCustomer’ project and click ‘Publish…’ context menu item

  2. In ‘Publish Web’ window, click ‘Custom’ button
  3. In ‘New Custom Profile’ window, in ‘Profile Name’ textbox, type ‘Production’ and click ‘Ok’ button

  4. Click ‘Next’ button to move to ‘Connection’ page in the wizard
  5. In the ‘Connection’ page, select ‘Web Deploy’ in the ‘Publishing Method’ drop down
  6. In the ‘Connection’ page, type ‘Localhost’ in the ‘Server’ textbox
  7. In the ‘Connection’ page, type ‘Default Web Site/webCustomers’ in the ‘Site Name’ textbox
  8. In the ‘Connection’ page, type ‘http://localhost/webCustomers’ in the ‘Destination Url’ page

  9. Click ‘Next’ button
  10. In the ‘Settings’ page, click ‘Next’ button.
  11. In the ‘Preview’ page, click ‘Close’ button
  12. In ‘Solution Explorer’ window, below ‘webCustomers’ project, expand ‘Properties’

  13. Double-click ‘Production.pubxml’ file to open it
  14. Insert the following tag below ‘</PropertyGroup>’ tag:

Pay heed to the following details:

  • The AfterTargets attribute determine when the task will be executed
  • The Exec element is responsible for the execution
  • Although there are other configurations to encrypt the ‘connectionString’ element, this is the only one that will work with a split web.config file

Configure the ACL in the publishing profile

We need to add permissions to the web site to change the file inside the ‘Config’ folder. We can just include the following configuration to the ‘Production.pubxml’ file, just below the previous ‘Target’ element we included:

The web deployment process creates a manifest for the application and executes the manifest during the deployment. We can only see the manifest when we publish the application to a deployment package instead directly to the server.

The first ‘Target’ element is defining a ‘setAcl’ action inside the manifest. The second ‘Target’ element is parameterizing the action, so the deployment process will be able to deal with the path when the application is deployed to different servers.

Publish the application

After configuring everything, publish the application is very easy:

  1. In ‘Solution Explorer’ window, right-click the ‘webCustomer’ project and click ‘Publish…’ context menu item
  2. In the ‘Publish Web’ window, click ‘Publish’ button

Once again, if everything is done correctly, you will see the web browser with the list of customers.

You can open the ‘conn.release.config’ file in the ‘C:\inetpub\wwwroot\webCustomers\Config’ folder and you will see something similar to the image below.

Conclusion

The solution proposed in this article is able to greatly increase the security of your application environment by ensuring that access control conforms to a stringent policy. The higher security is not only because nobody knows the password but also because the administrator can enforce standard password policies to all application accounts instead of having to compromise by treating them as exceptions, using the attribute ‘Password Never Expires’.

SQL Server will follow the password expiration policy and the application will change its password from time to time, ensuring a good password security.

Another increase in security is the fact that this solution only works if every application has its own login. If two applications share the same login, the solution will not work.

You can download the solution and contribute to it here: https://github.com/DennesTorres/ChangePassword