Click here to Skip to main content
15,867,785 members
Articles / Web Development / ASP.NET
Article

Simple HTTP Reverse Proxy with ASP.NET and IIS

Rate me:
Please Sign up or sign in to vote.
4.27/5 (25 votes)
22 May 20042 min read 596.6K   10.8K   91   82
Learn how easy it is to create HTTP Reverse Proxy in .NET using IIS.

Introduction

Sample Image - reverse-proxy.png

A reverse proxy is the same as a proxy except instead of delivering pages for internal users, it delivers them for external users. It can be used to take some load off web servers and provide an additional layer of protection. If you have a content server that has sensitive information that must remain secure, you can set up a proxy outside the firewall as a stand-in for your content server. When outside clients try to access the content server, they are sent to the proxy server instead. The real content resides on your content server, safely inside the firewall. The proxy server resides outside the firewall, and appears to the client to be the content server.

Where to use?

If you have an intranet with IP filtered security, you can offer the functionality of external consultation. You must just add the authentication system of your choice.

Functionality

This reverse proxy can run in two modes:

  • Mode 0: all web sites can be requested by clients with an URL like http://RevrseProxyURL/http//www.site.com/
  • Mode 1: only one web site can be requested. When the user requests the web application address, the proxy returns the content of this web site.

You can setup this mode in the web configuration file of you web application:

XML
<appSettings>
    <!-- PROXY Mode
  0 : all web site can be requested by a client with 
      an url like <A href="http://reverseproxyurl/http//www.site.com/">http://ReverseProxyURL/http//www.site.com/</A>
  1 : Only on web site can be resuested by clients, \
      In this case Web Application uses RemoteWebSite variable 
      to deliver the content of the web site.
    -->
   <add key="ProxyMode" value="1" />
   <add key="RemoteWebSite" value="<A href="http://www.codeproject.com/">http://www.codeproject.com/</A>" />
</appSettings>

The code

Create an HttpHandler to intercept all requests:

C#
using System;
using System.Configuration;
using System.Web;
using System.Net;
using System.Text;
using System.IO; 
namespace ReverseProxy
{
  /// <summary>
  /// Handler that intercept Client's request and deliver the web site
  /// </summary>

  public class ReverseProxy: IHttpHandler
  {
    /// <summary>
    /// Method calls when client request the server
    /// </summary>
    /// &;lt;param name="context">HTTP context for client</param>

    public void ProcessRequest(HttpContext context)
    {
      //read values from configuration 
      fileint proxyMode = 
        Convert.ToInt32(ConfigurationSettings.AppSettings["ProxyMode"]);
      string remoteWebSite = 
        ConfigurationSettings.AppSettings["RemoteWebSite"];
      string remoteUrl;
      if (proxyMode==0)
        remoteUrl= ParseURL(context.Request.Url.AbsoluteUri);
      //all site 
      acceptedelseremoteUrl= 
        context.Request.Url.AbsoluteUri.Replace("http://"+
        context.Request.Url.Host+
        context.Request.ApplicationPath,remoteWebSite);
      //only one site accepted
      //create the web request to get the remote stream
      HttpWebRequest request = 
        (HttpWebRequest)WebRequest.Create(remoteUrl);
      //TODO : you can add your own credentials system
      //request.Credentials = CredentialCache.DefaultCredentials;
      HttpWebResponse response;
      try
      {
        response = (HttpWebResponse)request.GetResponse ();
      }
      catch(System.Net.WebException we)
      {
        //remote url not found, send 404 to client 
        context.Response.StatusCode = 404;
        context.Response.StatusDescription = "Not Found";
        context.Response.Write("<h2>Page not found</h2>");
        context.Response.End();
        return;
      }
      Stream receiveStream = response.GetResponseStream();

      if ((response.ContentType.ToLower().IndexOf("html")>=0) 
        ||(response.ContentType.ToLower().IndexOf("javascript")>=0))
      {
        //this response is HTML Content, so we must parse it
        StreamReader readStream = 
          new StreamReader (receiveStream, Encoding.Default);
        Uri test = new Uri(remoteUrl);
        string content;
        if (proxyMode==0)
          content= ParseHtmlResponse(readStream.ReadToEnd(), 
            context.Request.ApplicationPath+"/http//"+test.Host);
        else
          content= ParseHtmlResponse(readStream.ReadToEnd(),
            context.Request.ApplicationPath);
        //write the updated HTML to the client
        context.Response.Write(content);
        //close streamsreadStream.Close();
        response.Close();
        context.Response.End();
      }
      else
      {
        //the response is not HTML 
        Contentbyte[] buff = new byte[1024];
        int bytes = 0;
        while( ( bytes = receiveStream.Read( buff, 0, 1024 ) ) > 0 )
        {
          //Write the stream directly to the client 
          context.Response.OutputStream.Write (buff, 0, bytes );
        }
        //close streams
        response.Close();
        context.Response.End();
      }
    }

    /// <summary>
    /// Get the remote URL to call
    /// </summary>
    /// <param name="url">URL get by client</param>
    /// <returns>Remote URL to return to the client</returns>

    public string ParseURL(string url)
    {
      if (url.IndexOf("http/")>=0)
      {
        string externalUrl=url.Substring(url.IndexOf("http/"));
        return externalUrl.Replace("http/","http://") ;
      }
      else
        return url;
    }

