Post

Wildcard Host Name Support in Old IIS Releases

A post about how to support wildcard host names in old IIS releases with ARR.

IIS 10 allows users to easily use wildcard host names. Well, “why is it so late”? You might ask. I did not work on IIS, so I can only guess that the developers believe you can already support such on previous IIS releases. But how? Recently I have been using ARR a lot, so below I provide an approach to support wildcard host names via ARR.

What Is Wildcard Host Name?

Assume that you have two domains, site1.com and site2.com. For each of them, you would like to host a few subdomains,

  • test.site1.com
  • test1.site1.com
  • XXX.site1.com
  • test2.site2.com
  • test3.site2.com
  • YYY.site2.com

and more importantly, all subdomains of site1.com should be served by the same web application, so should all subdomains of site2.com.

OK, if with IIS 10, we just need two web sites. One of them binds to *.site1.com and the other *.site2.com.

What To Do on Old IIS Releases?

Firstly, of course you need to install ARR and URL Rewrite module. Later we use them to configure a reverse proxy.

Secondly, create a catch-all site (like the Default Web Site), who binds to *:80 with no host name. Later, this site takes all incoming HTTP requests, and applies our reverse proxy rules.

Here I use HTTP sites as examples for simplicity.

Thirdly, create the actual content sites. One for site1.com binds to *:8091 with no host name, while the other for site2.com to *:8092 with no host name. Both sites can be tested now via the bindings given.

Fourthly, on the catch-all site, create the following rules,

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<system.webServer>
    <rewrite>
        <rules>
            <rule name="site1" stopProcessing="true">
                <match url=".*" />
                <conditions>
                    <add input="{HTTP_HOST}" pattern="^(.*).site1.com$" />
                </conditions>
                <action type="Rewrite" url="http://localhost:8091/{R:0}" />
            </rule>
            <rule name="site2" stopProcessing="true">
                <match url=".*" />
                <conditions>
                    <add input="{HTTP_HOST}" pattern="^(.*).site2.com$" />
                </conditions>
                <action type="Rewrite" url="http://localhost:8092/{R:0}" />
            </rule>
        </rules>
    </rewrite>
</system.webServer>

If you are familiar with IIS, these rules are pretty simple.

Lastly, set up ARR proxy mode at server level,

1
2
3
<system.webServer>
    <proxy enabled="true" />
</system.webServer>

Side Notes

The reverse proxy approach is slightly complex if we compare to wildcard host name support in IIS 10. Indeed, it takes more steps to set up, and it requires a few sites with no host name in their bindings, which might not look pleasant. Also when we compare the performance metrics, reverse proxy has more overhead (but negligible in most cases).

So, upgrade to IIS 10 if you can. Use the above steps only when you have to stick to an old release.

© Lex Li. All rights reserved. The code included is licensed under CC BY 4.0 unless otherwise noted.
Advertisement

© - Lex Li. All rights reserved.

Using the Chirpy theme for Jekyll.

Last updated on October 03, 2024