Microsoft KB Archive/316871

Knowledge Base

HOW TO: Control Authorization Permissions in an ASP.NET Application

Article ID: 316871

Article Last Modified on 5/19/2003

---

APPLIES TO

• Microsoft ASP.NET 1.0
• Microsoft ASP.NET 1.1

---

This article was previously published under Q316871

IN THIS TASK

SUMMARY

• Configure Access to a Specific File and Folder

REFERENCES

SUMMARY

Use this step-by-step guide to apply the <location> tag to the Web.config file to configure access to a specific file and folder.

When using forms-based authentication in ASP.NET applications, only authenticated users are granted access to pages in the application. Unauthenticated users are automatically redirected to the page specified by the loginUrl attribute of the Web.config file where they can submit their credentials. In some cases, you may want to permit users to access certain pages in an application without requiring authentication.

back to the top

Configure Access to a Specific File and Folder

1. Set up forms-based authentication.For additional information, click the article numbers below to view the articles in the Microsoft Knowledge Base:

   308157 HOW TO: Implement Forms-Based Authentication in Your ASP.NET Application by Using Visual Basic .NET

   301240 HOW TO: Implement Forms-Based Authentication in Your ASP.NET Application by Using C# .NET

2. Request any page in your application to be redirected to Logon.aspx automatically.

3. In the Web.config file, type or paste the following code.
   
   This code grants all users access to the Default1.aspx page and the Subdir1 folder.

   <configuration>
       <system.web>
           <authentication mode="Forms" >
               <forms loginUrl="login.aspx" name=".ASPNETAUTH" protection="None" path="/" timeout="20" >
               </forms>
           </authentication>
   <!-- This section denies access to all files in this application except for those that you have not explicitly specified by using another setting. -->
           <authorization>
               <deny users="?" /> 
           </authorization>
       </system.web>
   <!-- This section gives the unauthenticated user access to the Default1.aspx page only. It is located in the same folder as this configuration file. -->
           <location path="default1.aspx">
           <system.web>
           <authorization>
               <allow users ="*" />
           </authorization>
           </system.web>
           </location>
   <!-- This section gives the unauthenticated user access to all of the files that are stored in the Subdir1 folder.  -->
           <location path="subdir1">
           <system.web>
           <authorization>
               <allow users ="*" />
           </authorization>
           </system.web>
           </location>
   </configuration>
                           

   Users can open the Default1.aspx file or any other file saved in the Subdir1 folder in your application. They will not be redirected automatically to the Logon.aspx file for authentication.

4. Repeat Step 3 to identify any other pages or folders for which you want to permit access by unauthenticated users.

back to the top

REFERENCES

For additional information, click the article number below to view the article in the Microsoft Knowledge Base:

306590 INFO: ASP.NET Security Overview

For more information about the <location> tag, see the .NET Developer's Framework Guide on the following Microsoft Web site:

Configuration <location> Settings

back to the top

Additional query words: forms authentication location

Keywords: kbhowtomaster kbweb kbsecurity kbconfig KB316871

---

Send feedback to Microsoft

© Microsoft Corporation. All rights reserved.