Two Quick Ways to Perform ASP.NET Authentication

CodeGuru content and product recommendations are editorially independent. We may make money when you click on links to our partners. Learn More.

Authentication is the process of validating a user based on a set of credentials such as username, password, and e-mail address. Suppose you own a small Web development company that uses ASP.NET, and you want to give your users a secured area from where they can download or view additional resources such as tutorials. You would have to store crucial user data such as usernames and passwords (preferably in a database such as Microsoft Access or SQL Server) and then authenticate users based on those credentials with a help of the relevant ASP.NET code. This process involves a huge amount of work for developers, including such tasks as creating tables, stored procedures, and so on.

ASP.NET offers simpler ways to validate users—with little work required. By applying ASP.NET programming logic, you can store user data in XML files and then validate users by using those files. If you have a limited number of users, you can store the credentials in a Web configuration file (Web.Config) instead. This article shows you how to apply ASP.NET user authentication using either a Web.Config file or an XML file. If you haven’t already, you’ll need to install Microsoft’s ASP.NET Web Matrix, a free editor available for download from http://www.asp.net.

Authenticating Users Using a Web.Config File

Web.Config is the main configuration file that ASP.NET applications use for storing global parameters such as connection strings for databases, passwords, and so forth. You should save this file inside the root directory of your ASP.NET application. To perform authentication using the Web.Config file, you need to create a file as shown in Listing 1.1:

Listing 1.1 Web.Config

<configuration>
<system.web>
<authentication mode = "Forms">
<forms>
    <credentials passwordFormat = "Clear">
    <user name ="abc" password = "123"/>
    </credentials>
</forms>
</authentication>
    <authorization>
    <deny users = "?"/>
    </authorization>
</system.web>
</configuration>

The usernames and passwords should be supplied inside the credentials tag, and the authentication mode should be set to Forms. The contents of Listing 1.1 are case sensitive and should be entered as shown. Further, the authorization section denies access to all anonymous users. Hence, only users whose credentials match those given in the Web.Config file can access the relevant Web page. The following table shows different kinds of tags and symbols you can use inside the authorization tag and their meanings.

The next step is to create an ASP.NET page that contains the real code for verifying a user. Listing 1.2 is a sample code snippet:

Listing 1.2 Login.aspx

if IsValid then
  if FormsAuthentication.Authenticate(txtUsername.Text,
                                      txtPassword.Text) Then
  lblStatus.Text = "Username and Passwords are correct"
else
  lblStatus.Text = "Invalid Username and Passwords"
  end if
end if

This code uses the Authenticate method of the FormsAuthentication class to validate a user. The Authenticate method takes the corresponding text fields as parameters. If the entered data is incorrect, it executes the statement inside the else part. You also can redirect a user to another Web site if the entered data is correct by slightly modifying Listing 1.2 to the code shown in Listing 1.3:

Listing 1.3

if IsValid then
  if FormsAuthentication.Authenticate(txtUsername.Text,
                                      txtPassword.Text) Then
  Response.Redirect("http://www.developer.com")
else
  lblStatus.Text = "Invalid Username and Passwords"
  end if
end if

Authenticating Users Using an XML File

Even though you can easily authenticate users by using a Web.Config file, it is not advisable for sites with a large number of users. It is also very difficult to implement an automated system that directly adds users to the Web.Config file. A Web developer should manually add new usernames and passwords to the file for each new user. To avoid this hassle, ASP.NET provides a facility for authenticating users by using an XML file. For this purpose, you have to create both a Web.Config file (Listing 1.4) and an XML file (Listing 1.5):

Listing 1.4 Web.Config

<configuration>
<system.web>
<authentication mode = "Forms">
<authorization>
<deny users = "?"/>
</authorization>
</system.web>
</configuration>

Listing 1.5 pwd.xml

<passwordlist>
<user>
   <name>bob</name>
   <pwd>123</pwd>
</user>

<user>
   <name>mark</name>
   <pwd>456</pwd>
</user>

<user>
   <name>peter</name>
   <pwd>789</pwd>
</user>

</passwordlist>

The next step is to create an ASP.NET page. Because it has to check two credentials (username and password), you have to add two TextBox controls and a Button control to the form. Double-click the button control and add the code given in Listing 1.6:

Listing 1.6

If IsValid then
   If XMLAuthentication(txtUsername.Text,txtPassword.Text) Then
   Response.Redirect("http://www.developer.com")
   End If
End If

Listing 1.6 passes the two control IDs as parameters to the XMLAuthentication method. This method will contain the real code to authenticate users from your XML file. Further, if the username and password match with that of the XML file, the user will be redirected to the developer.com home page. The source code for this method is given in Listing 1.7:

Listing 1.7

   Dim dstPwd as DataSet
   Dim dtblPwd as DataTable

   Dim users() as DataRow
   dstPwd = New DataSet()
   dstPwd.ReadXML(MapPath("Pwd.xml"))

   dtblPwd = dstPwd.Tables(0)
   users = dtblPwd.Select("name = '"& strUsername & "' ")

   if users.Length > 0 Then
   if users(0)("pwd") = strPwd Then
   Return True
   Else
   lblStatus.Text = "Invalid Password"
   End If
   Else
   lblStatus.Text = "Username does not exist"
   End If
   Return False
   End Function

In Listing 1.7, the XML file is loaded by using the built-in ReadXML() method, and the XMLAuthentication method checks both the username and password. The method displays the relevant messages in the label control.