    /// <summary>
    /// Parse HTML response for update links and images sources
    /// </summary>
    /// <param name="html">HTML response</param>
    /// <param name="appPath">Path of application for replacement</param>
    /// <returns>HTML updated</returns>
    public string ParseHtmlResponse(string html,string appPath)
    {
      html=html.Replace("\"/","\""+appPath+"/");
      html=html.Replace("'/","'"+appPath+"/");
      html=html.Replace("=/","="+appPath+"/");
      return html;
    }
    ///
    /// Specifies whether this instance is reusable by other Http requests
    ///
    public bool IsReusable
    {
      get
      {
        return true;
      }
    }
  }
}

Configure the handler in web.config

You must add these lines in web.config file to redirect all user queries to the HTTPHandler:

XML
<httpHandlers>
   <add verb="*" path="*" type="ReverseProxy.ReverseProxy, ReverseProxy" />
</httpHandlers>

Configure IIS

If you want to process a request with any file extension, then you need to change IIS to pass all requests through to the ASP.NET ISAPI extension. Add the HEAD, GET and POST verbs to all files with .* file extension and map those to the ASP.NET ISAPI extension - aspnet_isapi.dll (in your .NET framework directory). The complete range of mappings, includes the new .* mapping.

TODO's

Now, you can develop your own security system, based on form, Windows or passport authentication.

License

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


Written By
Web Developer
France France
Vincent Brossier is a software engineer from Paris, FRANCE, specializing in .Net.
Vincent is in charge of development of the Parisian university's Intranet, I take part in a nationnal project of numerical campus.
His role is to seek best technicals solutions to satisfy the 35000 users of this Intranet. Specialized in the development of distributed applications, vincent work primarily with technologies microsoft .NET (C#, ASP.NET, Webservices, SQLServer) even if he have also work with java technologies (Peer-to-peer sharing documents tool).
Vincent have also set up Open-Source solutions such as SPIP in nursery schools.
When he's not programming, he enjoys playing Guitar.

Comments and Discussions

 
GeneralRe: Adding Session Handling Pin
David Osbourn10-Mar-05 22:53
David Osbourn10-Mar-05 22:53 
GeneralRe: Adding Session Handling Pin
Yu B.R6-May-05 19:49
Yu B.R6-May-05 19:49 
GeneralReturning PDF Pin
Chris A.7-Mar-05 11:30
Chris A.7-Mar-05 11:30 
GeneralRe: Returning PDF Pin
Vincent Brossier7-Mar-05 19:45
Vincent Brossier7-Mar-05 19:45 
Generalplease help the newbie Pin
Marc-O19-Jan-05 5:24
Marc-O19-Jan-05 5:24 
GeneralRe: please help the newbie Pin
Member 188706416-Apr-05 17:18
Member 188706416-Apr-05 17:18 
GeneralRequesting a file in a different folder Pin
Member 161500219-Jan-05 2:27
Member 161500219-Jan-05 2:27 
GeneralCould not load type 'ReverseProxy.Global'. Pin
webwidejosh14-Dec-04 6:04
webwidejosh14-Dec-04 6:04 
Generalvery simple... Pin
gomolyako24-Oct-04 9:58
sussgomolyako24-Oct-04 9:58 
GeneralVisual Studio problem Pin
oferws15-Jun-04 21:32
sussoferws15-Jun-04 21:32 
GeneralRe: Visual Studio problem Pin
Anonymous20-Jun-04 7:06
Anonymous20-Jun-04 7:06 
GeneralHTTP post method Pin
vericon6-Jun-04 0:20
vericon6-Jun-04 0:20 
GeneralRe: HTTP post method Pin
gomolyako24-Oct-04 9:53
sussgomolyako24-Oct-04 9:53 
GeneralRe: HTTP post method Pin
pacman189115-Dec-04 22:10
pacman189115-Dec-04 22:10 
GeneralRe: HTTP post method Pin
Francis Li16-Jan-05 7:27
Francis Li16-Jan-05 7:27 
GeneralRe: HTTP post method Pin
pacman189116-Jan-05 13:14
pacman189116-Jan-05 13:14 
Generalcookie management Pin
yahali5-Jun-04 20:36
sussyahali5-Jun-04 20:36 
GeneralRe: cookie management Pin
david.price.dev22-Jun-04 8:57
david.price.dev22-Jun-04 8:57 
GeneralRe: cookie management Pin
Francis Li16-Jan-05 7:32
Francis Li16-Jan-05 7:32 
GeneralRe: cookie management Pin
pacman189116-Jan-05 13:23
pacman189116-Jan-05 13:23 
GeneralRe: cookie management !! Pin
CodeNappy12-Jun-05 3:58
CodeNappy12-Jun-05 3:58 
GeneralRe: cookie management !! Pin
maria_mir15-Jul-09 20:07
maria_mir15-Jul-09 20:07 
GeneralMapping other file extensions Pin
chrisimgx26-May-04 11:30
chrisimgx26-May-04 11:30 
GeneralRe: Mapping other file extensions Pin
Vincent Brossier27-May-04 8:32
Vincent Brossier27-May-04 8:32 
GeneralURL rewriting Pin
Youcef Laribi25-May-04 9:19
Youcef Laribi25-May-04 9:19 

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.