Importing Apache mod_rewrite Rules

Introduction:


The Internet Information Services 7 (IIS 7) URL Rewrite Module provides an import feature that greatly simplifies the process of converting Apache mod_rewrite rules to IIS URL rewrite rules. In this walkthrough, you use the Import Rules feature provided in the URL Rewrite Module to import several mod_rewrite rules into an IIS configuration file. If you have not yet downloaded the URL Rewrite Module, you can do so at http://www.iis.net/download/urlrewrite.


Set Up A Walk-hrough Scenario:


To see how you can convert mod_rewrite rules and verify that the converted rules work correctly, you will implement the common scenario of enforcing canonical host names for a Web site. In this example, you will force the use of www.mysite.com instead of mysite.com, so that when a request is made that uses a host name other than www.mysite.com, you can redirect the request to a canonical host name.

1. Start IIS Manager, and then click Default Web Site.

2. In the Actions pane, click on Bindings, and add a new http binding for port 8088.

Figure 1: Add a new binding

3. Using Notepad, open %SystemDrive%\windows\system32\drivers\etc\hosts and add the two following lines at the end of the file:

127.0.0.1 www_mysite_com

127.0.0.1 mysite_com

Notice that you are using “_” instead of “.” for domain separators. This is to prevent the Web browser from trying to resolve the domain name by using a Domain Name System (DNS) server. 

4. Save the hosts file.

5. Verify that the host names were setup correctly by opening a Web browser and going to the sites http://www_mysite_com/iisstart.htm and to http://mysite_com/iisstart.htm.

Convert mod_rewrite Rules:

The Apache mod_rewrite rules to use for enforcing canonical host names are:

#For sites running on a port other than 80:

RewriteCond %{HTTP_HOST}   !^www_mysite_com [NC]

RewriteCond %{HTTP_HOST}   !^$

RewriteCond %{SERVER_PORT} !^80$

RewriteRule ^/(.*)         http://www_mysite_com:%{SERVER_PORT}/$1 [L,R]

#And for a site running on port 80

RewriteCond %{HTTP_HOST}   !^www_mysite_com [NC]

RewriteCond %{HTTP_HOST}   !^$

RewriteRule ^/(.*)         http://www_mysite_com/$1 [L,R]

To convert these rules to IIS URL rewrite–specific format:

1. Start IIS Manager.

2. On the left, in the Connections pane, select Default Web Site.

3. On the right, in Features View, click URL Rewrite.

Figure 2: Click URL Rewrite

4. On the right, in the Actions pane, click Import Rules. 

5. Copy the example mod_rewrite rules above and past them into the Rewrite rules text box.

Figure 3: Rules to import

6. The Tree View tab of the Converted Rules box instantly shows the result of the conversion. You can also click the XML View tab to see how the rules are stored in the Web.config file.

Figure 4: Converted rules

If you switch back to Tree View and select a node there, the corresponding mod_rewrite rule directive in the Rewrite rules text box will be highlighted.

Figure 5: Tree view

Note that during the rules conversion the rules were assigned default names. To change the default names to something more meaningful, select a rule in Tree View, right-click it, and select Rename from the context menu.

Figure 6: Rename

Change the name of the first rule from ImportedRule1 to Redirect to www_mysite_com:non-80. Change the name of the second rule from ImportedRule2 to Redirect to www_mysite_com:80.

In the Actions pane, click Apply to save the converted rules to the Web.config file, and then click Back to rules.

Figure 7: Back to Rules

Test the Converted Rules:

To test that the rules imported from mod_rewrite format work correctly, open a Web browser, and go to either one of the following URLs:

http://localhost/iisstart.htm 

http://mysite_com/iisstart.htm

In both cases, the Web browser is redirected to 

http://www_mysite_com/iisstart.htm.

Also, if you try either of these URLs:

http://localhost:8088/iisstart.htm

http://mysite_com:8088/iisstart.htm

The Web browser gets redirected to http://www_mysite_com:8088/iisstart.htm.