Introduction
My ISP told me I couldn't have Application Extension Mapping on a shared server hosting package. I can't afford a dedicated server so I put together this sample program to install on the ISP I was considering moving to. First I emailed a lot of Windows ISPs a Pre-Sales question: I need to add PDF extension to FileMapping so it will be processed by aspnet_isapi.dll. In my ASP.NET application I redirect all requests for PDF to a login screen. What's the most economical plan you have that can do this? See description here: MSDN. A few ISPs agreed to do it so I signed up with one. If the test program runs within the 30 day trial period, I am good to go. If not I get my money back and move down the list.
Background
ASP.NET doesn't protect file extensions outside the ASP family. To do that you map an extension to the ASP executable in IIS. Use the Web.config file to tell your application the mode of authentication (Forms), what extension to watch for (.PDF), and who will handle it (MyHandler.dll). Write an HTTP handler to take the HTTP request and run it through the ASP executable (aspnet_isapi.dll). Web.config brings up Login.aspx.
More:
Install
- Extract AppMapFileTest.zip.
- Create a virtual folder in IIS that points to the physical directory (where AppFileMapTest.csproj is).
- Copy the MyHandler.dll from the obj/Debug directory of MyHandler to the bin directory of AppMapFileTest.
- Do steps 24 through 43.
- Open AppMapFileTest.csproj in Visual Studio, compile and run.
Build from Scratch
Open VS.NET: select New Project. Language: C#. Type: Web Application. Name: AppMapFileTest.
- Solution Explorer - Right click AppMapFileTest - Add Web Form - Name: index.aspx.
- Drag from toolbox one
Label. Properties - Text: Welcome.
- Solution Explorer - Right click AppMapFileTest - Add Web Form - Name: Login.aspx.
- Drag from toolbox one
Label. Properties - Text: UserID.
- Drag from toolbox another
Label. Properties - Text: Password.
- Drag from toolbox one
TextBox. Properties - Text: txtUserId.
- Drag from toolbox one
TextBox. Properties - Text: txtPassword.
- Drag from toolbox one
Button. Properties - Text: Login, Name: cmdLogin.
- Solution Explorer - right click index.aspx - Set As Start Page.
- Test by running app. You should see a browser window with 'Welcome' in it.
- Go to Windows Explorer and add a folder inside this project called scores.
- On the index page click on HTML at the bottom left of the page.
- The line after the
<body MS_POSITIONING="GridLayout"> tag makes two hyper links:
<a href="example.pdf"target=_blank>Example Page</a>
<a href="scores/buynow.pdf"target=_blank>Buy Now</a>
- Go to Windows Explorer and put example.pdf in the root directory of the application and buynow.pdf in a new folder called scores. I got most of the next project from here.
- Start a new instance of VS.NET.
- VS.NET: New Project. Language: C#. Type: Class Library. Name: MyHandler.
- Create a class that derives from
IHttpHandler. using System;
using System.Web;
namespace MyHandler
{
public class NewHandler : IHttpHandler
{
public NewHandler()
{
}
#region Implementation of IHttpHandler
public void ProcessRequest(System.Web.HttpContext context)
{
string FileName = context.Server.MapPath(context.Request.FilePath);
context.Response.WriteFile(FileName);
}
public bool IsReusable
{
get
{
return false;
}
}
#endregion
}
}
- Compile this and copy the MyHandler.dll from the bin/Debug folder into the bin folder of the AppMapFileTest application.
- Run the AppMapFileTest application. Both links should open in separate pages with no login required.
- Open web.config.
- Edit the line:
<authentication mode="Windows" /> to be: <authentication mode="Forms" >
<forms name=".reelbook" loginUrl="Login.aspx"/>
</authentication>
- After the
<system.web> and right before the </system.web> tag, add: <httpHandlers>
<add verb="GET" path="scores/*.pdf" type="MyHandler.NewHandler,MyHandler"/>
</httpHandlers>
- After the
</system.web> tag but before the </configuration> tag, add: <location path="scores">
<system.web>
<authorization>
<deny users="?" />
</authorization>
</system.web>
</location>
- Test the app. It still requires no login.
- Open Control Panel/Administrative Tools/Internet Information Services.
- Expand (local computer).
- Expand Web Sites.
- Expand Default Web Site.
- Right click AppFileMapTest.
- Choose Properties.
- In the Directory tab, click the Configuration button.
- In the Application Configuration dialog box, click the Add button.
- In the Add/Edit Application Extension Mapping dialog box, click Browse.
- In the Open dialog box, choose files of type .dll and navigate to the C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322 folder.
- Double click on aspnet_isapi.dll.
- In the Add/Edit Application Extension Mapping dialog box, type .pdf in the Extension textbox (don't forget the dot).
- Under Verbs, I only need GET, so click the radio button 'Limit to' and enter GET in the textbox.
- Uncheck 'Check that file exists' checkbox.
- Click OK.
Hey! the OK button is all grayed out! After a long Google afternoon, I found this.
- Click on the textbox itself and the path will fully expand, enabling the "OK" button so you can save the mapping.
- Click Apply.
- Click OK.
- Click Apply.
- Click OK.
- Test the app.
- Click on the Example Page link - it works as before.
- Click on the Buy Now link - it goes to the Login.aspx page.
- Click the Login button - Nothing.
- In Visual Studio, go to Login.aspx Design View and double click on the Login button.
- Inside the
cmdLogin_Click method, add one line of code: FormsAuthentication.RedirectFromLoginPage(txtUserId.Text, false);
Run it. It doesn't like FormsAuthentication.
- Add a
using statement: using System.Web.Security;.
Now it works. You have to login to get the Buy Now page.
Conclusion
A session cookie called reelbook named inside the <authentication mode="Forms" > tag of our Web.config is used so you don't have to login again until your next session. Only the folder set with the Add/Edit Application Extension Mapping dialog box will filter out PDF files to be processed by aspnet_isapi.dll. To prove this, right click on the default web site in the Internet Services Manager. Do steps 29) and 30). There's no PDF in the list which means that only the files in the folder you specified get sent to aspnet_isapi.dll. I don't think this will cause a performance problem in a shared hosting environment unless of course you get millions of hits for your valuable digital property. And if that's the case then you can afford to get a dedicated server in the first place. Anyway, my new ISP implemented this server-side tweak in less than an hour. I'm sure giving them this step by step page helped. You can never make too many friends in your ISP's Tech Support Group.
