×
darylgio agoncillo

IIS Rewrite Maps and Redirecting On Url Paths

Written by Khalid Abuhakmeh |Kevin Hougasian |Bill Boga
2
This post is days old.

URLs are the bridges that connect our little island of a website to the bigger continent known as the Internet. Preserving URL integrity is the utmost importance for providing an excellent experience for new and existing users alike. Sadly, from a development and management standpoint, keeping old paths working for a new site can be a real pain in the butt. In this post, we’ll show you how to use redirect maps to create a lookup dictionary for old URL paths. This post will also help you preserve query string parameters.

Configuration

We started by exploring the Microsoft documentation site around rewrite maps. For rewrite maps, you will need to make sure you are running your site on Internet Information Services with the rewrite module.

What you will need in your web.config is a rewriteMaps section under system.webserver/rewrite with the rewrite maps section containing the old URL paths and their new destinations.

<rewrite>
    <rewriteMaps>
        <rewriteMap name="StaticRewrites" defaultValue="">
            <add key="/one" value="/new-one" />
            <add key="/two" value="/new-two" />
        </rewriteMap>
    </rewriteMaps>
</rewrite>

This rewrite map then needs a subsequent rule to match the URL path.

<rule name="Redirect rule for StaticRewrites" stopProcessing="true">
    <match url=".*" />
    <conditions>
        <add input="{StaticRewrites:{URL}}" pattern="(.+)" />
    </conditions>
    <action type="Redirect" url="{C:1}" redirectType="Permanent"/>
</rule>

Note that the use of {URL} in our rule. The rule makes sure we look into the rewrite map using only the URL’s path. If you were to use anything else, you likely will not get a match. If you need to match on anything else, please look into the IIS documentation to understand your options.

Try it out and hopefully we’ve saved you some keystrokes :)

Khalid Abuhakmeh
Khalid Abuhakmeh
Director of Software Development (Former)
Kevin Hougasian
Kevin Hougasian
Lead Frontend Developer
Bill Boga
Bill Boga
Senior Software Developer
IIS
Azure
SEO
Suggested reading

UX/UI Solutions: Make Content Less Overwhelming.

SEO
How do you not overwhelm the user with a wall of content? When thinking abou...
Read now

Working At Work: This And Other Thoughts On High Availability

Azure
Over the previous year we’ve been working to improve our overall uptime. Whil...
Read now

Our DevOps Journey: Release Branches, Highly Available Azure Web Apps, and Terraform

Azure
Our starting point This past year we’ve been on a DevOps journey. While we h...
Read now

Hugo Error Pages With IIS In Windows Azure

Azure
Static site hosting is straightforward, and from our experience, less likely ...
Read now

Setting Azure Web App Slot Auto Swap Using ARM Templates and Terraform

Azure
We’re in the process of scaffolding out our Microsoft Azure environments usin...
Read now

Export CSV Table of All Azure Web Apps Configuration in Subscription

Azure
At Ritter Insurance Marketing we utilize Azure Web Apps for hosting many of o...
Read now

Comments

Stay fresh! The brighter green, the fresher the article!